文件工具
文件設定
在對話方塊中變更紙張大小、邊界、字型、語言、行距和編號,它會編輯 LaTeX 序言區、Typst 的 set 規則或 Markdown 的 front matter。
每種語言放置頁面設定的地方都不同:LaTeX 是類別選項和序言區命令,Typst 是 #set 規則,Markdown 是 front matter。文件設定 為這些語言提供同一份表單。你套用之後,Oleafly 會把變更寫進主檔案,成為你之後可以閱讀和編輯的一般原始碼。
請用編輯器工具列最右端的 文件設定 按鈕開啟它,或從 ⌘K(Ctrl+K)面板執行 文件設定。無論你開啟的是哪個檔案,這個對話方塊編輯的一律是專案的主文件。
表單有四個區段。欄位依引擎而定:
| 區段 | LaTeX | Typst | Markdown |
|---|---|---|---|
| 頁面 | 紙張大小、欄數、邊界 | 紙張大小、邊界、欄數 | 文件類型、文件類別、紙張大小、欄數、邊界 |
| 文字 | 內文字型、字型大小、語言 | 內文字型、字型大小、語言、地區 | 內文字型、字型大小、語言 |
| 段落 | 行距 | 對齊方式、行距 | 行距 |
| 編號 | 編號層級、公式編號 | 標題編號、公式編號 | 章節編號 |
清單以 預設 開頭,它會移除該設定,讓類別、範本或引擎的預設值再次生效。文字欄位留空也有同樣的效果。長度需要單位,例如 2.5cm、1in 或 11pt,Typst 的邊界也接受 auto。Oleafly 無法使用的值,會在欄位下方出現簡短的說明,而 套用 會等到你修正之後才可用。
內文字型 會在你輸入時建議字型。在 Typst 專案中,清單包含 Typst 能找到的每個字型,並說明各自的來源:專案的 fonts 資料夾、這台電腦,或 Typst 的內建集合。在 LaTeX 和 Markdown 專案中,它列出電腦上已安裝的字型。
選擇 套用 會寫入變更,選擇 取消 則不動檔案。當主檔案在編輯器中開啟時,按一次 ⌘Z(Ctrl+Z)就能復原整個變更。
值寫到哪裡
標題為「值寫到哪裡」的段落LaTeX
標題為「LaTeX」的段落- 紙張大小、欄數 和 字型大小 會成為
\documentclass的選項。 - 邊界 會寫入 geometry 套件。Oleafly 會編輯現有的
\geometry{…}或 geometry 選項,或加入\usepackage[margin=…]{geometry}。 - 內文字型 會寫入
\setmainfont{…}並載入 fontspec。在 latexmk 專案中,它需要 XeLaTeX 或 LuaLaTeX 編譯器,在你從編譯選單選好,或文件本身要求其中一個(例如用% !TeX program = xelatex這一行)之前,欄位會這麼說明。 - 語言 會把該語言加入 babel,在文件載入 polyglossia 時使用
\setdefaultlanguage,或加入\usepackage[language]{babel}。請使用 babel 的名稱,例如english。 - 行距 是 單倍、1.5 倍、雙倍,或像
1.5這樣的數字。它使用 setspace 套件,或在文件原本就是這麼寫時使用\linespread。 - 編號層級 會設定
secnumdepth。可選擇 無、僅限章,或編號深入到哪個層級,從 至節 到 至子段落。 - 公式編號 會為 依節、依章 或 依小節 寫入
\numberwithin{equation}{…}。
Typst
標題為「Typst」的段落值會寫入主檔案的 #set 規則。當規則不存在時,Oleafly 會把它加在靠近頂端的位置:
#set page(paper: …, margin: …, columns: …)#set text(font: …, size: …, lang: …, region: …)#set par(justify: …, leading: …),其中 對齊方式 是 左右對齊 或 靠左對齊#set heading(numbering: …),樣式如1.、1.1、1.a、I.或A.#set math.equation(numbering: …),可用(1)、(1.1)或1
語言 接受兩個或三個字母的代碼,例如 en,地區 則接受兩個字母的代碼,例如 GB。
Typst 專案還有一個 建置變體 區段。每個變體是一組具名的值,文件用 sys.inputs 讀取,例如草稿版和定稿版建置。使用 新增變體,為它命名,然後用 新增值 加入每個值。從編譯選單的 變體(本專案) 選擇要建置的變體。
Markdown
標題為「Markdown」的段落值會寫入 Pandoc 在建置 PDF 時讀取的 YAML front matter:type、documentclass、papersize、代表欄數的 classoption、代表邊界的 geometry、mainfont、fontsize、lang、linestretch 和 numbersections。文件類型 提供 文章、報告或學位論文、書籍、投影片、海報、信函 和 履歷,並決定文件會建置成什麼。請參閱文件類型。文件類別 提供 article、report、book、scrartcl、scrreprt 和 memoir。語言 接受像 en-US 這樣的標籤。
在你沒有設定字型的地方,Oleafly 會為文件中的每種文字(例如韓文、阿拉伯文或天城文)選擇一個字型。語言 也決定中文字元使用哪種字型:ja 使用日文字型,zh 使用簡體中文,zh-TW 使用繁體中文。請參閱其他語言的文字。
如果檔案還沒有 front matter,對話方塊會說明,而 套用 會在頂端加入一個區塊。沒有結尾 --- 行的 front matter,必須先手動修正。
唯讀欄位
標題為「唯讀欄位」的段落有些值屬於其他東西,對話方塊會把它們顯示成灰色,並在下方說明原因:
- 由 … 類別設定:
acmart、IEEEtran、llncs和beamer這類文件類別會固定自己的邊界,有些還會固定紙張大小、字型大小、欄數、行距或語言。對話方塊頂端的附註會指出是哪個類別。 - 由 … 樣式設定:NeurIPS、ICML、ICLR、CVPR 和 ACL 等會議的樣式套件會設定紙張大小和邊界。對話方塊頂端的附註會說明由哪個樣式負責。
- 原始碼中分別設定了各邊的邊界:文件分別給了左、右、上、下邊界,而不是單一的
margin值。 - 在條件區塊中設定:這個值位於
\if…程式碼之中,所以在這裡變更它可能破壞其中的邏輯。 - 由範本設定:在 Typst 中,存放該值的
#set規則帶有if條件,或像範本程式碼常見的那樣傳入..引數,所以對話方塊不去動它。 - 由原始碼中的運算式設定:這個值是計算出來的,而不是直接寫出來的,所以請改為編輯原始碼。
當 Typst 文件套用範本時,頂端的附註會說明範本內設定的值不會顯示,而你在這裡設定的值會覆寫範本。在 LaTeX 中,當序言區有一部分位於其他檔案時,也會出現類似的附註。