在本機裡安裝 LaTeX 和相關環境設定

緣起

曾經使用過 Word 來撰寫較偏向學術格式的報告，當時的感受是雖然對於基本操作非常熟悉，不需要太多的學習成本，但是由於有引用其他文獻、圖片等內容的需求，需要搭配如 EndNote 這樣的工具來進行，個人覺得不是非常好上手，因而產生蠻大的學習成本，另外在版型的調整上也一直沒辦法達到滿意的標準。

後來接觸到了 Markdown 並使用它來寫筆記之後發現它的方便之處 ( 也因此有了這個部落格的誕生 )，而在其中要使用到數學式的表達的時候就會使用到一點點的 LaTeX 語法來協助，也就是在這時候才慢慢了解到 LaTeX 的強大，因此在撰寫論文的時候也使用了 LaTeX 來進行。

這篇文章的目的是為了記錄當時將 LaTeX 安裝到電腦裡，到調整一些環境設定的過程。目前比較常見的可能會是像 Overleaf 這樣的線上 IDE，好處是使用上十分的快速效率，也有許多範本模板可以套用，不過對於有版本控制的需求者來說， 如果可以直接把專案在本機裡面進行編譯輸出，又可以輕鬆的結合 Git 版控，似乎是個比較方便的組合。且目前 Overleaf 的免費編譯成 PDF 的功能有 timeout 的限制，如果文件太肥的話就沒辦法透過它輸出 PDF，會是比較大的限制。

下載 LaTeX

當時使用的下載管道是 MiKTeX，裡面有提供對應不同規格的下載管道，這邊使用的是 Windows Installer 的版本，順著指示一步一步往下走就可以了，記得最後可以把 check updates 的選項勾起來確保更新。

編譯設定

編輯器選擇

由於筆者慣用的是編輯器是 VSCode，所以後續的設定也會以 VSCode 為例，不過不同的編輯器之間的差異應該不會到太大，唯一的差別可能是 extension 的支援可能在各個編輯器中會有一點不同。在 VSCode 當中，比較熱門被使用的是 LaTeX Workshop 這個擴充。

設定檔調整

下一步是要到 VSCode 的環境設定檔裡面進行一些修改，可以透過 Ctrl+Shift+P 搜尋 settings 進入到 JSON 的設定檔裡面，並加入以下的幾項設定：

"latex-workshop.latex.tools": [
    {
      "name": "xelatex",
      "command": "xelatex",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "%DOC%"
      ]
    },
    {
      "name": "biber",
      "command": "biber",
      "args": ["%DOCFILE%"]
    }
  ],
  "latex-workshop.latex.recipes": [
    {
      "name": "xelatex, biber, xelatex, xelatex",
      "tools": ["xelatex", "biber", "xelatex", "xelatex"]
    }
  ],
  "latex-workshop.latex.autoBuild.run": "onFileChange",
  "latex-workshop.formatting.latexindent.path": "latexindent"

上面的第一項 latex-workshop.latex.tools 是啟用的基本設定，像在裡面我使用到了 xelatex 和 biber 兩種編譯器，因此就需要分別設定它們。latex-workshop.latex.recipes 則是編譯的順序，這項設定會讓編譯器在編譯的時候按照輸入的順序依次進行編譯，以這邊為例就是會依序進行 xelatex、biber、xelatex、xelatex 總共四次的編譯。最後的兩項則是編譯的時機和 format 相關的設定。

設定完成後就可以透過 VSCode 進行 LaTeX 的編譯~，有時候在編譯的時候會遇到需要安裝新套件的提示，再根據指示把它安裝起來就可以了！