# Пакеты

Ищите пакеты LaTeX в CTAN и пакеты Typst в Typst Universe, затем добавляйте нужный в документ прямо с панели инструментов редактора.

Документы 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** — встроенный компилятор — скачивает пакет при первом использовании его в документе. Устанавливать ничего не нужно, о чём диалог сообщит вверху.
- **latexmk с TeX Live или TinyTeX**: если в вашем дистрибутиве TeX есть `tlmgr`, Oleafly проверяет, какие пакеты у вас есть, помечает их **Установлен** и предлагает **Установить** для остальных. Установка запускает `tlmgr` для одного этого пакета.
- **TeX Live из Debian, Ubuntu или Fedora**: им владеет системный менеджер пакетов, поэтому диалог предлагает устанавливать пакеты через `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 "@preview/name:version": *` после импортов в начале открытого файла `.typ`. Если файл уже импортирует этот пакет, изменится только номер версии. В редакторе должен быть открыт файл Typst.
- **Копировать импорт** копирует ту же строку.

### Подсказки об обновлениях

Когда импорт `@preview` в вашем файле старее последнего выпуска на Typst Universe, редактор помечает версию подсказкой вида «Доступен cetz 0.4.2. Этот импорт использует 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/): размер бумаги, поля и шрифты без написания кода пакетов
