引言
参考视频:
- 发SCI必备的【LaTex】使用教程(第二期)
1. 设置 Vscode 编辑器格式
配置代码决定了如何在 Vscode 中编译 Latex 代码。
// 当设置为"never"时,禁用了保存LaTeX文档时自动编译的功能。"latex-workshop.latex.autoBuild.run": "never",// 启用VS Code编辑器中的LaTeX文件右键菜单。"latex-workshop.showContextMenu": true,// 启用LaTeX Workshop的智能感知功能,包括代码自动完成、参数信息等。"latex-workshop.intellisense.package.enabled": true,// 禁用错误信息在编辑器中的显示。"latex-workshop.message.error.show": false,// 禁用警告信息在编辑器中的显示。"latex-workshop.message.warning.show": false,
2. 定义 Latex 编译工具的配置
xelatex
提供 Unicode 支持。
Unicode 是一种国际标准.为所有字符提供唯一的数字标识,适合处理复杂的文本和字体。
// 定义了LaTeX编译工具的配置,包括工具名称、命令和参数。"latex-workshop.latex.tools": [{"name": "xelatex", // 工具名称:xelatex"command": "xelatex", // 执行的命令"args": [ // 命令参数"-synctex=1", // 启用同步TeX,方便在PDF和源文件之间跳转"-interaction=nonstopmode", // 设置为非停止模式,编译时不中断"-file-line-error", // 显示错误的文件名和行号"%DOCFILE%" // 代表当前文档的路径]},
pdflatex
和传统的 Latex 宏包和文档类有很好的兼容性,适合处理大多数英文文档。
{"name": "pdflatex", // 工具名称:pdflatex"command": "pdflatex","args": [ // 命令参数,与xelatex类似"-synctex=1","-interaction=nonstopmode","-file-line-error","%DOCFILE%"]},
latexmk
用来实现自动化编译 Latex 文档。
{"name": "latexmk", // 工具名称:latexmk"command": "latexmk","args": [ // 命令参数,latexmk特有的参数"-synctex=1","-interaction=nonstopmode","-file-line-error","-pdf", // 生成PDF输出"-outdir=%OUTDIR%", // 输出目录,%OUTDIR%为占位符"%DOCFILE%"]},
bibtex
用来处理 Latex 文档中的参考文献
{"name": "bibtex", // 工具名称:bibtex"command": "bibtex","args": [ // 命令参数"%DOCFILE%" // 代表当前文档的路径,用于处理参考文献]}]
3. 设置编译链
如果文档既涉及中文,又涉及英文,还涉及参考文献,就需要多次编译,编译链就是用来解决该问题的工具。
// 定义了LaTeX编译流程的名称和使用的编译工具序列。"latex-workshop.latex.recipes": [{"name": "XeLaTeX", // 编译流程名称:单独使用XeLaTeX"tools": ["xelatex"] // 使用的工具},{"name": "PDFLaTeX", // 编译流程名称:单独使用PDFLaTeX"tools": ["pdflatex"]},{"name": "BibTeX", // 编译流程名称:单独使用BibTeX"tools": ["bibtex"]},{"name": "LaTeXmk", // 编译流程名称:使用latexmk"tools": ["latexmk"]},{"name": "xelatex -> bibtex -> xelatex*2", // 编译流程名称:xelatex + bibtex + 两次xelatex"tools": ["xelatex", "bibtex", "xelatex", "xelatex"]},{"name": "pdflatex -> bibtex -> pdflatex*2", // 编译流程名称:pdflatex + bibtex + 两次pdflatex"tools": ["pdflatex", "bibtex", "pdflatex", "pdflatex"]}],
4. 清除多余文件
// 定义了编译过程中生成的临时文件类型,这些文件在清理时会被删除。"latex-workshop.latex.clean.fileTypes": ["*.aux", "*.bbl", "*.blg", "*.idx", "*.ind", "*.lof", "*.lot","*.out", "*.toc", "*.acn", "*.acr", "*.alg", "*.glg", "*.gls","*.glo", "*.ist", "*.fls", "*.log", "*.fdb_latexmk"// 这些文件类型包含了LaTeX编译过程中生成的各种辅助文件],// 设置在编译失败时自动清理临时文件。"latex-workshop.latex.autoClean.run": "onFailed",// 设置默认使用上次使用的编译流程。"latex-workshop.latex.recipe.default": "lastUsed",// 设置PDF查看器中同步TeX的快捷键为双击。"latex-workshop.view.pdf.internal.synctex.keybinding": "double-click"