文档工具
文档设置
在一个对话框中更改纸张大小、页边距、字体、语言、行距和编号,它会编辑 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 中,如果导言区的一部分位于其他文件中,会出现类似的说明。