Інструменти документа
Пакети
Шукайте пакети 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, розділ про це каже.
Розділ також показує, скільки пакетів містить проєкт.
Офлайн
Розділ «Офлайн»У режимі офлайн діалог використовує список пакетів, завантажений останнього разу, і показує його дату. Якщо списку ніколи не завантажували, показати його не вийде, поки ви не вийдете в мережу.
Сторінки за темою
Розділ «Сторінки за темою»- Редактор: решта панелі інструментів редактора
- Компіляція: як пакети дістаються під час збирання
- Налаштування документа: розмір паперу, поля та шрифти без писання коду пакетів