外观与主题

打开设置 → 外观。选择与你想修改的工作区部分对应的标签页。更改只在本地生效，不会改变导出文档的格式。

设置 → 外观 → 应用。在这里选择程序坞位置、背景、强调色、字体和主题。 打开完整截图

程序坞位置

在应用标签页中选择左侧、底部或右侧。这会移动主屏幕上包含新建项目、搜索、工具和设置的程序坞。想让项目库占满两侧边距之间的整个宽度时，可以试试底部。

背景图案

为项目库背景选择圆点、网格或无。选择无会让书架使用纯色背景；文档编辑器保留自己的主题。

强调色

选择一个色板，更改应用的选中色和操作强调色。这只会改变界面颜色；图中的颜色以及文档的 LaTeX 或 Typst 样式仍由你在源码中控制。

外观模式

在外观下选择浅色、深色或系统。系统会跟随你的操作系统，并在它变化时一起变化。主工具栏上的外观按钮是工作时切换的更快捷方式。编辑器会随之切换到你为该模式选择的主题。参见编辑器主题。

应用字体大小

用应用字体大小让界面中的所有文字变大或变小，范围是 13 到 20 px。章节标题、计数徽章和其他小标签会随之缩放。想要更大的源码文字，请改用编辑器字号，或开启使用应用字体。

缩放

缩放会让 Oleafly 中的一切变大或变小，包括编辑器和 PDF。可以选择 80% 到 200% 的级别。工作时，按 ⌘= 和 ⌘-（Windows 和 Linux 上为 Ctrl+= 和 Ctrl+-）来调整，按 ⌘0（Ctrl+0）回到 100%。所有 Oleafly 窗口使用同一个级别，Oleafly 会记住它。你可以在设置 → 键盘快捷键中更改这些按键。

应用字体

为菜单、面板和对话框选择电脑上安装的任意字体。列表中的每个名称都用它自己的字体显示。输入文字可搜索列表，也可以输入列表中没有显示的名称。Wingdings 之类的符号字体不在其中，因为它们会把每个字母变成图案。如果你保存的字体已不再安装，设置下方会有提示说明，Oleafly 会使用默认字体。

应用字体不会改变编译进 PDF 的字体。文档字体属于模板或稿件源码。

编辑器字号

设置 → 外观 → 编辑器。字体、主题、键位绑定、补全、括号和光标控件都在这个标签页中。 打开完整截图

打开编辑器标签页，选择 11 到 24 px 的字号，或选择自定义并输入 6 到 100 px 之间的任意大小。做屏幕共享演示时，可以试试 18 px 加上布局 → 仅编辑器，让工具栏和源码都保持清晰可读。

使用应用字体

开启使用应用字体，让编辑器使用应用标签页中的应用字体和应用字体大小。开启期间，编辑器自己的字体和字号控件会被锁定，它们的提示会说明原因。

编辑器字体

为源文件选择电脑上安装的任意字体。等宽字体排在列表前面，每个名称都用它自己的字体显示。输入文字可搜索，也可以输入列表中没有的名称。系统默认会回到应用默认的源码字体。该设置影响编辑器中的 .tex、.typ、.md 和其他文本文件。

编辑器主题

编辑器的浅色模式和深色模式各有一个主题。在浅色模式主题和深色模式主题下选择它们，应用切换模式时编辑器也会切换主题。跟随应用主题使用应用自己的浅色或深色配色。其他选项有 Linear、GitHub Dark、Dracula、Nord、Tokyo Night、Rosé Pine、Catppuccin、One Dark、Paper 和 One Light。Paper（偏暖的米白色）和 One Light 是两个浅色主题。

两个列表都接受任何主题，所以你可以在应用是浅色的同时保持深色编辑器。你在旧版本中选择的主题会同时用于两种模式，直到你更改其中一个。

编辑器颜色

打开编辑器颜色，可以更改编辑器主题的任何颜色。选择浅色模式或深色模式，编辑为该模式设置的主题。这些按钮旁边的文字会写明你正在编辑的主题。在它们下面，选择 LaTeX、Typst 或 Markdown，可以看到该语言的一小段示例。示例会实时显示你所做的更改。

颜色按角色分组，同一个角色在三种语言中含义相同：

分组	颜色
编辑器	背景色、文本、行号、选区
语法	命令、导言区和导入、标题、格式、环境、引用和交叉引用、公式、值和字符串、名称和键名、链接、括号和符号、注释

