跳转到内容
Oleaflyv0.4.12

文档工具

在 CTAN 中搜索 LaTeX 宏包,在 Typst Universe 中搜索 Typst 包,然后从编辑器工具栏把其中一个添加到你的文档。

LaTeX 和 Typst 文档的大部分额外功能来自宏包或包。编辑器工具栏右端的包按钮会打开一个针对项目语言的可搜索列表,并替你写出加载某个包的那一行。Markdown 项目没有包按钮。

你也可以从 ⌘K 面板用 浏览 LaTeX 宏包 或 浏览 Typst 包 打开该列表。

在 LaTeX 项目中,选择 LaTeX 宏包。可以按宏包名称或说明在 CTAN 中搜索。如果无法连接 CTAN,或者你处于离线状态,对话框会这样提示,并改为显示 Oleafly 内置的列表。无法刷新的列表会显示它的下载日期。

每一行可以显示这些标签:

  • 已在文档中:主文件已经加载了这个宏包。
  • 文档类:这一项是文档类,而不是宏包。文档类通过 \documentclass 设置,所以这一行允许你复制那一行,但不能添加它。
  • 已安装:你的 TeX 发行版已经有这个宏包。

每一行还有这些控件:

  • 选项,一个用于填写宏包选项的字段,例如 margin=2cm。花括号必须匹配,不能使用 ] 或 %。
  • 添加到导言区,会把 \usepackage[options]{name} 写入主文件的导言区。如果文件已经加载了该宏包,就不会有任何改动,对话框会告诉你。
  • 复制此行,复制同样的 \usepackage 这一行;对于文档类,则复制 \documentclass 这一行。
  • CTAN,打开该宏包在 CTAN 上的页面。
  • 安装,用于你的 TeX 发行版缺少的宏包。见下文。

“已安装”的含义取决于项目如何编译:

  • Tectonic(内置编译器)会在文档第一次使用某个宏包时下载它。没有什么需要安装的,对话框顶部也这样说明。
  • 使用 TeX Live 或 TinyTeX 的 latexmk:当你的 TeX 发行版有 tlmgr 时,Oleafly 会检查你有哪些宏包,把它们标为 已安装,并对其余的提供 安装。安装会针对那一个宏包运行 tlmgr。
  • 来自 Debian、Ubuntu 或 Fedora 的 TeX Live:它由系统的包管理器管理,所以对话框会说明要用 apt 或 dnf 安装宏包,并且没有 安装 按钮。
  • 其他 TeX 环境,例如 MiKTeX:Oleafly 无法判断有哪些宏包,所以各行不显示安装状态。MiKTeX 请使用 MiKTeX Console。

对于 TeX Live 或 TinyTeX,编译找不到文件时,错误中会提供 查找并安装,它会找出该文件属于哪个宏包。参见缺少文件时的恢复。

从 重新编译 旁边的箭头选择编译器。参见 LaTeX 引擎。

在 Typst 项目中,选择 Typst 包 来浏览 Typst Universe。可以按名称、关键词或类别搜索,也可以用类别标签缩小列表。对话框一次最多显示 100 个包,所以列表很长时请使用搜索。

每一行显示包名称、它的最新版本、模板包的 模板 徽章,以及一段简短的说明。当某个包需要比项目所用的更新的 Typst 时,这一行会说明它需要哪个版本。

  • 插入 import 会把 #import "@preview/name:version": * 添加到打开的 .typ 文件顶部的各个导入之后。如果文件已经导入了该包,只会改变版本号。编辑器中必须打开着一个 Typst 文件。
  • 复制 import 复制同样的这一行。

当你文件中的某个 @preview 导入比 Typst Universe 上的最新发布版本旧时,编辑器会在版本号上标出提示,例如“cetz 0.4.2 已发布。此 import 使用的是 0.3.4。”提示中的 更新到 0.4.2 操作会就地修改这个数字。

Typst 在项目第一次导入包时,会把包下载到共享缓存中。要让项目自带这些包的副本,请使用对话框底部的 项目包:

  • 使用项目文件夹中的包 让 Typst 先在项目的 typst-packages 文件夹中查找。这样设置的项目可以离线编译,也能在其他电脑上编译。
  • 将包复制到项目 把项目导入的每个包从缓存复制到 typst-packages。如果某个包还不在缓存中,请联网编译一次,然后再次复制。

两者都需要 Typst 0.12 或更新版本。在固定为 Typst 0.11 的项目中,这一部分会这样说明。

这一部分还会显示项目保存了多少个包。

开启离线模式时,对话框使用它上次下载的包列表,并显示其日期。如果从未下载过列表,那么在你联网之前它无法显示。

  • 编辑器:编辑器工具栏的其余部分
  • 编译:构建期间如何获取包
  • 文档设置:不用编写包代码就能设置纸张大小、页边距和字体
图片预览

无法加载 AI 回答

请重试,或搜索文档。