VS Code + LaTeX

原文地址:知乎《VS Code + LaTeX》
作者:柏星

相比於Word來說LaTeX的優點在於:

  • 擁有豐富的模板,排版所需的時間要小於Word
  • 寫公式和排版公式非常方便,特別是當涉及大量公式時
  • 當你需要更換模板時可以非常快速地套用另一個LaTeX模板,基本不需要修改

相比於Word來說LaTeX的缺點在於:

  • 上手複雜,光是安裝和環境配置都比Word要難出幾個數量級
  • 當出現錯誤時很難定位錯誤,LaTeX的錯誤日誌並不是很容易理解,特別是遇到一些摸不着頭腦的錯誤時
  • 當你不滿足於套模板,想要根據自己的需要修改格式時,工作量就會大幅攀升,同時LaTeX沒有一個User-friendly社區(StackExchange可能好一點?)

本篇文章主要針對LaTeX的環境配置。基於目前熱門編輯器Visual Studio Code + LaTeX Workshop插件配合TeXLive環境,我們可以簡單快速地配置好一個LaTeX環境。

當然最簡單的還是直接用OverLeaf,擁有大量的免費模板,且不需要任何配置,編輯後保存即可在線編譯,還支持團隊協作。缺點在於國內訪問較慢且不穩定,在保存的過程中可能會出現錯誤等情況。

本文章適用於Windows/macOS/Linux系統。

一、安裝TeXLive

TeXLive即LaTeX的編譯環境,最新版本爲2019,在其官方網站可以進行下載。對於mac可以進行下載。對於macOS用戶,下載MacTeX 2019直接運行安裝即可。對於Windows和Linux用戶,有兩種下載方式:

運行後會啓動安裝程序,可以根據需要進行修改,或者直接點擊“安裝”:

在等待一段時間後安裝完成。

接下來測試LaTeX是否正常安裝。在命令提示行/終端中運行命令:

$ latex --help

如果顯示如下,說明安裝正確:

如果顯示“找不到命令”等等提示,需要進一步將TeXLive安裝路徑加入PATH環境變量中,具體參見:

麓山南人:你應該知道的 Windows 環境變量zhuanlan.zhihu.com圖標

二、安裝並配置VS Code

安裝TeXLive後我們還需要一個編輯器,訪問VS Code官方網站下載並安裝。安裝完成後可以對VS Code進行一些配置,例如更換主題、更換字體、修改設置項以及安裝一些常用插件。

接下來我們需要安裝LaTeX Workshop插件,可以通過兩種方式安裝,一是在側邊欄的擴展選項卡中查找LaTeX Workshop並點擊安裝:

二是訪問插件主頁進行安裝:

LaTeX Workshop - Visual Studio Marketplacemarketplace.visualstudio.com圖標

安裝完成後打開一個.tex文件即可看到,整個文件已經支持代碼高亮:

主要分爲:

  • 功能區,提供大部分主要功能
  • 大綱
  • 編輯區,撰寫文章內容
  • 預覽區,提供PDF文件的預覽,每次保存都會自動刷新

具體LaTeX Workshop插件的配置可以參考官方文檔(英文):

https://github.com/James-Yu/LaTeX-Workshop/wiki/Installgithub.com

這裏針對常用功能進行說明:

1. 編譯生成

LaTeX Workshop中有兩個概念需要了解:工具(Tools)和組合(Recipe)。工具(Tool)指編譯器,常見的主要有pdfLaTeX、XeLaTeX、LuaLaTeX等,他們之間的區別見:

TeX 家族 · 一份其實很短的 LaTeX 入門文檔 · 看雲www.kancloud.cn

在這裏我們只需要知道他們是不同的編譯器即可。模板一般會指定編譯時使用的編譯器,如果不確定的話不妨都試一試。組合(Recipe)即編譯器的組合使用,當你的LaTeX文件涉及引用等比較複雜的需求時需要進行組合編譯。LaTeX Workshop本身提供了多個編譯組合,在功能區中點擊“Build LaTeX Project”可以看到所有默認組合:

以pdfLaTeX→bibTeX→pdfLaTeX * 2爲例,它會先運行一次pdfLaTeX,一次bibTeX,再運行兩次pdfLaTeX,最終生成帶有交叉引用的完整PDF。這是最常用的編譯組合。在這裏還可以看到Terminate選項,當編譯時間過長時可以選擇中止。

LaTeX Workshop每次默認會採用第一個編譯組合進行編譯,可以在設置中進行修改成最後一次使用的:

此外,LaTeX Workshop默認在保存的時候自動編譯,可以修改爲不自動編譯:

如果你想要加入自定義的工具或者編譯組合,可以參考我的配置:

