LaTeX + VSCode + Git 开发环境搭建

是一个排版软件,而则提供了一个极为丰富的宏集,让人们不需要费心构建费心钻研排版效果,而专注于文本的编写。对于像IEEE这样会提供论文的模板的出版社,撰写论文变得更加简单。TeXLive则是软件的其中一个广为人知的发行版。

而多个作者同时编辑一篇论文时,协同工作尤为必要。相对于微软对Word提供了协同工作的技术,其实的协同工作更为简单,因为文档由代码编译而成,所有的源文件都是文本文件,那么一个Git仓库就可以解决问题。

VSCode在这篇文章中出现是因为,个人没有发现的GUI编辑器们有谁长得好看。以及,配合插件使用,使用VSCode编写文档是一件很舒服的事情。

本篇文章只带领简单入门,保证可用,但更深入的内容本篇不予赘述。

TeXLive的下载安装

镜像下载

TeXLive官网默认的安装方式是使用在线安装包,这对于国内实在太慢了,所以建议下载光盘镜像文件离线安装。

LaTeX + VSCode + Git 开发环境搭建_第1张图片
下载页面

安装

挂载iso镜像为虚拟光驱(Win10双击iso文件即可,Win7之前的版本需要借助软件),然后使用管理员权限运行根目录下的批处理文件install-tl-advanced.bat,在弹出窗口中点击Continue,配置好安装路径后点击安装TeXLive,接下来进入漫长的等待。取决于机器配置,每个人耗费的时间可能有所不同,我本人安装了半个多小时。不过在TeXLive安装完成之前,我们可以先将VSCode与Git安装完成。

LaTeX + VSCode + Git 开发环境搭建_第2张图片
TeXLive安装

VSCode与Git下载安装

VSCode安装包下载请至官网。

Git安装包下载请至官网。

Git安装完成后,在命令行中输入git命令执行,查看是否成功返回Git的帮助信息:

LaTeX + VSCode + Git 开发环境搭建_第3张图片
Git安装完成

配置VSCode

所有软件安装完成后,打开VSCode,搜索插件LaTeX,安装后重新载入,使插件生效。

LaTeX + VSCode + Git 开发环境搭建_第4张图片
LaTeX Workshop

添加插件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的输出窗口中的编译日志。

LaTeX + VSCode + Git 开发环境搭建_第5张图片
LaTeX编译

编译完成后,即可在VSCode中预览编译生成的pdf文件,并且编辑tex文件后随时保存,就会触发重新编译生成新的pdf文档。打开预览窗口的方式有两种,一是点击tex文件编辑窗口右上角的第二个带有放大镜的按钮,二是使用命令的方式,如下图:

LaTeX + VSCode + Git 开发环境搭建_第6张图片
LaTeX预览

一切顺利的话,你就可以看到完整的pdf文档了。

Git的简单使用

对于Git新手,也许一个图形化界面更为方便。当然,还是强烈建议阅读文档,或者廖雪峰老师的Git教程。对于Windows平台的图形化界面,Github Desktop是一个不错的选择。下载安装后,点击首页的Clone a respository按钮,输入项目的url(可以在项目的托管网站的主页找到)和想要保存的本地路径,就可以将远程项目克隆到本地。如果需要权限,会弹出窗口要求输入账号密码。

LaTeX + VSCode + Git 开发环境搭建_第7张图片
克隆项目

克隆完成后,可以在界面上方选择自己的分支:

LaTeX + VSCode + Git 开发环境搭建_第8张图片
切换分支

在对项目进行修改后,需要通过commit操作来提交修改(必须要有一段文字描述代码的改动,可以随便写。为了别人能够容易地读懂,可参照Commit 编写规范):

LaTeX + VSCode + Git 开发环境搭建_第9张图片
commit

然后通过push操作推送代码至远程服务器(可通过在 Github Desktop 中点击Push origin):

LaTeX + VSCode + Git 开发环境搭建_第10张图片
push

最后,如果要把代码推送到master分支的话,需要新建一个合并请求(pull request),这个可以直接在托管平台的网页上进行,以Coding.net(或腾讯云开发者平台)为例,点击项目主页的新建合并请求,选择需要合并的分支和被合并入的分支,提交请求等待管理员接受:

LaTeX + VSCode + Git 开发环境搭建_第11张图片
pull request

当然,VSCode内置的Git插件支持这所有的操作,命令行更不必说。记得打开项目时先将master分支合并到自己编辑的分支。

你可能感兴趣的:(LaTeX + VSCode + Git 开发环境搭建)