新功能
查找 Oleafly 最新的引用、编辑器、Typst、图表、研究和代理功能的使用指南。
最新的更新加入了禅模式,并支持在输入时引用 Zotero 文献。编辑器还新增了一个浅色模式主题和一个深色模式主题,颜色可以自行更改。在此之前,Typst 追上了 LaTeX,每种引擎都拥有了相同的文档工具,CLI 代理也变得更容易设置和检查。本页指向完整的说明,而不是重复一份发布说明清单。
写作时引用 Zotero 文献
标题为“写作时引用 Zotero 文献”的部分在 LaTeX、Typst 或 Markdown 文件中输入 @,你的整个 Zotero 文库就会与项目自己的参考文献一起显示。选择一篇论文会插入引用,并且只把这一条目添加到项目的 .bib 中。之后,从 Zotero 添加和从 Zotero 更新会让该文件与你的文库保持同步。它可以配合在同一台电脑上打开的 Zotero 7 使用,也可以配合 zotero.org 账户使用。
编辑器主题和颜色
标题为“编辑器主题和颜色”的部分为浅色模式选一个编辑器主题,为深色模式再选一个,编辑器就会随应用切换。Paper(一种偏暖的米白色)和 One Light 是新增的主题。编辑器颜色可以更改主题的任何颜色,并在 LaTeX、Typst 和 Markdown 中实时预览。颜色按角色分组,所以标题、引用或公式在这三种语言中的颜色相同。
禅模式
标题为“禅模式”的部分按 Ctrl+⌘⇧F(Windows 和 Linux 上为 Shift+F11)可隐藏工具栏、侧边栏、助手和终端。只剩下编辑器,角落里有一个编译按钮。连按两次 Esc 可恢复所有内容。
路径随重命名和移动的文件而更新
标题为“路径随重命名和移动的文件而更新”的部分重命名文件或把它拖到另一个文件夹后,指向它的 \input、\includegraphics、#include、image() 和 Markdown 链接也会随之更改。除非你设为始终更新或从不更新,否则 Oleafly 会先询问。
默认编译引擎适用于每个新的 LaTeX 项目
标题为“默认编译引擎适用于每个新的 LaTeX 项目”的部分你在设置 → 引擎 → LaTeX 下选择的引擎,现在适用于新项目、导入、转换后的文档,以及你就地打开的受信任文件夹。在那里选择 latexmk,新项目从一开始就会使用你自己的 TeX 安装来编译。
缩放、字体和新快捷键
标题为“缩放、字体和新快捷键”的部分⌘= 和 ⌘- 缩放整个应用,⌘, 打开设置,⌘⌥P 显示或隐藏 PDF。应用和编辑器的字体可以是你电脑上安装的任何字体。编辑器还新增了行高、字间距以及光标宽度和颜色的设置。
系统 LaTeX 与外部命令
标题为“系统 LaTeX 与外部命令”的部分当 Tectonic 无法构建文档时,引擎对话框会自动打开,并可以将项目迁移到你的系统 LaTeX。编辑器上方的横幅会为 minted、PythonTeX 和 \write18 提供允许外部命令。在 Linux 上,Oleafly 现在绘制自己的标题栏,并接受从文件管理器拖入的文件。
当 Tectonic 不够用时 · 允许外部命令 · 在 Linux 上安装
Typst,与 LaTeX 同样完整
标题为“Typst,与 LaTeX 同样完整”的部分Typst 项目现在拥有 LaTeX 项目曾有的一切,还有一些自己独有的功能。可以为每个项目选择 Typst 版本,从 0.11 到 0.15,Oleafly 会下载该版本,并对照已发布的校验和进行检查。包来自 Typst Universe,也可以放在项目内部,使其离线编译。项目自己的字体、构建变体和可复现构建,对 Typst 和语言服务器都有效。
在编辑器中,Typst 获得了可视化模式、折叠、粘性标题,对函数、路径、标签和包的补全,重命名和格式化文档。它还获得了 LaTeX 所拥有的图形、表格、引用和公式工具。跳转到 PDF 和在 PDF 中点击,可以在源码和页面之间跳转。导出包括 PNG、SVG、HTML、PDF/A 和 PDF/UA,预检也会检查 Typst 源文件。
设置 Typst 项目 · 用 Typst 写作 · 将 LaTeX 项目转换为 Typst
每种引擎都有宏包、文档设置和文档分析
标题为“每种引擎都有宏包、文档设置和文档分析”的部分编辑器工具栏上的三个按钮,现在在 LaTeX、Typst 和 Markdown 中(适用之处)的工作方式相同:
- 宏包在 LaTeX 中搜索 CTAN,在 Typst 中搜索 Typst Universe,并添加加载包的那一行。
- 文档设置更改纸张大小、页边距、字体、语言、行距和编号。它会替你编辑导言区、
#set规则或前置元数据。 - 文档分析列出文档中的图形、表格、公式、标签、引用和 TODO,并复制其投稿元数据。
一个图表编排器,支持 TikZ、Typst 和 Mermaid
标题为“一个图表编排器,支持 TikZ、Typst 和 Mermaid”的部分图表编排器现在会询问图表使用哪种语言:LaTeX 用 TikZ,Typst 用 fletcher 图表,Markdown 用 Mermaid 流程图。三者共用同一块画布,代码和图形在两个方向上保持同步。文档工具栏上的绘制图表会跳过这个问题,直接使用该文档的语言。插入 Markdown 的 Mermaid 图表也会出现在编译后的 PDF 中。
用 PDF 放映幻灯片
标题为“用 PDF 放映幻灯片”的部分可以全屏放映任何已编译的 PDF,并提供可选的演讲者视图,显示下一页幻灯片、计时器和你的备注。
像搜索 GitHub issue 一样搜索你的文库
标题为“像搜索 GitHub issue 一样搜索你的文库”的部分主屏幕上的项目搜索支持 engine:typst、is:bookmarked 和 created:>@today-1w 这样的限定词,还支持 AND、OR、括号和排序。输入时会出现建议,高级筛选编辑的是同一段文本。
Zotero 与 alphaXiv
标题为“Zotero 与 alphaXiv”的部分可以将你的整个 Zotero 文库导入项目的参考文献,并连接 alphaXiv,让助手能从中搜索和阅读论文。
可检查、可撤销的 CLI 代理
标题为“可检查、可撤销的 CLI 代理”的部分设置中的每个 CLI 代理都会显示 Oleafly 找到的程序,测试会在保存任何内容之前运行它。代理更改文件后,你可以审阅每一处更改,并撤销或重做。代理主页还提供研究起点,例如文献梳理或引用审计。
可搜索的设置
标题为“可搜索的设置”的部分在设置中输入“主题”“Zotero”或“拼写”之类的词即可跳转。重置按钮上的圆点表示该部分中有内容与默认值不同,文件路径在你指向它们之前会保持模糊。
每个 Oleafly 工具都有一份指南
标题为“每个 Oleafly 工具都有一份指南”的部分可选的 LaTeX 工具图库现在包含 47 个专注的工具,其中有十个 Typst 转换器。你可以在 LaTeX、Typst、Markdown、Word、HTML、PDF、图片、电子表格和 Mermaid 图表之间转换文档;构建并验证参考文献;搜索论文、实验室和截止日期;进行统计计算;以及使用小型写作辅助工具。
每个工具现在都有自己的页面,介绍它的输入、步骤、示例、隐私行为、限制,以及该工具不适用时更合适的途径。
双窗格工具有一条可拖动、支持键盘操作的分隔条。每个工具都会记住自己在桌面端的分栏位置,而窄窗口会把输入和结果上下堆叠。
懂得源文件的校对
标题为“懂得源文件的校对”的部分校对现在在 LaTeX、Typst 和 Markdown 中把拼写检查与 Harper 的语法和风格检查结合起来。它会跳过不应被当作正文的源码语法,然后让你替换某个发现的问题,或暂时忽略、仅在一个项目中忽略、在所有地方都忽略。学术配置文件增加了适合研究写作的检查,你还可以在某个发现的问题上禁用单条 Harper 规则。
更快的 LaTeX 编辑
标题为“更快的 LaTeX 编辑”的部分编辑器可以让数学定界符、括号和环境成对出现;延续列表;关闭当前环境;并补全感知宏包的命令、交叉引用、引用和项目路径。单独的设置让你开启或关闭自动补全、括号、数学或环境闭合。
更可靠的参考文献
标题为“更可靠的参考文献”的部分引用的插入遵循文档所声明的参考文献库,包括常见的 BibTeX 和 Biber 配置。文库导入接受 BibTeX、RIS、EndNote XML 和 Zotero RDF。参考文献清理器会在更改文件之前预览规范化后的键和重复项,在键变化时更新引用,并保存备份。新的独立工具涵盖 DOI、arXiv、ISBN、PubMed、URL、格式化引用和八种引用样式。
跨写作格式的导入与导出
标题为“跨写作格式的导入与导出”的部分Word 和 HTML 文档可以变成 LaTeX、Markdown 或 Typst 项目。Markdown 可以变成 LaTeX 或 Typst,Typst 可以变成 LaTeX 或 Markdown。已打开的项目可以将其受支持的路径导出为 Word、带 MathML 的 HTML、Markdown、Typst、LaTeX、纯文本、PDF、源码 ZIP 或页面图像。LaTeX 演示文稿和书籍还可以导出为 PowerPoint 或 EPUB。Markdown 项目两者都支持,Typst 项目支持 EPUB。
21 种语言的界面
标题为“21 种语言的界面”的部分在设置 → 通用 → 语言下选择系统或 21 种语言之一,从简体中文和日本語到 Deutsch 和 Español。界面会立即改变,无需重启。此设置控制应用的标签和消息。文档语言、校对词典和助手输出仍是独立的选择。
PDF 无障碍与投稿检查
标题为“PDF 无障碍与投稿检查”的部分预检把编译、版面、参考文献、资源、盲审、ATS 和无障碍方面的发现汇集在一处。它的 PDF/UA 部分检查一组明确定义的、可由机器测试的子集,它的带标签 PDF 工作流则让兼容的 LaTeX 项目为 LuaLaTeX 做好准备。指南解释了哪些结果是确定的、哪些是启发式的,以及为什么一次无问题的运行并不等于正式的 PDF/UA 认证。
TeX 宏包恢复
标题为“TeX 宏包恢复”的部分当 latexmk 构建报告缺少某个 TeX 文件时,Oleafly 可以找到包含它的 TeX Live 宏包,安装该宏包,然后重新编译。宏包管理器还可以搜索完整的 TeX Live 目录,并显示某个宏包位于系统目录树还是个人目录树。
更方便地引用软件
标题为“更方便地引用软件”的部分设置 → 帮助与关于现在带有一条可直接复制的 Oleafly BibTeX 条目。在已打开的项目中,在本文中引用 Oleafly 可以把该条目添加到文档所使用的参考文献库。
发布说明与更新
标题为“发布说明与更新”的部分请在 GitHub Releases (在新标签页中打开) 上阅读逐版本的更改。在应用中,打开设置 → 帮助与关于检查更新。应用更新介绍了更新流程。