# 宏包与包

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

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

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

## LaTeX 宏包

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

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

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

每一行还有这些控件：

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

### 安装 LaTeX 宏包

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

- **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，编译找不到文件时，错误中会提供 **查找并安装**，它会找出该文件属于哪个宏包。参见[缺少文件时的恢复](/docs/latex-engines/#recover-from-a-missing-file)。

从 **重新编译** 旁边的箭头选择编译器。参见 [LaTeX 引擎](/docs/latex-engines/)。

## Typst 包

在 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 的项目中，这一部分会这样说明。

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

### 离线

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

## 相关页面

- [编辑器](/docs/editor/#the-editor-toolbar)：编辑器工具栏的其余部分
- [编译](/docs/compiling/)：构建期间如何获取包
- [文档设置](/docs/document-settings/)：不用编写包代码就能设置纸张大小、页边距和字体
