# 文件設定

在對話方塊中變更紙張大小、邊界、字型、語言、行距和編號，它會編輯 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

- **紙張大小**、**欄數** 和 **字型大小** 會成為 `\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

值會寫入主檔案的 `#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

值會寫入 Pandoc 在建置 PDF 時讀取的 YAML front matter：`type`、`documentclass`、`papersize`、代表欄數的 `classoption`、代表邊界的 `geometry`、`mainfont`、`fontsize`、`lang`、`linestretch` 和 `numbersections`。**文件類型** 提供 **文章**、**報告或學位論文**、**書籍**、**投影片**、**海報**、**信函** 和 **履歷**，並決定文件會建置成什麼。請參閱[文件類型](/docs/writing/markdown/#document-types)。**文件類別** 提供 `article`、`report`、`book`、`scrartcl`、`scrreprt` 和 `memoir`。**語言** 接受像 `en-US` 這樣的標籤。

在你沒有設定字型的地方，Oleafly 會為文件中的每種文字（例如韓文、阿拉伯文或天城文）選擇一個字型。**語言** 也決定中文字元使用哪種字型：`ja` 使用日文字型，`zh` 使用簡體中文，`zh-TW` 使用繁體中文。請參閱[其他語言的文字](/docs/writing/markdown/#text-in-other-languages)。

如果檔案還沒有 front matter，對話方塊會說明，而 **套用** 會在頂端加入一個區塊。沒有結尾 `---` 行的 front matter，必須先手動修正。

## 唯讀欄位

有些值屬於其他東西，對話方塊會把它們顯示成灰色，並在下方說明原因：

- **由 … 類別設定**：`acmart`、`IEEEtran`、`llncs` 和 `beamer` 這類文件類別會固定自己的邊界，有些還會固定紙張大小、字型大小、欄數、行距或語言。對話方塊頂端的附註會指出是哪個類別。
- **由 … 樣式設定**：NeurIPS、ICML、ICLR、CVPR 和 ACL 等會議的樣式套件會設定紙張大小和邊界。對話方塊頂端的附註會說明由哪個樣式負責。
- **原始碼中分別設定了各邊的邊界**：文件分別給了左、右、上、下邊界，而不是單一的 `margin` 值。
- **在條件區塊中設定**：這個值位於 `\if…` 程式碼之中，所以在這裡變更它可能破壞其中的邏輯。
- **由範本設定**：在 Typst 中，存放該值的 `#set` 規則帶有 `if` 條件，或像範本程式碼常見的那樣傳入 `..` 引數，所以對話方塊不去動它。
- **由原始碼中的運算式設定**：這個值是計算出來的，而不是直接寫出來的，所以請改為編輯原始碼。

當 Typst 文件套用範本時，頂端的附註會說明範本內設定的值不會顯示，而你在這裡設定的值會覆寫範本。在 LaTeX 中，當序言區有一部分位於其他檔案時，也會出現類似的附註。

## 相關頁面

- [套件](/docs/packages/)：加入其他 LaTeX 或 Typst 套件
- [編譯](/docs/compiling/)：選擇 XeLaTeX 或 LuaLaTeX，並選擇 Typst 建置變體
- [文件分析](/docs/document-insights/)：查看文件包含什麼
