当前位置: 首页 > 编程笔记 >

详解VScode 配置为 LaTeX 编辑器(IDE)

荣俊
2023-03-14
本文向大家介绍详解VScode 配置为 LaTeX 编辑器(IDE),包括了详解VScode 配置为 LaTeX 编辑器(IDE)的使用技巧和注意事项,需要的朋友参考一下

VScode 配置为 LaTeX IDE

在Windows中,配置VScode作为LaTeX的编辑器(IDE),并使用SumatraPDF预览PDF文件。主要是LaTeX Workshop扩展的设置,如果要使用外部的PDF阅读器,则还需要设置SumatraPDF。

安装扩展

ctrl+shift+x调出应用商店,搜索并安装LaTeX Workshop扩展:

配置LaTeX Workshop

LaTeX文件.tex的编译、预览、辅助文件的清理等都在扩展latex workshop中设置。

LaTeX Workshop中,编译LaTeX文件时顺序执行的一系列/组命令称为LaTeX食谱(recipes),定义在latex-workshop.latex.recipes。缺省情况,LaTeX Workshop包含2个基本的食谱,分别由latex-workshop.latex.recipes和latex-workshop.latex.Tools定义。第一个食谱的tools域中的工具定义在第二个食谱。latex workshop的参数含义见LaTeX Workshop的配置文件"package.json"或https://github.com/James-Yu/LaTeX-Workshop/wiki/Compile#latex-recipes了解配置情况。

LaTeX Workshop默认的编译方式为latexmk和pdflatex。如下配置修改了latex workshop的编译方式、预览、辅助文件等。特别添加了xelatex及包含bib时的编译。

ctrl+shift+p ->settings->首选项:打开用户设置(Json),在settings.json中添加如下内容:

"latex-workshop.showContextMenu":true,        //右键菜单
"latex-workshop.intellisense.package.enabled": true, //根据加载的包,自动完成命令或包 
"latex-workshop.latex.autoBuild.run": "never",    //禁止保存文件时自动build 
"latex-workshop.latex.recipes": [ 
 { 
  "name": "latexmk", 
  "tools": [ 
   "latexmk" 
  ] 
 }, 
 { 
  "name": "PDFlatex", 
  "tools": [ 
   "pdflatex" 
  ] 
 }, 
 { 
  "name": "pdflatex ->žž bibtex ->žž pdflatex2", 
  "tools": [ 
   "pdflatex", 
   "bibtex", 
   "pdflatex", 
   "pdflatex" 
  ] 
 }, 
 { 
  "name": "xelatex", 
  "tools": [ 
   "xelatex" 
  ] 
 }, 
 { 
  "name": "xelatex -> bibtex -> xelatex", 
  "tools": [ 
   "xelatex", 
   "bibtex", 
   "xelatex", 
  ] 
 } 
], 
"latex-workshop.latex.tools":[ 
 { 
  "name": "latexmk", 
  "command": "latexmk", 
  "args": [ 
   "-synctex=1", 
   "-interaction=nonstopmode", 
   "-file-line-error", 
   "-pdf", 
   "-outdir=%OUTDIR%", 
   "%DOC%" 
  ], 
  "env": {} 
  }, 
  { 
  "name": "pdflatex", 
  "command": "pdflatex", 
  "args": [ 
   "-synctex=1", 
   "-interaction=nonstopmode", 
   "-file-line-error", 
   "%DOC%" 
  ], 
  "env": {} 
  }, 
  { 
  "name": "xelatex", 
  "command": "xelatex", 
  "args": [ 
   "-synctex=1", 
   "-interaction=nonstopmode", 
   "-file-line-error", 
   "%DOC%" 
  ], 
  "env": {} 
  }, 
  { 
  "name": "bibtex", 
  "command": "bibtex", 
  "args": [ 
   "%DOCFILE%" 
  ], 
  "env": {} 
  } 
], 
"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", 
 "*.nav", 
 "*.snm", 
 "*.synctex.gz" 
], 
"latex-workshop.view.pdf.viewer":"tab",  //pdf文件的预览方式

