跳转到内容
Oleaflyv0.4.12

文档工具

在一个对话框中更改纸张大小、页边距、字体、语言、行距和编号,它会编辑 LaTeX 导言区、Typst 的 set 规则或 Markdown 的 front matter。

每种语言把页面设置放在不同的地方:LaTeX 中是文档类选项和导言区命令,Typst 中是 #set 规则,Markdown 中是 front matter。文档设置为它们提供同一个表单。你应用之后,Oleafly 会把更改作为普通源码写入你的主文件,你之后可以阅读和编辑。

用编辑器工具栏右端的文档设置按钮打开它,或在 ⌘K(Ctrl+K)面板中运行文档设置。无论你打开的是哪个文件,这个对话框始终编辑项目的主文档。

表单有四个部分。字段取决于引擎:

部分LaTeXTypstMarkdown
页面纸张大小、栏数、页边距纸张大小、页边距、栏数文档类型、文档类、纸张大小、栏数、页边距
文本正文字体、字号、语言正文字体、字号、语言、地区正文字体、字号、语言
段落行距对齐方式、行距行距
编号编号层级、公式编号标题编号、公式编号章节编号

列表以默认开头,选它会移除该设置,使文档类、模板或引擎的默认值重新生效。把文本字段留空也有同样的效果。长度需要带单位,比如 2.5cm、1in 或 11pt,Typst 的页边距还接受 auto。Oleafly 无法使用的值,会在字段下方显示一条简短的说明,在你修正之前,应用会一直等待。

正文字体会在你输入时给出字体建议。在 Typst 项目中,列表包含 Typst 能找到的所有字体,并说明每种字体的来源:项目的 fonts 文件夹、这台电脑,还是 Typst 的内置字体集。在 LaTeX 和 Markdown 项目中,它列出这台电脑上安装的字体。

选择应用来写入更改,或选择取消以保持文件不变。当主文件在编辑器中打开时,按一次 ⌘Z(Ctrl+Z)就能撤销整个更改。

  • 纸张大小、栏数和字号会成为 \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}{…}。

值会写入主文件的 #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 读取它们,例如草稿版和终稿版构建。使用添加变体,给它起个名字,然后用添加值逐个添加值。在编译菜单的变体(本项目) 中选择要构建的变体。

值会写入 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 中,如果导言区的一部分位于其他文件中,会出现类似的说明。

  • 宏包:添加其他 LaTeX 或 Typst 宏包
  • 编译:选择 XeLaTeX 或 LuaLaTeX,并选择 Typst 构建变体
  • 文档分析:查看文档包含什么
图片预览

无法加载 AI 回答

请重试,或搜索文档。