跳转到内容
Oleaflyv0.4.12

在 macOS、Windows 或 Linux 上安装 Oleafly,并了解应用在首次使用时可能下载哪些内容。

安装 Oleafly 只需下载并双击。无需账号,无需登录,也不需要单独的 LaTeX 发行版:编译器就内置在应用里。

从发布页 (在新标签页中打开)获取最新的安装包,或使用 oleafly.com 上的下载按钮,它会尽可能为你的平台选好安装包。

平台下载怎么做
macOS(Apple Silicon)_aarch64.dmgM1 或更新的芯片。打开 dmg,把 Oleafly 拖到“应用程序”。
macOS(Intel)_x64.dmgIntel 版 Mac。打开 dmg,把 Oleafly 拖到“应用程序”。
Windows(x86_64).msi 或 -setup.exe运行任一安装程序,并按提示操作。
Linux(x86_64).AppImage、.deb 或 .rpm大多数发行版使用 AppImage,基于 Debian 的系统使用 Debian 软件包,Fedora 上使用 RPM。
Linux(ARM64).AppImage、.deb 或 .rpm适用于 ARM64 Linux 系统的原生软件包。

在 Linux 上,Oleafly 需要 glibc 2.35 或更新版本(2022 年及以后的发行版:Ubuntu 22.04+、Fedora 36+、Debian 12+)。

不确定自己的 Mac 是哪一种?打开苹果菜单,选择 关于本机。如果看到 芯片 一行,就是 Apple Silicon;如果 处理器 一行写着 Intel,就是 Intel 版 Mac。

目前发布的目标是 macOS Apple Silicon、macOS Intel、Windows x64、Linux x64 和 Linux ARM64。Windows on ARM 暂时还没有原生安装包。

打开磁盘映像,把 Oleafly 拖到“应用程序”,然后启动它。请使用官方安装包。如果 macOS 阻止了它,请在 系统设置 → 隐私与安全性 中查看首次启动的提示。

运行 MSI 或 setup 可执行文件,并按安装程序操作。如果 Windows 显示信誉警告,请先确认下载来自官方发布,再继续。安装程序会把 Typst 和 LaTeX 语言服务器所需的 Microsoft Visual C++ 运行库文件放在应用旁边,所以你不必另外安装它。

用包管理器安装 Debian 或 RPM 软件包,或者给 AppImage 添加可执行权限并打开它:

终端窗口
chmod +x Oleafly_*.AppImage
./Oleafly_*.AppImage

Oleafly 需要 glibc 2.35 或更新版本。请选择与你电脑架构相符的软件包。

.deb 和 .rpm 软件包把 Oleafly 自带的 Tectonic、Pandoc 和 Typst 放在 /usr/libexec/oleafly 中,所以它们可以与你的发行版自带的 Pandoc 并存安装。启动 AppImage 时,它会把自己添加到你的应用菜单中,GNOME 这类 Wayland 桌面需要先有这个菜单项,才会在 Dock 中显示它的图标。如果已安装的软件包或其他工具已经添加了 Oleafly,它就不会改动菜单;如果你删除了这个条目,它也会保持被删除的状态。

Debian 软件包带有说明,所以 Ubuntu 的应用中心在你安装之前就会显示 Oleafly 是什么。它还附带 AppStream 数据,所以安装 Oleafly 之后,软件中心会显示图标、许可证、截图和版本。应用会出现在你的应用菜单的“办公”类别下。在 Linux 上和在 Windows 上一样,Oleafly 绘制自己的标题栏。它的工具栏位于顶部,带有最小化、最大化和关闭按钮。拖动工具栏可以移动窗口,双击可以最大化,拖动任意边缘或角落可以调整大小。

第一次在内置的 Tectonic 引擎上编译文档时,它会下载该文档所需的宏包并缓存起来。一台电脑上的首次编译还会一次性获取一批常用宏包,所以之后的文档启动得更快。这需要网络连接,网速慢时可能要花上几分钟。宏包仍在陆续到达时,编译的时间限制会等待;如果 Oleafly 的宏包镜像失败,编译会回退到上游来源。之后同一份文档的编译很快,而且可以离线进行。如果文档需要某个你尚未缓存的宏包,会再触发一次性的获取。参见编译,其中包括严格离线模式。

Tectonic 能处理大多数文档。当项目需要 pdfLaTeX、upLaTeX 或完整 TeX 发行版中的其他编译器时,Oleafly 会使用你电脑上已有的 MacTeX、TeX Live、MiKTeX 或 TinyTeX。如果没有,它可以从 设置 → 引擎 → LaTeX 为你安装 TinyTeX,也可以直接从编译错误中安装。TinyTeX 不需要管理员权限,下载大小约 250 MB,Oleafly 要求约 2 GB 的可用磁盘空间。

  • 在 Linux 上,TinyTeX 使用系统的 Perl。如果缺少,请先安装:sudo apt install perl、sudo dnf install perl 或 sudo pacman -S perl。
  • 在 Windows 上,MiKTeX 需要 Perl 才能运行 latexmk。请安装 Strawberry Perl,或安装自带 Perl 的 TinyTeX。
  • 在 Debian、Ubuntu 和 Fedora 上,用 apt 或 dnf 安装的 TeX Live,其 LaTeX 宏包也来自 apt 或 dnf。Oleafly 会告诉你该安装什么,但不会改动它。

请参阅 LaTeX 引擎与宏包。

你的文件仍是磁盘上的普通文件夹。令牌和 AI 密钥保存在加密的、仅限所有者访问的本地文件中。在线功能包括托管的 AI、GitHub 同步、宏包下载、引用查询和更新检查。参见理念。

Oleafly 会检查带签名的发布源,显示发布说明,并在你确认后就地安装。在 Linux 上,自动替换适用于 AppImage 安装。你也可以从 设置 → 帮助与关于 检查。参见更新。

先决条件、引擎下载和本地构建,请参阅桌面端开发指南 (在新标签页中打开)。

  • 快速入门:几分钟内从第一个项目到第一份 PDF。
  • 模板:内置的起始模板和可下载的模板包。
  • Oleafly Learn:网上免费的 LaTeX 和研究写作课程。
  • 命令行工具:在终端中构建、检查和同步项目,并连接编程代理。
图片预览

无法加载 AI 回答

请重试,或搜索文档。