跳到內容
Oleaflyv0.4.12

文件工具

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

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

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

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

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

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

每一列也有這些控制項:

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

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

  • 內建的編譯器 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 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 的專案上,這個區塊會這樣說明。

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

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

  • 編輯器:編輯器工具列的其他部分
  • 編譯:建置期間如何取得套件
  • 文件設定:不需要寫套件程式碼就能設定紙張大小、邊界和字型
圖片預覽

無法載入 AI 回答

請再試一次,或搜尋文件。