VsCode配置Latex编译环境并且指定输出目录

 如何安装Tex Live,这里就不做介绍了,搜索引擎搜索一下应该就能搜索到。

以下内容分为两部分,第一个部分就是VsCode配置Latex编译环境,第二个部分就是指定生成文件的输出目录。

VsCode配置Latex编译环境

在扩展超市中下载LatexWorkShop扩展

 写扩展的配置

先打开全局的settings.json,打开方式如下

 将以下代码复制到settings.json中

    "latex-workshop.latex.autoBuild.run": "never",
    "latex-workshop.showContextMenu": true,
    "latex-workshop.intellisense.package.enabled": true,
    "latex-workshop.message.error.show": false,
    "latex-workshop.message.warning.show": true,
    "latex-workshop.latex.tools": [
        {
            "name": "xelatex",
            "command": "xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%",
                "-outdir=%OUTDIR%"
            ]
        },
        {
            "name": "pdflatex",
            "command": "pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "-outdir=%OUTDIR%",
                "%DOCFILE%"
            ]
        },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ]
        }
    ],
    "latex-workshop.latex.recipes": [
        {
            "name": "XeLaTeX",
            "tools": [
                "xelatex"
            ]
        },
        {
            "name": "PDFLaTeX",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "BibTeX",
            "tools": [
                "bibtex"
            ]
        },
        {
            "name": "LaTeXmk",
            "tools": [
                "latexmk"
            ]
        },
        {
            "name": "xelatex -> bibtex -> xelatex*2",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "pdflatex -> bibtex -> pdflatex*2",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        },
    ],
    "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"
    ],
    "latex-workshop.latex.autoClean.run": "onFailed",
    "latex-workshop.latex.recipe.default": "lastUsed",
    "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",

想要了解配置中的每一个对象的含义,还是要去阅读这个扩展的手册

此时,打开任意一个*.tex文件,左边都会出现一个TEX的图标,点开就是LaTexWorkShop的工具栏,点其中任意一个引擎就可以编译tex文件,点View Latex PDF就可以预览PDF

指定输出目录

直接进行编译,那么输出文件就会和源文件在同一个目录下,那么就会出现一大堆文件,很乱,就像这样

使用命令行编译指定输出目录

当在终端输入以下命令时,就会出现xelatex编译时的参数选项

xelatex -help

可以看到以下参数选项

 其中有一个参数选项是

-output-directory=DIR   use existing DIR as the directory to write files in

也即指定输出文件的路径,可以是相对路径

例子

这是编译前的文件结构

E:\CODING\SCRIPTS\LATEX\CHINESE-CLASSIC
│  books.bib
│  main.tex
│
└─figure
        1.jpg
        2.jpg
        3.jpg
        4.jpg

执行编译命令

# 这里创建Tmp文件夹来存放输出文件
# 注意,一定要在编译前创建好Tmp文件夹,xelatex在没有发现Tmp时会终止编译,不会帮你创建Tmp
mkdir Tmp  
xelatex -output-directory=Tmp main
bibtex Tmp/main.aux
xelatex -output-directory=Tmp main
xelatex -output-directory=Tmp main

编译完成之后的文件结构如下,文件的结构得到改善

E:\CODING\SCRIPTS\LATEX\CHINESE-CLASSIC
│  books.bib
│  main.tex
│
├─figure
│      1.jpg
│      2.jpg
│      3.jpg
│      4.jpg
│
└─Tmp
        main.aux
        main.bbl
        main.blg
        main.log
        main.pdf

在VsCode中修改LaTex WorkShop配置以指定输出目录

下面直接给出配置,当然,我会在与上面不同的地方做一下注释

"latex-workshop.latex.autoBuild.run": "never",
    "latex-workshop.showContextMenu": true,
    "latex-workshop.intellisense.package.enabled": true,
    "latex-workshop.message.error.show": false,
    "latex-workshop.message.warning.show": true,
    "latex-workshop.latex.outDir": "%DIR%/Tmp",
    "latex-workshop.latex.tools": [
        {
            "name": "xelatex",
            "command": "xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-output-directory=%OUTDIR%",
                "%DOCFILE%",
            ]
        },
        {
            "name": "pdflatex",
            "command": "pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-output-directory=%OUTDIR%",
                "%DOCFILE%"
            ]
        },
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "-outdir=%OUTDIR%",
                "%DOCFILE%"
            ]
        },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%OUTDIR%/%DOCFILE%"
            ]
        }
    ],
    "latex-workshop.latex.recipes": [
        {
            "name": "XeLaTeX",
            "tools": [
                "xelatex"
            ]
        },
        {
            "name": "PDFLaTeX",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "BibTeX",
            "tools": [
                "bibtex"
            ]
        },
        {
            "name": "LaTeXmk",
            "tools": [
                "latexmk"
            ]
        },
        {
            "name": "xelatex -> bibtex -> xelatex*2",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "pdflatex -> bibtex -> pdflatex*2",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        },
    ],
    "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"
    ],
    "latex-workshop.latex.autoClean.run": "onFailed",
    "latex-workshop.latex.recipe.default": "lastUsed",
    "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",

来,我们看看效果

这是编译前

 这是编译后

### 如何在 Mac 上配置 VSCode 支持 LaTeX 编辑和编译 #### 安装必备软件包 为了使 Visual Studio Code (VSCode) 能够支持 LaTeX 的编辑与编译,在 Mac 平台上需先安装 TeX 发行版——MacTeX。该发行版包含了完整的 TeX Live 系统以及众多宏包,能够满足大多数 LaTeX 文档的需求[^1]。 ```bash brew install --cask mactex ``` #### 设置 VSCode 和扩展插件 完成上述操作之后,打开 VSCode 应用程序并进入 Extensions 视图(快捷键 `Cmd+Shift+X`),搜索名为 "LaTeX Workshop" 的扩展,并点击安装按钮来获取此扩展。这一扩展提供了丰富的功能集用于处理 LaTeX 文件,包括语法高亮显示、自动补全、实时预览等功能[^2]。 #### 配置 JSON 文件实现自动化构建过程 接下来要做的就是在工作区设置里定义好用来控制文档编译流程的 json 对象。可以通过创建 `.vscode/settings.json` 文件来进行个性化定制: ```json { "latex-workshop.latex.toolchain": [ { "command": "pdflatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOC%" ] }, { "command": "bibtex", "args": ["%DOCFILE%"] } ], "latex-workshop.view.pdf.viewer": "tab" } ``` 以上配置指定了使用 pdflatex 进行 PDF 输出,并通过 bibtex 处理参考文献;最后指定内置浏览器作为默认查看方式[^3]。 #### 测试环境有效性 现在可以新建一个简单的 tex 文件测试整个链路是否正常运作了。如果一切顺利的话,则可以在保存文件后立即看到右侧标签页内自动生成对应的 pdf 结果。 ```tex \documentclass{article} \begin{document} Hello world! \end{document} ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值