Инструменты документа
Пакеты
Ищите пакеты LaTeX в CTAN и пакеты Typst в Typst Universe, затем добавляйте нужный в документ прямо с панели инструментов редактора.
Документы LaTeX и Typst получают большую часть дополнительных возможностей из пакетов. Кнопка пакетов в правом конце панели инструментов редактора открывает список с поиском для языка проекта и записывает строку, подключающую пакет. В проектах Markdown кнопки пакетов нет.
Список также можно открыть из палитры ⌘K командами Обзор пакетов LaTeX или Обзор пакетов Typst.
Пакеты LaTeX
Заголовок раздела «Пакеты LaTeX»В проекте LaTeX выберите Пакеты LaTeX. Выполняйте в CTAN поиск по имени или описанию пакета. Если CTAN недоступен или вы офлайн, диалог сообщит об этом и покажет встроенный список Oleafly. Для списка, который не удалось обновить, показывается дата его скачивания.
В каждой строке могут встречаться такие метки:
- В документе: главный файл уже подключает этот пакет.
- Класс документа: запись является классом, а не пакетом. Классы задаются командой
\documentclass, поэтому строка позволяет скопировать эту команду, но не добавить её. - Установлен: пакет уже есть в вашем дистрибутиве TeX.
В каждой строке есть и такие элементы управления:
- Параметры — поле для параметров пакета, например
margin=2cm. Фигурные скобки должны быть парными, а символы]и%использовать нельзя. - Добавить в преамбулу — записывает
\usepackage[options]{name}в преамбулу главного файла. Если файл уже подключает пакет, ничего не изменится, и диалог сообщит вам об этом. - Копировать строку — копирует ту же строку
\usepackageили строку\documentclassдля класса. - CTAN — открывает страницу пакета на CTAN.
- Установить — для пакета, которого нет в вашем дистрибутиве TeX. См. ниже.
Установка пакетов LaTeX
Заголовок раздела «Установка пакетов 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 компиляция, не нашедшая файл, предлагает в сообщении об ошибке Найти и установить, что определяет, какому пакету принадлежит файл. См. Восстановление после отсутствующего файла.
Выберите компилятор в меню со стрелкой рядом с кнопкой Скомпилировать заново. См. Движки LaTeX.
Пакеты Typst
Заголовок раздела «Пакеты 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, раздел сообщает об этом.
В этом разделе также показано, сколько пакетов хранит проект.
При включённом офлайн-режиме диалог использует список пакетов, скачанный в прошлый раз, и показывает его дату. Если список ещё ни разу не скачивался, диалог не сможет его показать, пока вы не подключитесь к сети.
Связанные страницы
Заголовок раздела «Связанные страницы»- Редактор: остальные элементы панели инструментов редактора
- Компиляция: как пакеты загружаются во время сборки
- Настройки документа: размер бумаги, поля и шрифты без написания кода пакетов