快捷键

打开键盘快捷方式面板(左下侧齿轮,或快捷键ctrl+k,ctrl+s):

  • 搜索"切换侧栏可见性",设置快捷键为ctrl+k ctrl+b。
  • 搜索 latex build,将默认的ctrl+alt+b替换为ctrl+b(与Sublime Text 3统一)。
  • 搜索latex recipe,设置快捷键为ctlr+r,方便点菜(选择编译方式)!(ST3中是显示文档大纲)。

其他常用的快捷键:

  • ctrl+k ctrl+a: 切换活动栏可见性(左侧图标开关)
  • ctrl+alt+x:显示LaTeX面板(左侧编译命令面板和文档大纲)。
  • ctrl+alt+c:清除辅助文件
  • ctrl+alt+v:查看编译的pdf文件(预览)
  • ctrl+alt+j:正向搜索。当设置"latex-workshop.view.pdf.viewer": "tab";时,在LaTeX源文件中按下快捷键,定位到PDF文档相应位置。(反向搜索见后面)

一些快捷处理

根据latex-workshop.latex.recipes中的name段设定,可在.tex文件首行指定编译方式。如%!TEX program = xelatex表示用xelatex编译文件,而%!TEX program = PDFlatex表示用latexpdf编译文件。多个文件情况,还可以用% !TEX root指定主文件,% !TEX bib指定bib的编译方式。

示例

%! TeX program = pdflatex
\documentclass{article}

\begin{document}
  press ctrl+b to complie,press ctrl+alt+v to view pdf
\end{document}

设置LaTeX文件和PDF文件之间的正/反向搜索

正向搜索是指按某种方式操作源文件中的部分,会在PDF文件中立即到达对应的部分。反向搜索就是在PDF文档的正文中某个位置点击,光标会定位到源文件的相应位置。正反向搜索十分方便文档错误的修改。反向搜索需要用到SumatraPDF软件(或Zathura)。

SumatraPDF软件是一款小巧强悍的PDF阅读器,是免费开源软件。国内有多个PDF阅读器基于SumatraPDF修改而来。

SumatraPDF官方下载地址:https://www.sumatrapdfreader.org/download-free-pdf-viewer.html

根据自己电脑操作系统,选择相应的软件下载并安装。

下面操作的一些说明:

我的VScode文件位置:VScode.exe在D:/ProgramFiles/Coding/VSCode文件夹

扩展安装在D:/ProgramFiles/Coding/VSCode/.vscode/。即将默认的%USERPROFILE%\.vscode和%APPDATA%\Code转移到了D:/ProgramFiles/Coding/VSCode文件夹中,然后建立了联接:

  • mklink /J "%USERPROFILE%\.vscode" ".vscode"
  • mklink /J ""%APPDATA%\Code"" "Code"

将SumatraPDF.exe复制到D:/ProgramFiles/Coding/VSCode/.vscode/,后面的设置只是针对这个位置的SumatraPDF.exe,设置不会影响其他位置的SumatraPDF.exe。因为我有时会使用Sumblime Text3,默认的SumatraPDF.exe已经对其设置。

使用下面的设置,需要修改其中的VScode.exe、cli.js、SumatraPDF.exe这三个文件的路径为自己电脑对应的路径。
步骤如下:

打开设置文件settings.json,添加如下设置(注意查找重复的配置项,如前面的配置中最后一行有latex-workshop.view.pdf.viewer,用下面的替换):

