# 文档设置

在一个对话框中更改纸张大小、页边距、字体、语言、行距和编号，它会编辑 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/)：查看文档包含什么
