以前写论文的时候经常使用的是Word,往往写完论文后排版需要花上个1-2天。虽然通过了计算机二级考试,但是深深觉得Word的排版非常辛苦,一次偶然的机会在B站上了解到了LaTeX,一开始感觉用代码写文章非常神奇,有点像Markdown,但LaTeX的语法和表达形式非常丰富,而且实际上写论文用它无非是套用个模板,我们只要把文字填充到代码里面就好了,能导出跟Word一样美观的文章,个人感觉非常实用,极大提高了生产效率,因此决定好好学习LaTeX,并在VSCode中搭建起自己的写作环境。
网页版的LaTeX
其实说到LaTex,如果你想在线体验或者觉得搭建环境很麻烦,可以直接用网页版的LaTeX,也就是OverLeaf,网址是:https://www.overleaf.com/,这个网站上有很多期刊的LaTex格式,而且是在线编译器,用起来很方便。
Sumatra PDF/Skim PDF阅读器的安装
这是两个都是非常轻量的PDF阅读器,当然已经有其他合适的PDF阅读器也是可以的。
Sumatra PDF是在Win系统上使用的,Skim是在Mac系统上使用的,下载和安装非常迅速,而且也没有什么需要注意的,最多就是安装路径要选择一下,比如我一般安装路径不会放在C盘。
Sumatra PDF下载地址:https://www.sumatrapdfreader.org/download-free-pdf-viewer
Skim下载地址:https://skim.en.softonic.com/mac
LaTeX的安装
可以去清华大学开源软件镜像站去下载texlive,它是一个LaTeX安装编译包。
下载地址:https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/
有4.3G还是比较大的,下载好后文件是这样的:
双击点击进入后,可以看到:
右键以管理员身份运行该程序:
一个命令行小黑框后会出现GUI界面,这里的Installation root就是你的安装路径,可以修改到其他存储盘,这里的安装TeXworks前端可以不勾选,因为我们之后的操作都会在VSCode中编译,所以可以取消掉勾选,然后选择Advanced。
在安装程序中打开左下角的Customize,这里是让你选择语言的,只要勾选Chinese和UK/US就可以了,其他语言可以不选择,这样能节约很多存储空间。
然后点击安装,就会进入漫长的安装过程,全程大概需要半个小时,只要挂在那边就行了。
安装好后就会提示你,“欢迎进入 TeX Live 的世界!”
到这一步,我们的LaTeX就安装完成了,接下来是VSCode的环境配置了,不过要记一下自己的安装路径,我这里是安装到E盘的。
VSCode的插件配置
在VSCode中安装LaTeX的相关拓展插件,其中最重要的就是LaTex Workshop。
在VSCode中使用快捷键Ctrl+Shift+P,出现一个搜索框,输入JSON,选择Preferences:Open User Settings(JSON)这个,从而就能打开settings.json,进行环境配置了。
正常里面的内容是这样的:
我们需要在这里面写一些配置,这里最重要的就是要把Sumatra PDF跟LaTeX的本地路径写对,而不能简单的复制粘贴,除非你跟我的路径一模一样,如果是MAC系统应该可以不用管。
要注意的三个点:
- 修改路径的时候,如果复制过来路径是\记得改成/;
- 如果找不到自己的安装路径了,可以在电脑左下角的搜索框里面输入软件的名称,然后右键选择打开文件位置,如果看见的是快捷方式,那么继续对快捷方式右键选择打开文件所在位置,最后就可以找到exe程序所在的位置了;
- 原本的JSON文件里面有个"git.enableSmartCommit": true,要在后面加一个逗号“,”,不然会出现语法错误。
完整的JSON内容:
{
"workbench.colorTheme": "Default Dark+",
"git.enableSmartCommit": true,
// ===================================LaTeX的相关配置,切记选择对自己的软件路径===================================
// bibtex 格式
"latex-workshop.bibtex-format.tab": "tab",
// 个人比较喜欢保存后就会自动编译,所以选择了onSave
"latex-workshop.latex.autoBuild.run": "onSave",
"latex-workshop.latex.autoBuild.cleanAndRetry.enabled": false,
// 设置 latex-workshop 的 PDF 预览程序,external 指的是外部程序
"latex-workshop.view.pdf.viewer": "external",
"latex-workshop.view.pdf.ref.viewer": "external",
"latex-workshop.view.pdf.external.viewer.command": "C:/Users/colof/AppData/Local/SumatraPDF/SumatraPDF.exe", // 注意修改SumatraPDF路径 如果复制过来路径是\记得改成/
"latex-workshop.view.pdf.external.viewer.args": [
"-forward-search",
"%TEX%",
"%LINE%",
"-reuse-instance",
"-inverse-search",
"code.cmd -r -g \"%f\":%l",
"%PDF%"
],
// 配置正向、反向搜索:.tex -> .pdf
"latex-workshop.view.pdf.external.synctex.command": "C:/Users/colof/AppData/Local/SumatraPDF/SumatraPDF.exe", // 注意修改SumatraPDF路径
"latex-workshop.view.pdf.external.synctex.args": [
// 正向搜索
"-forward-search",
"%TEX%",
"%LINE%",
"-reuse-instance",
// 反向搜索
"-inverse-search",
"\"E:/Microsoft VS Code/Code.exe\" \"E:/Microsoft VS Code/resources/app/out/cli.js\" -gr %f:%l",//注意修改VSCode路径
"%PDF%"
],
// 清空中间文件,最终只会保存tex和pdf
"latex-workshop.latex.clean.fileTypes": [
"*.aux",
"*.bbl",
"*.blg",
"*.idx",
"*.ind",
"*.lof",
"*.lot",
"*.out",
"*.toc",
"*.acn",
"*.acr",
"*.alg",
"*.glg",
"*.glo",
"*.gls",
"*.ist",
"*.fls",
"*.log",
"*.fdb_latexmk",
"*.gz"
],
"latex-workshop.latex.autoClean.run": "onBuilt",
// 使用上次的recipe编译组合
"latex-workshop.latex.recipe.default": "lastUsed",
// 用于反向同步的内部查看器的键绑定。ctrl/cmd +点击(默认)或双击
"latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",
"window.zoomLevel": 1
}
测试
去OverLeaf网站上找个模板测试一下:
可以看到,我们已经能够成功编译并且浏览了,到这里,LaTeX+VSCode+Sumatra PDF/Skim的科研学术写作环境就搭配完成了,后面就是一些插件的按照,能够提高写作的效率/愉悦感。
说明一下,正向和反向搜索就是你点击源代码或者PDF会跳转到对应位置,如果设置"latex-workshop.latex.autoClean.run": "onBuilt"是不能成功实现的,要改成onFailed才行。
好用的插件
Ultra Math Preview
一款可以实时查看LaTeX代码里面的公式的插件,比较好用。
遇到的问题
- Recipe terminated with fatal error: spawn xelatex enoent.
这个是因为环境变量中没有加入LaTeX的路径(搜索“查看高级系统设置”)。注意,这里是用户和系统的Path都必须要都引入,弄好后必须要重启电脑,才能在VSCode中访问到LaTeX的路径,可以在终端中输入tex -v来测试一下是不是真的弄好了。
弄好后记得确定保存,然后重启电脑就可以了。