点击色板选择颜色。更改过的颜色会出现一个重置箭头，可恢复主题自己的颜色，重置则清除该主题的所有更改。Oleafly 会分别保存你对每个主题的更改，所以切换回去时它们仍在。跟随应用主题会为浅色模式和深色模式各保留一套。主题自定义下的导出主题会把你的编辑器主题和颜色与主题的其余部分一起保存。

键位绑定

选择源码编辑器使用的按键集：默认、Vim 或 Emacs。使用 Vim 时，按 i 进入插入模式，按 Esc 回到普通模式。更改立即生效，默认会回到普通的编辑器键位。参见 Vim 和 Emacs 按键。

制表符宽度

制表符宽度设定一级缩进插入多少个空格，以及制表符显示的宽度：2、4 或 8。默认是 4。

行高

为源码行之间的间距选择紧凑、标准或宽松，或选择自定义输入 1 到 3 之间的精确值。

字间距

字间距会在字符之间增加空间：+0.5、+1 或 +1.5 px，或最多 4 px 的自定义值。多出来的空间也会让光标周围更宽松。

光标宽度

让编辑器光标宽 1、2 或 3 px。

光标颜色

光标颜色为浅色编辑器主题和深色编辑器主题各提供一个色板，所以你在白色页面上选的颜色不会在深色主题下消失。在你选择颜色之前，每个色板显示的是主题自己的光标颜色。使用主题颜色会回到主题的颜色。Vim 的方块光标和 Markdown 可视模式下的插入符使用同一种颜色。

不闪烁光标

启用不闪烁光标，让编辑器插入符保持常亮。在阅读或演示源码时，这样可能更容易追踪插入点。

长行自动换行

长行默认会自动换行。关闭长行自动换行，改为左右滚动。

自动补全

启用自动补全，在输入时显示建议。关闭后，需要补全列表时按 Ctrl+Space。关于引用、命令、路径和符号，参见自动补全。

自动闭合括号

