# 套件

搜尋 CTAN 的 LaTeX 套件和 Typst Universe 的 Typst 套件，然後從編輯器工具列把其中一個加入你的文件。

LaTeX 和 Typst 文件的大部分額外功能都來自套件。編輯器工具列右端的套件按鈕，會為專案的語言開啟可搜尋的清單，並替你寫入載入套件的那一行。Markdown 專案沒有套件按鈕。

你也可以從 ⌘K 面板，用 **瀏覽 LaTeX 套件** 或 **瀏覽 Typst 套件** 開啟這份清單。

## LaTeX 套件

在 LaTeX 專案中，選擇 **LaTeX 套件**。依套件名稱或說明搜尋 CTAN。如果連不到 CTAN，或你處於離線狀態，對話框會告訴你，並改為顯示 Oleafly 內建的清單。無法重新整理的清單會顯示它的下載日期。

每一列可能會顯示這些標籤：

- **已在文件中**：主要檔案已經載入這個套件。
- **文件類別**：這個項目是類別，不是套件。類別是用 `\documentclass` 設定的，所以這一列讓你複製那一行，但不能加入。
- **已安裝**：你的 TeX 發行版已經有這個套件。

每一列也有這些控制項：

- **選項**，一個用於套件選項的欄位，例如 `margin=2cm`。大括號必須成對，且不能使用 `]` 或 `%`。
- **加入序言區**，把 `\usepackage[options]{name}` 寫入主要檔案的序言區。如果檔案已經載入該套件，就不會更動任何東西，對話框會告訴你。
- **複製這一行**，複製同一行 `\usepackage`，若是類別則複製 `\documentclass` 那一行。
- **CTAN**，開啟該套件在 CTAN 上的頁面。
- **安裝**，用於你的 TeX 發行版缺少的套件。見下文。

### 安裝 LaTeX 套件

「已安裝」的意義取決於專案如何編譯：

- 內建的編譯器 **Tectonic** 會在文件第一次使用套件時下載它。沒有東西需要安裝，對話框頂端也會這樣告訴你。
- **使用 TeX Live 或 TinyTeX 的 latexmk**：當你的 TeX 發行版有 `tlmgr` 時，Oleafly 會檢查你有哪些套件，將它們標為 **已安裝**，並對其餘的提供 **安裝**。安裝會針對那一個套件執行 `tlmgr`。
- **來自 Debian、Ubuntu 或 Fedora 的 TeX Live**：由系統的套件管理員管理，所以對話框會說明用 `apt` 或 `dnf` 安裝套件，而且沒有 **安裝** 按鈕。
- **其他 TeX 環境**，例如 MiKTeX：Oleafly 無法判斷哪些套件已經存在，所以各列不會顯示安裝狀態。MiKTeX 請使用 MiKTeX Console。

使用 TeX Live 或 TinyTeX 時，如果編譯找不到某個檔案，錯誤訊息會提供 **尋找並安裝**，它會找出該檔案屬於哪個套件。請參閱[從缺少檔案中恢復](/docs/latex-engines/#recover-from-a-missing-file)。

請從 **重新編譯** 旁邊的箭頭選擇編譯器。請參閱 [LaTeX 引擎](/docs/latex-engines/)。

## Typst 套件

在 Typst 專案中，選擇 **Typst 套件** 來瀏覽 Typst Universe。可以依名稱、關鍵字或類別搜尋，或用類別標籤縮小清單。對話框一次最多顯示 100 個套件，所以清單很長時請搜尋。

每一列會顯示套件名稱、它的最新版本、範本套件的 **範本** 徽章，以及簡短的說明。當套件需要比專案目前使用的更新的 Typst 時，該列會說明它需要哪個版本。

- **插入 import** 會把 `#import "@preview/name:version": *` 加到已開啟的 `.typ` 檔案頂端那些 import 的後面。如果檔案已經匯入該套件，只會更改版本號碼。編輯器中必須開啟一個 Typst 檔案。
- **複製 import** 複製同一行。

### 更新提示

當檔案中的 `@preview` import 比 Typst Universe 上的最新版本更舊時，編輯器會在版本上標出提示，例如「cetz 0.4.2 已推出。這個 import 使用的是 0.3.4。」提示中的 **更新到 0.4.2** 動作會就地更改該數字。

### 把套件跟著專案一起保存

Typst 會在專案第一次匯入套件時，把它們下載到共用的快取中。若要讓專案帶著自己的副本，請使用對話框底部的 **專案套件**：

- **使用專案資料夾中的套件** 會讓 Typst 先在專案的 `typst-packages` 資料夾中尋找。以這種方式設定的專案可以離線編譯，也能在其他電腦上編譯。
- **將套件複製到專案** 會把專案匯入的每個套件，從快取複製到 `typst-packages`。如果某個套件還不在快取中，請在連線時編譯一次，然後再複製一次。

兩者都需要 Typst 0.12 或更新版本。在鎖定為 Typst 0.11 的專案上，這個區塊會這樣說明。

這個區塊也會顯示專案中有多少個套件。

### 離線

開啟離線模式時，對話框會使用它上次下載的套件清單，並顯示其日期。如果從未下載過清單，在你連上網路之前就無法顯示。

## 相關頁面

- [編輯器](/docs/editor/#the-editor-toolbar)：編輯器工具列的其他部分
- [編譯](/docs/compiling/)：建置期間如何取得套件
- [文件設定](/docs/document-settings/)：不需要寫套件程式碼就能設定紙張大小、邊界和字型
