是一个排版软件,而则提供了一个极为丰富的宏集,让人们不需要费心构建费心钻研排版效果,而专注于文本的编写。对于像IEEE这样会提供论文的模板的出版社,撰写论文变得更加简单。TeXLive则是软件的其中一个广为人知的发行版。
而多个作者同时编辑一篇论文时,协同工作尤为必要。相对于微软对Word提供了协同工作的技术,其实的协同工作更为简单,因为文档由代码编译而成,所有的源文件都是文本文件,那么一个Git仓库就可以解决问题。
VSCode在这篇文章中出现是因为,个人没有发现的GUI编辑器们有谁长得好看。以及,配合插件使用,使用VSCode编写文档是一件很舒服的事情。
本篇文章只带领简单入门,保证可用,但更深入的内容本篇不予赘述。
TeXLive的下载安装
镜像下载
TeXLive官网默认的安装方式是使用在线安装包,这对于国内实在太慢了,所以建议下载光盘镜像文件离线安装。
安装
挂载iso镜像为虚拟光驱(Win10双击iso文件即可,Win7之前的版本需要借助软件),然后使用管理员权限运行根目录下的批处理文件install-tl-advanced.bat
,在弹出窗口中点击Continue
,配置好安装路径后点击安装TeXLive
,接下来进入漫长的等待。取决于机器配置,每个人耗费的时间可能有所不同,我本人安装了半个多小时。不过在TeXLive安装完成之前,我们可以先将VSCode与Git安装完成。
VSCode与Git下载安装
VSCode安装包下载请至官网。
Git安装包下载请至官网。
Git安装完成后,在命令行中输入git命令执行,查看是否成功返回Git的帮助信息:
配置VSCode
所有软件安装完成后,打开VSCode,搜索插件LaTeX
,安装后重新载入,使插件生效。
添加插件LaTeX Workshop
支持的“魔法注释”
对于一个项目,需要指定编译工具链才能正确地被编译成pdf文档。配合插件LaTeX Workshop
使用,如下设置可实现编译链pdflatex -> bibtex -> pdflatex*2
:
在主tex文件开头添加如下两行注释指定编译工具:
% !TEX program = pdflatex
% !BIB program = bibtex
在非主tex文件首行添加如下设置指定主tex文件的位置:
% !TEX root = 主tex文件绝对/相对路径
在VSCode中执行命令编译
按下Ctrl + Shift + P
,弹出VSCode的命令输入框,输入latex
后找到命令Build LaTeX Project
,执行后会看到左下角的编译动态以及VSCode的输出窗口中的编译日志。
编译完成后,即可在VSCode中预览编译生成的pdf文件,并且编辑tex文件后随时保存,就会触发重新编译生成新的pdf文档。打开预览窗口的方式有两种,一是点击tex文件编辑窗口右上角的第二个带有放大镜的按钮,二是使用命令的方式,如下图:
一切顺利的话,你就可以看到完整的pdf文档了。
Git的简单使用
对于Git新手,也许一个图形化界面更为方便。当然,还是强烈建议阅读文档,或者廖雪峰老师的Git教程。对于Windows平台的图形化界面,Github Desktop是一个不错的选择。下载安装后,点击首页的Clone a respository
按钮,输入项目的url(可以在项目的托管网站的主页找到)和想要保存的本地路径,就可以将远程项目克隆到本地。如果需要权限,会弹出窗口要求输入账号密码。
克隆完成后,可以在界面上方选择自己的分支:
在对项目进行修改后,需要通过commit
操作来提交修改(必须要有一段文字描述代码的改动,可以随便写。为了别人能够容易地读懂,可参照Commit 编写规范):
然后通过push
操作推送代码至远程服务器(可通过在 Github Desktop 中点击Push origin
):
最后,如果要把代码推送到master
分支的话,需要新建一个合并请求(pull request),这个可以直接在托管平台的网页上进行,以Coding.net(或腾讯云开发者平台)为例,点击项目主页的新建合并请求
,选择需要合并的分支和被合并入的分支,提交请求等待管理员接受:
当然,VSCode内置的Git插件支持这所有的操作,命令行更不必说。记得打开项目时先将master
分支合并到自己编辑的分支。