Перейти к содержимому
Oleaflyv0.4.12

Инструменты документа

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

Документы LaTeX и Typst получают большую часть дополнительных возможностей из пакетов. Кнопка пакетов в правом конце панели инструментов редактора открывает список с поиском для языка проекта и записывает строку, подключающую пакет. В проектах Markdown кнопки пакетов нет.

Список также можно открыть из палитры ⌘K командами Обзор пакетов LaTeX или Обзор пакетов Typst.

В проекте LaTeX выберите Пакеты LaTeX. Выполняйте в CTAN поиск по имени или описанию пакета. Если CTAN недоступен или вы офлайн, диалог сообщит об этом и покажет встроенный список Oleafly. Для списка, который не удалось обновить, показывается дата его скачивания.

В каждой строке могут встречаться такие метки:

  • В документе: главный файл уже подключает этот пакет.
  • Класс документа: запись является классом, а не пакетом. Классы задаются командой \documentclass, поэтому строка позволяет скопировать эту команду, но не добавить её.
  • Установлен: пакет уже есть в вашем дистрибутиве TeX.

В каждой строке есть и такие элементы управления:

  • Параметры — поле для параметров пакета, например margin=2cm. Фигурные скобки должны быть парными, а символы ] и % использовать нельзя.
  • Добавить в преамбулу — записывает \usepackage[options]{name} в преамбулу главного файла. Если файл уже подключает пакет, ничего не изменится, и диалог сообщит вам об этом.
  • Копировать строку — копирует ту же строку \usepackage или строку \documentclass для класса.
  • CTAN — открывает страницу пакета на CTAN.
  • Установить — для пакета, которого нет в вашем дистрибутиве TeX. См. ниже.

Смысл слова «установлен» зависит от того, как компилируется проект:

  • 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 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, раздел сообщает об этом.

В этом разделе также показано, сколько пакетов хранит проект.

При включённом офлайн-режиме диалог использует список пакетов, скачанный в прошлый раз, и показывает его дату. Если список ещё ни разу не скачивался, диалог не сможет его показать, пока вы не подключитесь к сети.

Просмотр изображения

Не удалось загрузить ответы ИИ

Попробуйте снова или воспользуйтесь поиском по документации.