MacTeX 使用指南

Undefined443發表於2024-03-06
Mac

MacTeX 發行版包含了一整套的 TeX/LaTeX 工具和程式。MacTeX 基本上是 TeX Live 的一個 macOS 版本。

安裝

brew install --cask mactex

使用

安裝好 MacTeX 後，你會獲得下列 5 款 GUI 工具：

  • TeXShop: TeX/LaTeX 編輯器
  • BibDesk: 參考文獻管理工具
  • LaTeXiT: 一種小巧的公式編輯器
  • hintview: HINT 檔案檢視器
  • TeX Live Utility: TeX Live 的包管理器（其實就是 tlmgr 的圖形前端）

HINT 檔案是一種可重排的 TeX 輸出檔案，它在預覽時可以像 HTML 網頁一樣對字型放大、縮小。

使用 hitex 和 hilatex 工具構建 HINT 檔案。

更多關於 HINT 檔案：HiTEX: Reflowable Output for TEX

開啟 LaTeXiT 時，可能遇到如下問題：

  1. 軟體語言是法語

解決方法：開啟系統設定（沒錯，是電腦的系統設定，不是軟體自身的設定），開啟 通用 > 語言與地區，在 首選語言 中新增 English 作為備選語言：

image

  1. 軟體提示找不到 Ghostscript 和 ps2pdf

解決方法：按下 ⌘ + , 進入設定，在 Typesetting 下，分別填寫 Ghostscript (gs) 的位置 /opt/homebrew/bin/gs 以及 ps2pdf 的位置 /opt/homebrew/bin/ps2pdf

注意，這兩個位置只適用於 ARM 架構的 Mac。如果你是 Intel 架構，或者你新增了上面的路徑之後顯示紅色，那麼你可以在終端執行 which xxx 來找到 gs 和 ps2pdf 的位置（將 xxx 分別替換為 gs 和 ps2pdf）

image

使用 TeX Live Utility 時可能遇到的問題是，如果你掛著梯子使用 TeX Live Utility，那麼有機率 TeX Live Utility 會卡死（實際上是在載入網路資源）。建議使用 TeX Live Utility 時不要掛梯子。

以及下列 CLI 工具（可能有遺漏）：

  1. TeX 引擎:
    • tex — 原始的 TeX 引擎。
    • latex — LaTeX 引擎，使用 DVI 格式輸出。
    • pdflatex — LaTeX 引擎，直接生成 PDF 文件。
    • xelatex — 支援現代字型技術（如 Unicode 和 OpenType）的LaTeX 引擎。
    • lualatex — 整合了 Lua 指令碼語言的 LaTeX 引擎。
  2. BibTeX 相關工具:
    • bibtex — 生成參考文獻列表的工具。
    • biber — BibTeX 的替代品，與 biblatex 宏包配合使用。
  3. 索引生成工具:
    • makeindex — 生成索引列表的工具。
    • xindy — 生成索引的工具，用於更復雜的索引排版。
  4. 格式轉換工具:
    • dvips — 將 DVI 格式檔案轉換為 PostScript 檔案。
    • dvipdfmx — 將 DVI 格式檔案轉換為 PDF 檔案。
    • ps2pdf — 將 PostScript 轉換為 PDF。
    • dvi2tty — 將 DVI 檔案顯示為ASCII文字。
    • gs — PostScript 和 PDF 解析和渲染工具
  5. 字型相關工具:
    • kpsewhich — 檔案查詢工具，用於查詢 TeX 系統中的檔案。
    • updmap — 更新字型對映檔案的工具。
    • mktexlsr 或 texhash — 更新 TeX 目錄索引資料庫。
  6. LaTeX 宏包和文件管理工具:
    • tlmgr — TeX Live 管理器，用於安裝和更新 TeX Live 宏包。
  7. 其他工具:
    • texdoc — 檢視TeX相關文件的工具。
    • texconfig — TeX 配置工具。
    • mpost — 圖形程式語言，用來建立向量圖形。

與 Visual Studio Code 整合

當我們有了一系列 TeX 工具後，我們就可以使用 Visual Studio Code 編寫並編譯 LaTeX 文件了。

首先我們要在 Visual Studio Code 中安裝 LaTeX Workshop 外掛。

之後，為了能夠編譯中文 LaTeX 文件，我們需要對外掛進行一些配置。

自從有了 latexmk 工具後，編譯（中文）LaTeX 文件不再那麼麻煩，不需要像以前一樣多次編譯，使用 latexmk 工具只需一次即可編譯出我們想要的 PDF 檔案。

更多關於 latexmk：cantab.net

我們只需按下 ⌘ + , 進入設定，搜尋 latex recipe default，將 Latex-workshop 構建時使用的預設 recipe 設定為 lastUsed：

image

接下來編譯一個 .tex 檔案：開啟 LaTeX Workshop 外掛，在 Build LaTeX project 下拉選單中找到 Recipe: latexmk (xelatex)，點選它進行編譯。

接下來，你如果再想編譯 .tex 檔案，只需點選 Visual Studio Code 介面右上角的執行按鈕就可以自動使用上次的編譯選項（Recipe: latexmk (xelatex)）進行編譯了。

image

清理臨時檔案：

latexmk -c  # 不清理 PDF 以及其他一些最終檔案
latexmk -C  # 清除所有檔案（包括 PDF）

其它可參考資源：

「MacTeX 小筆記」如何使用 LaTeXiT，以及匯出一個數學公式圖片 | CSDN

使用 TeX Live 包管理器 tlmgr 安裝宏包：MacTeX 安裝 xeCJK 和 CTEX 搭建中文環境 | 知乎

相關文章