启用自动闭合括号，在你输入左括号时自动插入配对的右括号。试着在源文件中输入 (：光标会停在这一对括号之间，方便你输入内容。

自动闭合公式

启用自动闭合公式，在输入 $、\( 和 \[ 时自动配对。在 Typst 中，$ 配对需要同时开启这个开关和自动闭合括号。

自动闭合环境

启用自动闭合环境，在 \begin 行后按 Enter 时自动插入对应的 \end。

行内建议

启用行内建议，在光标后显示可能的补全内容。按 Tab 接受可见的建议。这是编辑器补全控件。连接模型是另一个步骤，在 AI 助手下进行。

粘性滚动

启用粘性滚动，在滚动时把当前的章节、标题和环境保持在源码窗格顶部。在很长的方法章节中使用它，可以保留周围的结构，而不必跳回标题。

公式预览

启用公式预览，在光标所在公式的上方显示渲染后的公式。参见公式预览。

移动文件时

重命名或移动文件后，源码中可能还留着使用旧名称的路径。移动文件时决定 Oleafly 如何处理它们。询问会列出这些路径，让你更新或保留；始终更新不经询问直接更改；从不更新则不去动它们。参见路径跟随被移动的文件。

Typst 格式化与提示

编辑器标签页末尾的 Typst 组包含保存时格式化、格式化行宽、格式化缩进、参数名称提示和 Typst lint 检查。代码智能逐一做了说明。

终端字体大小

设置 → 外观 → 终端。在这里设置文字、光标、启动行为和终端颜色。 打开完整截图

在终端标签页中，选择 shell 输入和输出的大小。分享命令演示之前可以调大它；它不影响文档编辑器。

终端字体

选择终端的等宽字体。阅读编译器路径和 shell 命令时，请使用标点清晰的字体。

常规字重

设置普通终端文字使用的字重。选择较粗的字重之前，先比较几行输出，在深色背景上尤其如此。

粗体字重

设置请求粗体文字的终端输出所用的字重。它可以与常规字重不同，让标题和命令诊断信息保持区分。

光标样式

从光标样式中选择终端光标的形状。该控件影响 shell 的插入符，不影响编辑器的插入符。

光标闪烁

启用光标闪烁，让终端插入符闪烁动画。关闭后，终端插入点保持稳定。

随项目启动 shell

启用随项目启动 shell，在打开项目时启动 shell。关闭后，shell 在你第一次显示终端时才启动。如果你很少需要使用命令行，请选后一种。

终端颜色主题

选择终端颜色主题，或让它跟随应用。打开一个有几行输出的终端，比较命令文字、错误信息和光标。

终端背景色

使用终端颜色下的背景色选择器来选择终端表面的颜色。搭配一个仍然清晰可读的前景色。

终端前景色

选择终端输出的默认文字颜色。程序仍然可以输出它们自己的 ANSI 颜色。

终端光标色

选择一个在背景和文字之间都醒目的光标颜色。当 shell 提示符包含多种颜色时，这很有用。

PDF 深色模式

设置 → 外观 → PDF 预览。在这里设置默认的 PDF 颜色和悬停预览。 打开完整截图

在 PDF 预览标签页中，启用 PDF 深色模式，默认反转预览颜色。这只改变显示，不改变导出的 PDF。你可以在 PDF 工具栏上为当前视图切换它。

只缩放 PDF

⌘= 和 ⌘-（Ctrl+= 和 Ctrl+-）会缩放整个应用，包括 PDF，即使焦点在 PDF 上也是如此。要只缩放 PDF，请使用预览工具栏上的缩放控件、在触控板上双指捏合，或按住 Ctrl 滚动。用缩放菜单可让页面适合宽度或高度。

悬停时预览 PDF

启用悬停时预览 PDF，当你把鼠标悬停在项目库中的某个项目上时，显示最近一次编译出的页面。请先编译一个文档，这样书架才有页面可以显示。

默认主页视图

设置 → 外观 → 项目。设置打开时的布局和文件树行为，然后管理隐藏文件的匹配模式。 打开完整截图

选择项目库以网格还是列表打开。网格突出封面和预览；列表则让项目名称更容易浏览。

项目打开方式

选择初始的源码、分屏或 PDF 视图。这是你进入项目时的起始布局。工作时可以用项目工具栏更改它。

打开时显示文件树

启用后，每个项目打开时都会同时打开资源管理器。关闭可以获得更多写作空间，需要文件时再打开资源管理器，即左侧栏的第一个标签页。

隐藏文件

输入文件名或匹配模式并选择添加，即可在资源管理器中隐藏匹配的条目。例如，隐藏一个会干扰稿件的辅助文件名。移除它的标签即可重新显示。隐藏文件不会删除它。

禅模式设置

项目标签页末尾的禅模式组有两个开关。进入全屏会在禅模式开启时铺满屏幕，并在你离开时还原窗口。编译时显示 PDF会在 PDF 被隐藏时，每次编译都在编辑器旁边打开 PDF。开启和关闭禅模式的按键在设置 → 键盘快捷键中。

主题自定义

在应用标签页底部，打开主题自定义，选择要编辑的浅色或深色模式，然后更改各个颜色令牌。点击令牌的颜色圆圈，即可在系统的取色器中选择颜色。两种模式各有独立的值，在你更改之前，每个色板显示该模式的默认颜色。更改之后，请检查文字、选区、面板和按钮。编辑器内部的颜色有自己的章节，编辑器颜色。

圆角半径

输入 CSS 长度，例如 8px、0.5rem 或 1em。清空该值则使用默认值。这会调整应用组件的圆角。

限定作用域的 CSS 声明

只输入声明，例如受支持的自定义属性值。该字段不接受完整的 CSS 规则、导入或 URL。无效的值会被报告，而不是被应用。

导入和导出主题

选择导出主题，保存一个可复用的主题文件。其中包含颜色令牌、圆角半径和限定作用域的 CSS，以及你的浅色和深色模式编辑器主题和编辑器颜色。导入主题会应用已保存的文件。用重置控件可以恢复自定义部分的默认值。

试试写作设置

把源码文字设为 16 px，启用粘性滚动，打开一个很长的 LaTeX 文档，然后选择布局 → 编辑器 + 预览。拖动分隔线，直到源码行读起来舒适为止。编译后在预览中选择适合宽度。把文档的排版保存在它的源码中；外观设置只用来调整你自己的阅读环境。

恢复默认设置

选择外观底部的恢复默认设置，恢复它的偏好设置。重置同时会清除主题自定义。按钮上的圆点表示外观中有内容与默认值不同。应用重置之前，请先确认提示。