文件工具
套件
搜尋 CTAN 的 LaTeX 套件和 Typst Universe 的 Typst 套件,然後從編輯器工具列把其中一個加入你的文件。
LaTeX 和 Typst 文件的大部分額外功能都來自套件。編輯器工具列右端的套件按鈕,會為專案的語言開啟可搜尋的清單,並替你寫入載入套件的那一行。Markdown 專案沒有套件按鈕。
你也可以從 ⌘K 面板,用 瀏覽 LaTeX 套件 或 瀏覽 Typst 套件 開啟這份清單。
LaTeX 套件
標題為「LaTeX 套件」的段落在 LaTeX 專案中,選擇 LaTeX 套件。依套件名稱或說明搜尋 CTAN。如果連不到 CTAN,或你處於離線狀態,對話框會告訴你,並改為顯示 Oleafly 內建的清單。無法重新整理的清單會顯示它的下載日期。
每一列可能會顯示這些標籤:
- 已在文件中:主要檔案已經載入這個套件。
- 文件類別:這個項目是類別,不是套件。類別是用
\documentclass設定的,所以這一列讓你複製那一行,但不能加入。 - 已安裝:你的 TeX 發行版已經有這個套件。
每一列也有這些控制項:
- 選項,一個用於套件選項的欄位,例如
margin=2cm。大括號必須成對,且不能使用]或%。 - 加入序言區,把
\usepackage[options]{name}寫入主要檔案的序言區。如果檔案已經載入該套件,就不會更動任何東西,對話框會告訴你。 - 複製這一行,複製同一行
\usepackage,若是類別則複製\documentclass那一行。 - CTAN,開啟該套件在 CTAN 上的頁面。
- 安裝,用於你的 TeX 發行版缺少的套件。見下文。
安裝 LaTeX 套件
標題為「安裝 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 時,如果編譯找不到某個檔案,錯誤訊息會提供 尋找並安裝,它會找出該檔案屬於哪個套件。請參閱從缺少檔案中恢復。
請從 重新編譯 旁邊的箭頭選擇編譯器。請參閱 LaTeX 引擎。
Typst 套件
標題為「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 的專案上,這個區塊會這樣說明。
這個區塊也會顯示專案中有多少個套件。
開啟離線模式時,對話框會使用它上次下載的套件清單,並顯示其日期。如果從未下載過清單,在你連上網路之前就無法顯示。