86 lines
3.2 KiB
JSON
86 lines
3.2 KiB
JSON
{
|
||
// LaTeX Workshop 配方 —— 与 docs/paper/README.md 记录的口令一致：
|
||
// latexmk -xelatex -interaction=nonstopmode -halt-on-error main.tex
|
||
// 论文需要多遍编译（交叉引用、目录与长表格），且必须用 XeLaTeX（ctex + fontspec），
|
||
// 因此默认配方取 latexmk，而不是单遍 xelatex。
|
||
"latex-workshop.latex.workingDirectory": "%DIR%",
|
||
"latex-workshop.latex.tools": [
|
||
{
|
||
// 默认配方使用的工具：%DOCFILE% 与 %DIR% 配合，
|
||
// 切换工作目录后传给 latexmk 的仍是纯文件名，避免绝对路径与 \input 相对路径冲突。
|
||
"name": "latexmk (xelatex, paper)",
|
||
"command": "latexmk",
|
||
"args": [
|
||
"-synctex=1",
|
||
"-interaction=nonstopmode",
|
||
"-halt-on-error",
|
||
"-file-line-error",
|
||
"-xelatex",
|
||
"%DOCFILE%"
|
||
],
|
||
"env": {}
|
||
},
|
||
{
|
||
// 备选：产物集中到 build/ 子目录，源码目录更干净；
|
||
// 需要清理时删除 docs/paper/build 即可（该目录已在 .gitignore 中）。
|
||
"name": "latexmk (xelatex, outdir=build)",
|
||
"command": "latexmk",
|
||
"args": [
|
||
"-synctex=1",
|
||
"-interaction=nonstopmode",
|
||
"-halt-on-error",
|
||
"-file-line-error",
|
||
"-xelatex",
|
||
"-outdir=build",
|
||
"%DOCFILE%"
|
||
],
|
||
"env": {}
|
||
},
|
||
{
|
||
// 单遍 xelatex 只用于排查单个文件的语法错误，交叉引用会显示为 ??
|
||
"name": "xelatex (单遍，调试用)",
|
||
"command": "xelatex",
|
||
"args": [
|
||
"-synctex=1",
|
||
"-interaction=nonstopmode",
|
||
"-file-line-error",
|
||
"%DOCFILE%"
|
||
],
|
||
"env": {}
|
||
}
|
||
],
|
||
"latex-workshop.latex.recipes": [
|
||
{
|
||
"name": "latexmk (xelatex, paper)",
|
||
"tools": ["latexmk (xelatex, paper)"]
|
||
},
|
||
{
|
||
"name": "latexmk (xelatex, outdir=build)",
|
||
"tools": ["latexmk (xelatex, outdir=build)"]
|
||
},
|
||
{
|
||
"name": "xelatex (单遍，调试用)",
|
||
"tools": ["xelatex (单遍，调试用)"]
|
||
}
|
||
],
|
||
// 默认配方：本项目的实际编译口令（多遍 + XeLaTeX + 遇错即停）。
|
||
//
|
||
// 产物写入 build/ 而不是就地写 docs/paper/main.pdf：就地编译时若 PDF 预览
|
||
// 仍打开发着 main.pdf，Windows 会锁住该文件，xdvipdfmx 随即报
|
||
// "gave an error" 且不产出 PDF，表现为"编译没反应"。
|
||
// 写到 build/ 后，预览读的是 docs/paper/build/main.pdf，不再与源码目录的
|
||
// main.pdf 抢占，保存即编译也就稳定了。
|
||
// 需要就地产出时，把下面这行改为 "latexmk (xelatex, paper)"，并先关闭 PDF 预览。
|
||
"latex-workshop.latex.recipe.default": "latexmk (xelatex, outdir=build)",
|
||
// 预览与 build/ 配方保持一致
|
||
"latex-workshop.latex.outDir": "build",
|
||
// 保存即编译：单次编译约十秒，开启后可直接看 PDF 预览；
|
||
// 只想手动触发时把下一行改为 "never"。
|
||
"latex-workshop.latex.autoBuild.run": "onSave",
|
||
"latex-workshop.latex.autoClean.run": "onBuilt",
|
||
"latex-workshop.latex.clean.subfolder.enabled": true,
|
||
"latex-workshop.view.pdf.viewer": "tab",
|
||
// 禁止 LaTeX Workshop 用启发式自动切换工具，始终按上面的配方执行
|
||
"latex-workshop.latex.build.forceRecipeUsage": true
|
||
}
|