编辑器设置 - stone-zeng/fduthesis GitHub Wiki

编辑器设置

TeXStudio

我们需要将TeXStudio改成中文,然后设置默认使用XeLaTeX或者LuaLaTeX编译。

设置中文

打开TeXStudio设置,左边「General」,右边「Language」,选择zh_CN,点击OK即可。

最好再重启一下TeXStudio。

编译

哦刚才设置成中文了是吧……

打开LaTeX设置,左边「构建」,右边「默认编译器」,选择XeLaTeX或者LuaLaTeX,下方点击确定,即可。

Visual Studio Code

编辑器设置 - Visual Studio Code

有些人比较喜欢在TexStudio之类的“集成开发环境”中写东西。有些人则更喜欢在纯文本的环境中写。

下面是VSCode的设置技巧。

安装 LaTeX Workshop 插件

打开VSCode,找到 扩展 ,搜索 LaTeX Workshop,安装,并重新启动VSCode。

这样,一旦你打开TeX文件,左边就会出现TeX扩展面板,里面有你需要的常用功能。

自定义设置

「Code-首选项-设置」,点击右上角的{}图标,切换到源代码模式。

将下面的东西复制到最后一个后花括号内:

    "latex-workshop.latex.clean.onFailBuild.enabled": true,
    "latex-workshop.latex.tools": [
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "-outdir=%OUTDIR%",
                "%DOC%"
            ]
        },
        {
            "name": "pdflatex",
            "command": "pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOC%"
            ]
        },
        
    {
      "name": "xelatex",
      "command": "xelatex",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "%DOC%"
      ]
    },{
        "name": "lualatex",
        "command": "lualatex",
        "args": [
          "-synctex=1",
          "-interaction=nonstopmode",
          "-file-line-error",
          "%DOC%"
        ]
      },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ]
        }
    ],
    "latex-workshop.latex.recipes": [
        {
            "name": "LuaLaTeX Chain",
            "tools": [
                "lualatex",
                "bibtex",
                "lualatex",
                "lualatex"
            ]
        },
        {
            "name": "Latexmk Chain",
            "tools": [
                "latexmk"
            ]
        },
        {
            "name": "PdfLaTeX Chain",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        },
        {
            "name": "XeLaTeX Chain",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        }

然后再说上面的东西都是做什么的:

  1. latex-workshop.latex.clean.onFailBuild.enabled是说,如果编译失败,则清除临时文件。如果不想,则可以不加这一句。
  2. latex-workshop.latex.tools里面列出了所有可能的工具:latex、pdflatex、xelatex、biblatex……这些工具和参数,如果不熟悉的话,可以去TexStudio的设置里面抄出来。
  3. latex-workshop.latex.recipes定义了编译流程,其中第一个会被默认使用。对于本项目,我们将LuaLaTeX设置成默认。当然,你也可以将XeLaTeX设置为默认——将「XeLaTeX Chain」这一小节东西和「LuaLaTeX Chain」对调即可。

当然,如果你除了四遍编译外不需要额外流程,也可以使用下面这段配置。

    "latex-workshop.latex.tools": [
        {
            "name": "latexmk-pdflatex",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "-outdir=%OUTDIR%",
                "%DOC%"
            ]
        },
        {
            "name": "latexmk-lualatex",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-lualatex",
                "-outdir=%OUTDIR%",
                "%DOC%"
            ]
        },
        {
            "name": "latexmk-xelatex",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-xelatex",
                "-outdir=%OUTDIR%",
                "%DOC%"
            ]
        }
    ],
    "latex-workshop.latex.recipes": [
        {
            "name": "LuaLatexmk Chain",
            "tools": [
                "latexmk-lualatex"
            ]
        },
        {
            "name": "XeLaTeX Chain",
            "tools": [
                "latexmk-xelatex"
            ]
        },
        {
            "name": "PdfLatexmk Chain",
            "tools": [
                "latexmk-pdflatex"
            ]
        }
    ],

这个配置的意思是,直接调用latexmk所定义的编译顺序进行编译。同样的,默认使用latex-workshop.latex.recipes里面的第一个配置来进行编译。

如何使用

打开一个tex文件,左侧会出现TeX扩展面板。

在面板的上面半部分中找到「Build LaTeX Project」,双击它;或者展开它并选择下面的「Recipe: XXX Chain」,即可编译。

如果编译失败,可以点击屏幕最下方的“错误/警告/提示”按钮查看详情。

自动格式化

我们当然希望能将LaTeX自动格式化为比较好看的样式。

但是需要提醒你的是,MacTeX自带的格式化工具稍微有些问题,需要安装一些Perl的依赖,可以看此教程此issue

——世上无难事,只要肯放弃。但是折腾出来的话会用得很爽。