跳转到内容
Oleaflyv0.4.12

查找 Oleafly 最新的笔记、Markdown、引用、编辑器、Typst、图表、研究和代理功能的使用指南。

最新的更新加入了笔记(一项实验功能,用来把研究笔记保存为 Markdown 文件),并且让 Markdown 文档可以构建成图书、幻灯片、海报或信函。Quarto 网页现在会显示在预览中,在没有 TeX 的电脑上,引擎窗口会优先提供 TinyTeX。在此之前是每次编译后都保持最新的项目文件夹 PDF、在你已在使用的 CLI 代理上运行的工具、禅模式,以及输入时从 Zotero 引用文献。本页指向完整的说明,而不是重复一份发布说明清单。

笔记把研究笔记以 Markdown 文件的形式保存在你的电脑上。你在富文本编辑器中书写,可以使用标注、表格、统计图、图表、公式、链接,以及带截止日期的任务。它默认关闭,需要在设置 → 实验功能中开启笔记。笔记在可以拆分和停靠的标签页中打开,你可以通过搜索、标签、任务或日期再次找到它们。笔记可以放在项目里,也可以在协作服务器上与其他人一起写,助手或 CLI 代理可以提出修改建议,由你在笔记中接受或拒绝。快速记录会打开一个小窗口,让你在任何应用中都能记下想保留的念头。

开启笔记 · 在笔记中书写 · 查找并整理笔记 · 项目中的笔记与共享笔记 · 结合 AI 使用笔记

在 Markdown 文档的 front matter 中加上 type:,就可以把它构建成报告、图书、幻灯片、海报、信函或简历。幻灯片会构建成 16:9 的 Beamer 幻灯片,放映可以放映它,信函的地址取自 to 和 from。你自己写的 front matter 仍然优先。文档设置中的文档类型会替你写下这一行,LaTeX 导出和 oleafly build 也会遵循这个类型。

文档类型 · Markdown 的文档设置 · 放映幻灯片

构建网页的 Quarto 文档,例如 format: html 或 reveal.js 幻灯片,现在会把网页显示在预览窗格中。该网页无法访问 Oleafly 的其余部分。要在你自己的浏览器中打开它,请选择预览工具栏上的在浏览器中打开。

Quarto · 在浏览器中打开

当项目需要 latexmk,而这台电脑上没有可用的 TeX 时,引擎窗口现在会把下载 TinyTeX列在最前面,并标为推荐。下载并使用 TinyTeX会安装它并编译项目。若要继续使用内置引擎,请使用底部的继续使用 Tectonic卡片。

未安装 TeX 时 · 当 Tectonic 不够用时

PDF 预览中的保存按钮现在会打开一个菜单。在其中打开编译时同步 PDF,之后每次编译成功,Oleafly 都会在项目文件夹里刷新一个以项目标题命名的 PDF,例如 Thesis_Final_Draft.pdf。它是一个普通文件,所以云同步和检查点都会把它带上,而且 Oleafly 绝不会覆盖不是它创建的文件。要找回较早的 PDF,请打开某个检查点的文件,选择保存 PDF。

编译时同步 PDF · 从检查点保存 PDF

图片转 LaTeX、图片转 Typst、公式工具和扫描的 PDF 可以使用已连接的 CLI 代理,例如 Claude Code 或 Codex,凭你自己的登录即可,不需要 API 密钥。没有密钥时,论文审阅、行内编辑和用 AI 修复也会用这个代理。Antigravity CLI 现在是内置代理。

用代理代替 API 密钥 · 代理目录

任意文件夹里的 TeX,以及从镜像下载

标题为“任意文件夹里的 TeX,以及从镜像下载”的部分

设置 → 引擎 → LaTeX 中的选择 TeX 文件夹可以用安装在 Oleafly 不会查找的位置的 TeX 来编译。TinyTeX、Typst 和其他下载现在优先来自 Oleafly 的镜像。设置 → 下载 → 下载源可以改用原始站点或你自己的镜像,并设置 TeX 宏包的下载仓库。TinyTeX 的下载可以取消,也可以继续。

latexmk 与系统 TeX · 下载源标签页 · 安装和更新 TinyTeX

TeX 会跳过所用字体无法显示的字符,却仍然报告成功,所以一段中文、日文或韩文可能会变成空白。现在你会收到提示,日志会列出缺失的字符,并给出每种文字的设置方法,所用字体随内置引擎一起提供。

PDF 中缺失的字符

会先思考再作答的 Ollama 和 Lemonade 模型,现在在强度菜单中提供无。简单的请求选它,回复会快得多。

跳过思考步骤

中日韩编辑器字体,以及按名称使用下载的字体

标题为“中日韩编辑器字体,以及按名称使用下载的字体”的部分

中日韩字体设置让中文、日文和韩文字符在编辑器中使用自己的字体,与你的编程字体并存。下载的 Lato、PT Sans 和 PT Serif 可以按名称使用:Typst 能找到它们,添加到项目会把其中一个复制到 LaTeX 项目中。

中日韩字体 · 向项目添加字体