LaTeX Workshop Config - 代碼片段 - 碼雲 Gitee.comgitee.com

其中主要涉及兩個配置:"latex-workshop.latex.tools"用以指定工具,"latex-workshop.latex.recipes"用以指定編譯組合。也可以參考官方文檔:

Compile · James-Yu/LaTeX-Workshop Wikigithub.com

具體如何打開自定義配置,如下圖所示:

2. 正向搜索和反向搜索

LaTeX Workshop支持從.tex文件跳轉到PDF相應位置(正向搜索),以及從PDF跳轉到.tex相應位置(反向搜索)。

正向搜索直接在功能區內找到“SyncTeX from cursor”即可:

反向搜索直接在預覽區PDF的文字上按住Ctrl+左鍵即可自動跳轉。

需要注意的是不要刪除XeLaTeX生成的.synctex.gz文件,否則正向/反向搜索功能將會失效。

3. 公式符號

在功能區內找到“Snippet Panel”,即可插入常用的公式符號和命令。

4. 快捷鍵

LaTeX Workshop本身的快捷鍵比較複雜,可以在設置中自行修改:

三、配置Zotero

寫論文的過程中另一個比較麻煩的點是參考文獻的管理和引用。在這裏安利一個優秀的文獻管理軟件Zotero,不僅免費、開源且支持中文,目前也有一些優秀的插件。首先訪問Zotero官方網站進行下載安裝,推薦同時安裝Zotero Connector瀏覽器插件,可以自動將Google Scholar、arXiv等網站上的論文自動添加到文獻庫中。(如果要安裝Safari版Connector請參考這裏。)

安裝完成以後Zotero可以直接使用,但是以下兩個插件可以使得Zotero更優化:

1. ZotFile

ZotFile可以自動爲下載的PDF文件按照一定格式進行重命名,同時還可以使Zotero支持OneDrive、iCloud和堅果雲等第三方雲存儲(Zotero本身提供雲存儲,但是價格比較貴)。

首先從ZotFile官方網站下載插件,然後在Zotero工具欄中點擊“工具”→“插件”打開“插件”窗口,選擇“從文件安裝插件...”選中剛纔下載的.xpi文件安裝並重啓。

接下來需要進行設置,在工具欄中點擊“工具”→“ZotFile Preferences...“打開設置窗口,主要需要設置兩部分:

  1. General Setting,主要包括文件存儲位置

2. Renaming Rules,主要包括文件命名規則

文件夾和文件的命名規則具體可參考官方文檔

將存儲位置指定爲雲存儲的文件夾後,每當通過Zotero Connector添加文獻時,自動下載的文獻會被重命名並移動到雲存儲中,這樣就可以實現多終端自動同步。

2. Better BibTeX for Zotero

重頭戲,通過這個插件可以自動生成BibTeX文件,還支持自動更新等諸多高級功能。首先登錄官方GitHub下載插件,安裝方法和ZotFile一致。

安裝完成後重啓,在左側選擇一個分類點擊右鍵並選擇“導出分類”,在其中選擇“Better BibLaTeX”,在下方勾選“Keep updated”,並指定文件導出,這樣就可以完成文獻管理+自動生成BibTeX文件:

四、其他

到這裏整個LaTeX編輯環境基本已經配置完成,再多安利幾個本人覺得比較有用的軟件。首先說字體,英文等寬字體比較推薦Fira Code,設計美觀且提供諸多現代字體的功能。其次是公式,當你需要參考一些公式時,通過公式識別軟件直接將公式轉換成LaTeX代碼是再方便不過的了,Mathpix Snip支持將圖片直接轉換成LaTeX,免費版有次數限制,但是寫文章夠用了。LaTeX文章同步推薦用GitHub,可以通過Git進行版本管理,每次提交修改都能對之前的改動進行回溯。爲了減少上傳體積,可以通過.gitignore文件指定不上傳一些編譯過程中產生的中間文件,具體可以參考:

LaTeX Git Ignore - 代碼片段 - 碼雲 Gitee.comgitee.com

最後再推薦一個VS Code插件 LaTeX Utilities:

LaTeX Utilities - Visual Studio Marketplacemarketplace.visualstudio.com

可以提供圖片/表格自動粘貼、文檔字數統計和Zotero引用管理等功能。

參考

Marvey:使用VSCode編寫LaTeXzhuanlan.zhihu.com圖標VS Code 與 LaTeX 真乃天作之合www.jianshu.com圖標http://liuchengxu.org/blog-cn/posts/quick-latex/liuchengxu.org
關於 · 一份其實很短的 LaTeX 入門文檔 · 看雲www.kancloud.cn
用Markdown寫公式www.cyprestar.com圖標

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章