// 设置预览方式
"latex-workshop.view.pdf.viewer":"external",
"latex-workshop.view.pdf.ref.viewer":"external",
// 设置外部PDF预览器
"latex-workshop.view.pdf.external.viewer.command": "D:/ProgramFiles/Coding/VSCode/.vscode/SumatraPDF.exe",
"latex-workshop.view.pdf.external.viewer.args": [
  "%PDF%"
],
// 配置Syntex的正向搜索(这是官网的)
"latex-workshop.view.pdf.external.synctex.command": "D:/ProgramFiles/Coding/VSCode/.vscode/SumatraPDF.exe",
"latex-workshop.view.pdf.external.synctex.args": [
  "-forward-search",
  "%TEX%",
  "%LINE%",
  "-reuse-instance",
  "-inverse-search",
  "D:/ProgramFiles/Coding/VSCode/Code.exe D:/ProgramFiles/Coding/VSCode/resources/app/out/cli.js -r -g %f:%l",
  "%PDF%"
],

配置反向搜索(PDF->Latex源文件)

反向搜索在SumatraPDF中设置。打开SumatraPDF,进入设置->选项 对话框,在“设置反向搜索命令行”处填入如下内容(是一行内容,不是2行!):

"D:\ProgramFiles\Coding\VSCode\Code.exe"

"D:\ProgramFiles\Coding\VSCode\resources\app\out\cli.js" -r -g "%f:%l"

双击PDF中的任意一处即可跳转到VSCode中所对应的内容的源代码处

反向搜索的使用:打开一个已经编译的TeX文件,ctrl+alt+v打开PDF文件。在PDF文件中的某行文字处,双击鼠标左键,会切换到了源文件的相应位置。如果点击的是公式、图等,可能不会正确返回。

正向搜索的使用:将光标移动到TeX文件的正文。ctrl+alt+x,找到"navigator,select and edit",点击第一项"syncTeX from cursor"(或右键选择,或快捷键ctrl+alt+j ),会切换到PDF文件的相应位置。

如果不成功,检查路径设置,或者文件名错误。正反向搜索用到了.synctex.gz文件,不能删除。

参考文章

Viewing & Synctex

使用VSCode编写LaTeX

最后的设置(sumatraPDF预览+正反搜索)

  "latex-workshop.showContextMenu":true,
  "latex-workshop.intellisense.package.enabled": true, //根据加载的包,自动完成命令或包
  "latex-workshop.latex.autoBuild.run": "never",    //禁止保存文件时自动build
  "latex-workshop.latex.recipes": [
   {
    "name": "latexmk",
    "tools": [
     "latexmk"
    ]
   },
   {
    "name": "PDFlatex",
    "tools": [
     "pdflatex"
    ]
   },
   {
    "name": "pdflatex ->žž bibtex ->žž pdflatex2",
    "tools": [
     "pdflatex",
     "bibtex",
     "pdflatex",
     "pdflatex"
    ]
   },
   {
    "name": "xelatex",
    "tools": [
     "xelatex"
    ]
   },
   {
    "name": "xelatex -> bibtex -> xelatex*2",
    "tools": [
     "xelatex",
     "bibtex",
     "xelatex",
     "xelatex"
    ]
   }
  ],
  "latex-workshop.latex.tools":[
   {
    "name": "latexmk",
    "command": "latexmk",
    "args": [
     "-synctex=1",
     "-interaction=nonstopmode",
     "-file-line-error",
     "-pdf",
     "-outdir=%OUTDIR%",
     "%DOC%"
    ],
    "env": {}
    },
    {
    "name": "pdflatex",
    "command": "pdflatex",
    "args": [
     "-synctex=1",
     "-interaction=nonstopmode",
     "-file-line-error",
     "%DOC%"
    ],
    "env": {}
    },
    {
    "name": "xelatex",
    "command": "xelatex",
    "args": [
     "-synctex=1",
     "-interaction=nonstopmode",
     "-file-line-error",
     "%DOC%"
    ],
    "env": {}
    },
    {
    "name": "bibtex",
    "command": "bibtex",
    "args": [
     "%DOCFILE%"
    ],
    "env": {}
    }
  ],
  //"latex-workshop.latex.autoClean.run": "onBuilt",
  "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",
   "*.nav",
   "*.snm",
   "*.synctex.gz",
   "*.bcf",
   "*.run.xml"
  ],
  "latex-workshop.view.pdf.viewer":"external",
  "latex-workshop.view.pdf.ref.viewer":"external",
  // 设置外部PDF预览器
  "latex-workshop.view.pdf.external.viewer.command": "D:/ProgramFiles/Coding/VSCode/.vscode/SumatraPDF.exe",
  "latex-workshop.view.pdf.external.viewer.args": [
    "%PDF%"
  ],
  // 配置Syntex的正向搜索(Latex->PDF)
  "latex-workshop.view.pdf.external.synctex.command": "D:/ProgramFiles/Coding/VSCode/.vscode/SumatraPDF.exe",
  "latex-workshop.view.pdf.external.synctex.args": [
   "-forward-search",
   "%TEX%",
   "%LINE%",
   "-reuse-instance",
   "-inverse-search",
   "D:/ProgramFiles/Coding/VSCode/code D:/ProgramFiles/Coding/VSCode/resources/app/out/cli.js -r -g %f:%l",
   "%PDF%"
  ],

