VScode 配置為 LaTeX IDE
在Windows中，配置VScode作為L(zhǎng)aTeX的編輯器(IDE)，并使用SumatraPDF預(yù)覽PDF文件。主要是LaTeX Workshop擴(kuò)展的設(shè)置，如果要使用外部的PDF閱讀器，則還需要設(shè)置SumatraPDF。
安裝擴(kuò)展
ctrl+shift+x調(diào)出應(yīng)用商店，搜索并安裝LaTeX Workshop擴(kuò)展：
配置LaTeX Workshop
LaTeX文件.tex的編譯、預(yù)覽、輔助文件的清理等都在擴(kuò)展latex workshop中設(shè)置。
LaTeX Workshop中，編譯LaTeX文件時(shí)順序執(zhí)行的一系列/組命令稱(chēng)為L(zhǎng)aTeX食譜(recipes)，定義在latex-workshop.latex.recipes。缺省情況，LaTeX Workshop包含2個(gè)基本的食譜，分別由latex-workshop.latex.recipes和latex-workshop.latex.Tools定義。第一個(gè)食譜的tools域中的工具定義在第二個(gè)食譜。latex workshop的參數(shù)含義見(jiàn)LaTeX Workshop的配置文件"package.json"或https://github.com/James-Yu/LaTeX-Workshop/wiki/Compile#latex-recipes了解配置情況。
LaTeX Workshop默認(rèn)的編譯方式為latexmk和pdflatex。如下配置修改了latex workshop的編譯方式、預(yù)覽、輔助文件等。特別添加了xelatex及包含bib時(shí)的編譯。
ctrl+shift+p ->settings->首選項(xiàng)：打開(kāi)用戶設(shè)置(Json)，在settings.json中添加如下內(nèi)容：
"latex-workshop.showContextMenu":true, //右鍵菜單
"latex-workshop.intellisense.package.enabled": true, //根據(jù)加載的包，自動(dòng)完成命令或包
"latex-workshop.latex.autoBuild.run": "never", //禁止保存文件時(shí)自動(dòng)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": [ //設(shè)定清理文件的類(lèi)型
"*.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文件的預(yù)覽方式
快捷鍵
打開(kāi)鍵盤(pán)快捷方式面板(左下側(cè)齒輪，或快捷鍵ctrl+k,ctrl+s)：
- 搜索"切換側(cè)欄可見(jiàn)性"，設(shè)置快捷鍵為ctrl+k ctrl+b。
- 搜索 latex build，將默認(rèn)的ctrl+alt+b替換為ctrl+b(與Sublime Text 3統(tǒng)一)。
- 搜索latex recipe，設(shè)置快捷鍵為ctlr+r，方便點(diǎn)菜(選擇編譯方式)！(ST3中是顯示文檔大綱)。
其他常用的快捷鍵：
- ctrl+k ctrl+a： 切換活動(dòng)欄可見(jiàn)性(左側(cè)圖標(biāo)開(kāi)關(guān))
- ctrl+alt+x：顯示LaTeX面板(左側(cè)編譯命令面板和文檔大綱)。
- ctrl+alt+c：清除輔助文件
- ctrl+alt+v：查看編譯的pdf文件(預(yù)覽)
- ctrl+alt+j：正向搜索。當(dāng)設(shè)置
"latex-workshop.view.pdf.viewer": "tab";時(shí)，在LaTeX源文件中按下快捷鍵，定位到PDF文檔相應(yīng)位置。(反向搜索見(jiàn)后面)
一些快捷處理
根據(jù)latex-workshop.latex.recipes中的name段設(shè)定，可在.tex文件首行指定編譯方式。如%!TEX program = xelatex表示用xelatex編譯文件，而%!TEX program = PDFlatex表示用latexpdf編譯文件。多個(gè)文件情況，還可以用% !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}
設(shè)置LaTeX文件和PDF文件之間的正/反向搜索
正向搜索是指按某種方式操作源文件中的部分，會(huì)在PDF文件中立即到達(dá)對(duì)應(yīng)的部分。反向搜索就是在PDF文檔的正文中某個(gè)位置點(diǎn)擊，光標(biāo)會(huì)定位到源文件的相應(yīng)位置。正反向搜索十分方便文檔錯(cuò)誤的修改。反向搜索需要用到SumatraPDF軟件(或Zathura)。
SumatraPDF軟件是一款小巧強(qiáng)悍的PDF閱讀器，是免費(fèi)開(kāi)源軟件。國(guó)內(nèi)有多個(gè)PDF閱讀器基于SumatraPDF修改而來(lái)。
SumatraPDF官方下載地址：https://www.sumatrapdfreader.org/download-free-pdf-viewer.html
根據(jù)自己電腦操作系統(tǒng)，選擇相應(yīng)的軟件下載并安裝。
下面操作的一些說(shuō)明：
我的VScode文件位置：VScode.exe在D:/ProgramFiles/Coding/VSCode文件夾
擴(kuò)展安裝在D:/ProgramFiles/Coding/VSCode/.vscode/。即將默認(rèn)的%USERPROFILE%\.vscode和%APPDATA%\Code轉(zhuǎn)移到了D:/ProgramFiles/Coding/VSCode文件夾中，然后建立了聯(lián)接：
- mklink /J "%USERPROFILE%\.vscode" ".vscode"
- mklink /J ""%APPDATA%\Code"" "Code"
將SumatraPDF.exe復(fù)制到D:/ProgramFiles/Coding/VSCode/.vscode/，后面的設(shè)置只是針對(duì)這個(gè)位置的SumatraPDF.exe，設(shè)置不會(huì)影響其他位置的SumatraPDF.exe。因?yàn)槲矣袝r(shí)會(huì)使用Sumblime Text3，默認(rèn)的SumatraPDF.exe已經(jīng)對(duì)其設(shè)置。
使用下面的設(shè)置，需要修改其中的VScode.exe、cli.js、SumatraPDF.exe這三個(gè)文件的路徑為自己電腦對(duì)應(yīng)的路徑。
步驟如下：
打開(kāi)設(shè)置文件settings.json，添加如下設(shè)置(注意查找重復(fù)的配置項(xiàng)，如前面的配置中最后一行有latex-workshop.view.pdf.viewer，用下面的替換)：
// 設(shè)置預(yù)覽方式
"latex-workshop.view.pdf.viewer":"external",
"latex-workshop.view.pdf.ref.viewer":"external",
// 設(shè)置外部PDF預(yù)覽器
"latex-workshop.view.pdf.external.viewer.command": "D:/ProgramFiles/Coding/VSCode/.vscode/SumatraPDF.exe",
"latex-workshop.view.pdf.external.viewer.args": [
"%PDF%"
],
// 配置Syntex的正向搜索(這是官網(wǎng)的)
"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中設(shè)置。打開(kāi)SumatraPDF，進(jìn)入設(shè)置->選項(xiàng) 對(duì)話框，在“設(shè)置反向搜索命令行”處填入如下內(nèi)容(是一行內(nèi)容，不是2行！)：
"D:\ProgramFiles\Coding\VSCode\Code.exe"
"D:\ProgramFiles\Coding\VSCode\resources\app\out\cli.js" -r -g "%f:%l"
雙擊PDF中的任意一處即可跳轉(zhuǎn)到VSCode中所對(duì)應(yīng)的內(nèi)容的源代碼處
反向搜索的使用：打開(kāi)一個(gè)已經(jīng)編譯的TeX文件，ctrl+alt+v打開(kāi)PDF文件。在PDF文件中的某行文字處，雙擊鼠標(biāo)左鍵，會(huì)切換到了源文件的相應(yīng)位置。如果點(diǎn)擊的是公式、圖等，可能不會(huì)正確返回。
正向搜索的使用：將光標(biāo)移動(dòng)到TeX文件的正文。ctrl+alt+x，找到"navigator,select and edit"，點(diǎn)擊第一項(xiàng)"syncTeX from cursor"(或右鍵選擇，或快捷鍵ctrl+alt+j )，會(huì)切換到PDF文件的相應(yīng)位置。
如果不成功，檢查路徑設(shè)置，或者文件名錯(cuò)誤。正反向搜索用到了.synctex.gz文件，不能刪除。
參考文章
Viewing Synctex
使用VSCode編寫(xiě)LaTeX
最后的設(shè)置(sumatraPDF預(yù)覽+正反搜索)
"latex-workshop.showContextMenu":true,
"latex-workshop.intellisense.package.enabled": true, //根據(jù)加載的包，自動(dòng)完成命令或包
"latex-workshop.latex.autoBuild.run": "never", //禁止保存文件時(shí)自動(dòng)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",
// 設(shè)置外部PDF預(yù)覽器
"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%"
],
到此這篇關(guān)于詳解VScode 配置為 LaTeX 編輯器(IDE)的文章就介紹到這了,更多相關(guān)VScode LaTeX編輯器內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
您可能感興趣的文章:- 在VScode上使用latex編輯pdf的方法
- Win10下為VSCode配置LaTex編輯器的方法
- vscode編寫(xiě)latex的方法
