安装准备
- TeXLive / MacTeX / MiKTeX等LaTeX发行版
- VSCode
Vscode 配置
安装插件:
LaTeX Workshop (必装)
LaTeX Workshop 支持 LaTeX 的编译、预览、语法检查等功能。
English Word Hint
English Word Hint 是一个英语单词提示插件,可以在编写英语文档时,自动提示相关英语单词,并显示对应的中文翻译,提高英文文档编写效率。
Path Auto Complete
Path Auto Complete 可以自动补全路径,方便快速插入图片。
indent rainbow
indent rainbow 可以为不同层级的缩进添加不同的颜色,方便阅读。
Word Count CJK
Word Count CJK 可以统计中文文档的字数。
Material Icon Theme
Material Icon Theme 可以为不同类型的文件添加不同的图标,方便区分。
LaTeX Workshop 配置
基本配置
// 鼠标悬停,预览公式时,支持 boldsymbol 宏
"latex-workshop.hover.preview.mathjax.extensions": [
"boldsymbol"
],
// 是否启用 IntelliSense,自动补全引用的包中的环境和命令
"latex-workshop.intellisense.package.enabled": true,
// 编译后的文件输出目录
"latex-workshop.latex.outDir": "./tmp",
// 默认编译引擎为上次使用的
"latex-workshop.latex.recipe.default": "lastUsed",
// 预览复杂公式,使用时需要通过 command palette (命令面板) 打开
"latex-workshop.mathpreviewpanel.cursor.enabled": true,
// 不允许弹窗显示错误信息
"latex-workshop.message.error.show": false,
// 不允许弹窗显示警告信息
"latex-workshop.message.warning.show": false,
// 预览 PDF 时,反转颜色
"latex-workshop.view.pdf.invert": 1,
// 预览 PDF 时,自动检测是否需要反转颜色
"latex-workshop.view.pdf.invertMode.enabled": "auto",
编译工具链配置
推荐使用 latexmk 进行编译,latexmk 可以自动检测文档中的变化,自动进行编译,并且同时支持多种编译引擎,包括 XeLaTeX、PdfLaTeX。
在 settings.json 文件中找到 latex-workshop.latex.tools 和 latex-workshop.latex.recipes 配置项,将其全部删除,并修改为如下配置
"latex-workshop.latex.recipes": [
{
"name": "XeLaTeX",
"tools": [
"xelatexmk"
]
},
{
"name": "PdfLaTeX",
"tools": [
"pdflatexmk"
]
}
],
"latex-workshop.latex.tools": [
{
"args": [
"-synctex=1",
"-pdfxe",
"-interaction=nonstopmode",
"-file-line-error",
"-outdir=%OUTDIR%",
"%DOC%"
],
"command": "latexmk",
"env": {},
"name": "xelatexmk"
},
{
"args": [
"-synctex=1",
"-pdf",
"-interaction=nonstopmode",
"-file-line-error",
"-outdir=%OUTDIR%",
"%DOC%"
],
"command": "latexmk",
"env": {},
"name": "pdflatexmk"
}
],
预览与同步TeX
https://github.com/James-Yu/LaTeX-Workshop/wiki/View#internal-pdf-viewer,
官网上有详细配置说明,这里简单介绍通过内置的pdf预览器的前向与反向搜索的快捷键:
- Forward/Direct search:
在编辑器中点击某个位置,window通过ctrl+alt+j
跳转,mac通过cmd+option+j
跳转。
- Backward/Inverse search: 使用内部查看器时,指向 pdf
预览中的元素的默认键绑定是
ctrl+click
。可以使用设置latex-workshop.view.pdf.internal.synctex.keybinding
将其更改为double-click
。"latex-workshop.view.pdf.internal.synctex.keybinding": "double-click"
参考:
在 VSCode 中配置 LaTeX 环境 https://github.com/shinyypig/latex-vscode-config