到此这篇关于详解VScode 配置为 LaTeX 编辑器(IDE)的文章就介绍到这了,更多相关VScode LaTeX编辑器内容请搜索小牛知识库以前的文章或继续浏览下面的相关文章希望大家以后多多支持小牛知识库!

 类似资料:
  • 本文向大家介绍Win10下为VSCode配置LaTex编辑器的方法,包括了Win10下为VSCode配置LaTex编辑器的方法的使用技巧和注意事项,需要的朋友参考一下 任务描述     写小论文的利器是什么呢?LaTex!写代码的利器是什么呢?VSCode!好,那么如何在VSCode上配置LaTex环境呢,以及配置之后,如何选择编译的方式呢?大部分博客只说如何配置,却不说如何编译,导致在编译的过程

  • 工欲善其事,必先利其器。想要学好 Go 语言,肯定要有一个趁手的开发工具,Go 语言的开发工具有很多种,本文会给大家介绍一种使用面积最广泛、免费且开源的 Go 语言开发工具—— VSCode。 1. VSCode的简介 VSCode (Visual Studio Code)是微软在 2015 年 4 月 30 日 Build 开发者大会上发布的一款开源、免费而且可以跨平台使用的代码编辑器,其具有使

  • VS Code 是微软出的一款开源代码编辑器,秉承了微软在IDE领域的一惯优秀基因,是一款潜力相当大的编辑器/IDE。 VScode 目前也对 Rust 也有良好的支持。 下载 VScode 请打开官网 https://code.visualstudio.com/ 下载编辑器。 依赖 如本章第一节所述,准备好 racer,rust 源代码,rustfmt,rls 这四样东西,并且配置好相应的环境变

  • 本文向大家介绍自己的vscode-settings.json配置详解,包括了自己的vscode-settings.json配置详解的使用技巧和注意事项,需要的朋友参考一下 vscode从插件库里安装eslint和prettier 实现自动格式化 第二版本 第一项 VS code编辑使用eslint的规则去格式化代码 VS code还可以指定ESLint的格式文件 第二项 使用 Prettier -

  • 本文向大家介绍详解VSCode配置启动Vue项目,包括了详解VSCode配置启动Vue项目的使用技巧和注意事项,需要的朋友参考一下 下载安装并配置VSCode 随便百度上搜个最新的VSCode安装好后,点击Ctrl + Shit + X打开插件扩展窗口进行插件扩展,这里要安装两个插件。 1、vetur插件的安装 该插件是vue文件基本语法的高亮插件,在插件窗口中输入vetur点击安装插件就行,装好

  • 您的代码编辑器是您主要的开发工具;你使用它来编写和保存代码。通过学习编辑器的快捷方式和安装主要的插件,可以使你更好,更快编写代码。 TL;DR 选择一个编辑器,您可以自定义快捷方式,并有许多插件可以帮助您更好,更快编写代码。 使用包管理器,以便使你更容易发现,安装和更新插件。 安装有助于提高开发效率的插件;使用本指南中的建议。 安装 Sublime text 编辑器 Sublime是一个伟大的编辑