在 LaTeX、Typst 或 Markdown 文件中输入 @,你的整个 Zotero 文库就会与项目自己的参考文献一起显示。选择一篇论文会插入引用,并且只把这一条目添加到项目的 .bib 中。之后,从 Zotero 添加和从 Zotero 更新会让该文件与你的文库保持同步。它可以配合在同一台电脑上打开的 Zotero 7 使用,也可以配合 zotero.org 账户使用。

从你的 Zotero 文库中引用 · 连接 Zotero

为浅色模式选一个编辑器主题,为深色模式再选一个,编辑器就会随应用切换。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。应用和编辑器的字体可以是你电脑上安装的任何字体。编辑器还新增了行高、字间距以及光标宽度和颜色的设置。

外观与主题 · 键盘快捷键

当 Tectonic 无法构建文档时,引擎对话框会自动打开,并可以将项目迁移到你的系统 LaTeX。编辑器上方的横幅会为 minted、PythonTeX 和 \write18 提供允许外部命令。在 Linux 上,Oleafly 现在绘制自己的标题栏,并接受从文件管理器拖入的文件。

当 Tectonic 不够用时 · 允许外部命令 · 在 Linux 上安装

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,并提供可选的演讲者视图,显示下一页幻灯片、计时器和你的备注。

放映幻灯片

主屏幕上的项目搜索支持 engine:typst、is:bookmarked 和 created:>@today-1w 这样的限定词,还支持 AND、OR、括号和排序。输入时会出现建议,高级筛选编辑的是同一段文本。

搜索你的项目

可以将你的整个 Zotero 文库导入项目的参考文献,并连接 alphaXiv,让助手能从中搜索和阅读论文。

Zotero、alphaXiv

设置中的每个 CLI 代理都会显示 Oleafly 找到的程序,测试会在保存任何内容之前运行它。代理更改文件后,你可以审阅每一处更改,并撤销或重做。代理主页还提供研究起点,例如文献梳理或引用审计。

设置 CLI 代理 · 审阅并撤销更改 · 研究起点

在设置中输入“主题”“Zotero”或“拼写”之类的词即可跳转。重置按钮上的圆点表示该部分中有内容与默认值不同,文件路径在你指向它们之前会保持模糊。

设置

可选的 LaTeX 工具图库现在包含 47 个专注的工具,其中有十个 Typst 转换器。你可以在 LaTeX、Typst、Markdown、Word、HTML、PDF、图片、电子表格和 Mermaid 图表之间转换文档;构建并验证参考文献;搜索论文、实验室和截止日期;进行统计计算;以及使用小型写作辅助工具。

每个工具现在都有自己的页面,介绍它的输入、步骤、示例、隐私行为、限制,以及该工具不适用时更合适的途径。

双窗格工具有一条可拖动、支持键盘操作的分隔条。每个工具都会记住自己在桌面端的分栏位置,而窄窗口会把输入和结果上下堆叠。

浏览全部 47 个工具

校对现在在 LaTeX、Typst 和 Markdown 中把拼写检查与 Harper 的语法和风格检查结合起来。它会跳过不应被当作正文的源码语法,然后让你替换某个发现的问题,或暂时忽略、仅在一个项目中忽略、在所有地方都忽略。学术配置文件增加了适合研究写作的检查,你还可以在某个发现的问题上禁用单条 Harper 规则。

设置校对和学术风格

编辑器可以让数学定界符、括号和环境成对出现;延续列表;关闭当前环境;并补全感知宏包的命令、交叉引用、引用和项目路径。单独的设置让你开启或关闭自动补全、括号、数学或环境闭合。

使用自动补全和结构化输入 · 了解编辑器

引用的插入遵循文档所声明的参考文献库,包括常见的 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 种语言之一,从简体中文和日本語到 Deutsch 和 Español。界面会立即改变,无需重启。此设置控制应用的标签和消息。文档语言、校对词典和助手输出仍是独立的选择。

更改应用语言

预检把编译、版面、参考文献、资源、盲审、ATS 和无障碍方面的发现汇集在一处。它的 PDF/UA 部分检查一组明确定义的、可由机器测试的子集,它的带标签 PDF 工作流则让兼容的 LaTeX 项目为 LuaLaTeX 做好准备。指南解释了哪些结果是确定的、哪些是启发式的,以及为什么一次无问题的运行并不等于正式的 PDF/UA 认证。

运行预检并准备带标签的 PDF

当 latexmk 构建报告缺少某个 TeX 文件时,Oleafly 可以找到包含它的 TeX Live 宏包,安装该宏包,然后重新编译。宏包管理器还可以搜索完整的 TeX Live 目录,并显示某个宏包位于系统目录树还是个人目录树。

选择 LaTeX 引擎并管理宏包

设置 → 帮助与关于现在带有一条可直接复制的 Oleafly BibTeX 条目。在已打开的项目中,在本文中引用 Oleafly 可以把该条目添加到文档所使用的参考文献库。

复制或插入 Oleafly 的引用

请在 GitHub Releases (在新标签页中打开) 上阅读逐版本的更改。在应用中,打开设置 → 帮助与关于检查更新。应用更新介绍了更新流程。

图片预览

无法加载 AI 回答

请重试,或搜索文档。