Оберіть рушій документів

Дізнайтеся, як документи LaTeX, Typst, Markdown, Quarto і Calepin стають PDF, і оберіть компілятор, потрібний вашому проєкту.

Рушій перетворює ваше джерело на документ, який читають люди. Оберіть мову документа під час створення проєкту. Для проєкту LaTeX можна також обрати, який компілятор LaTeX виконує збірку.

LaTeX компілюється через Tectonic або latexmk, а Typst версією, закріпленою в проєкті. Markdown спершу проходить через Pandoc, потім через Tectonic.

Оберіть мову

Ваша робота	З чого почати	Як це стає PDF
Подання до журналу, усталений клас дисертації чи наявний проєкт `.tex`	LaTeX	Tectonic, або компілятор, запущений через `latexmk`
Нова стаття, звіт або резюме зі стислим синтаксисом верстки	Typst	Вбудований Typst 0.15.1, або інша версія Typst, яку закріпив проєкт
Чернетка суцільного тексту, нотатки або документ, який ви хочете експортувати в кілька форматів	Markdown	Pandoc перетворює джерело на LaTeX; PDF створює Tectonic
Аналітичний звіт, стаття чи набір слайдів, результати яких дає код на R, Python або Julia	Quarto	Quarto перетворює файли `.qmd` або `.Rmd` на PDF, вебсторінку чи слайди
Документ Typst із фрагментами коду	Calepin	Calepin запускає код, потім вбудований Typst збирає PDF

Цей вибір визначає панель інструментів редактора, синтаксис джерела та доступні формати експорту. Зміна компілятора LaTeX не перекладає документ у Typst чи Markdown. Щоб перенести проєкт LaTeX у Typst, перетворіть його на новий проєкт Typst.

Tectonic

Використовуйте Tectonic для простого налаштування LaTeX. Він постачається з Oleafly, завантажує пакунки TeX, яких потребує збірка, і кешує їх для подальших збірок. Починайте звідси, коли ваш шаблон не вимагає конкретного компілятора.

Скомпілюйте раз у мережі перед поїздкою. Проєкт із кешем може компілюватися поза мережею; новий пакунок може усе ще потребувати завантаження. Увімкніть Налаштування → Загальні → Режим офлайн, щоб Tectonic використовував свій кеш.

pdfLaTeX

Оберіть pdfLaTeX, коли цього вимагає видавець або наявний проєкт. Він іде традиційним робочим процесом LaTeX і добре пасує до старіших класів і комбінацій пакунків. Він потребує дистрибутива TeX зі встановленим latexmk.

XeLaTeX

Оберіть XeLaTeX для проєкту, який його вимагає, зокрема такого, що використовує fontspec, шрифти OpenType чи багатомовний текст. Переконайтеся, що шрифти, названі в джерелі, встановлені або долучені до проєкту. Він також запускається через latexmk.

LuaLaTeX

Оберіть LuaLaTeX для шаблону, який його вимагає, для верстки на основі Lua або робочого процесу тегованого PDF в Oleafly. Теговані PDF несуть структуру документа, яку можуть використовувати допоміжні технології. Запустіть передперевірки, щоб оглянути результат; сам по собі вибір компілятора не забезпечує якість тегів.

Typst

Oleafly постачається з Typst 0.15.1. Створіть проєкт Typst, пишіть у файлах .typ і натисніть Скомпілювати знову. Ніякої установки TeX налаштовувати не потрібно.

Налаштування → Рушії → Typst може також встановити Typst від 0.11 до 0.15 і використати Typst, уже встановлений на вашому комп’ютері. Кожен проєкт закріплює власну версію, тож стаття зберігає свій макет, коли Oleafly переходить на новіший Typst. Typst завантажує пакунки з Typst Universe під час першого імпорту їх документом, а Режим офлайн обмежує його пакунками, уже кешованими або збереженими в проєкті.

Typst має власний синтаксис, пакунки й роботу зі шрифтами. У Проєктах Typst описано версії, пакунки, шрифти та варіанти збірки. У Посібнику з письма в Typst є повний початковий документ і елементи керування панелі інструментів.

Markdown

Markdown використовує Pandoc для підготовки зверстаного документа та Tectonic для збірки його PDF. Відкрийте Налаштування → Рушії → Markdown, щоб установити Pandoc, коли його бракує. Потім відкрийте свій проєкт Markdown і скомпілюйте його.

Звертайтеся до Письма в Markdown щодо заголовків, списків, математики та візуального редактора. Посібник з експорту пояснює, які формати виводу пропонує проєкт.

Quarto

Quarto перетворює документи .qmd і .Rmd на PDF, вебсторінку чи слайди. Oleafly використовує Quarto, установлений на вашому комп’ютері, коли знаходить його. Якщо його немає, відкрийте Налаштування → Рушії → Quarto і оберіть Завантажити Quarto 1.10.19. Кнопка також показує розмір завантаження. Oleafly перевіряє завантажений файл, перш ніж розпакувати його, і зберігає копію у власній теці застосунку. Якщо ви компілюєте, поки Quarto ще немає, перегляд пропонує одразу встановити його або Відкрити налаштування рушія.

Перший формат, який оголошує документ, визначає, що ви отримаєте:

pdf, typst і beamer збирають PDF. format: typst не потребує установки TeX. pdf і beamer проходять через LaTeX, тож установіть TinyTeX у Налаштування → Рушії → LaTeX, якщо у вас ще немає TeX.
html, revealjs і dashboard збирають вебсторінку. Оберіть Відкрити в браузері в перегляді, щоб її побачити.

Коли документ не оголошує формату, Oleafly шукає його в _quarto.yml або _metadata.yml у теці документа й у теках над нею аж до кореня проєкту. Якщо формату ніде немає, Quarto збирає вебсторінку. Файл .Rmd, який називає output: R Markdown, наприклад pdf_document, отримує відповідний формат Quarto.

Код виконується в R, Python або Julia, які вже є на вашому комп’ютері. Oleafly ніколи їх не встановлює, а розділ Мови на тій самій вкладці налаштувань показує ті, які він знайшов. Для коду Python також потрібен Jupyter у цьому Python. Експорт пропонує DOCX і HTML, обидва формати збирає Quarto. Діалог Новий проєкт має два шаблони Quarto: Quarto article (PDF, зібраний через Typst) і Quarto slides (презентація reveal.js).

Calepin

Calepin запускає код у документі Typst і вставляє результати в PDF. Документ Calepin є файлом .typ, який імпортує /.calepin/calepin.typ. Почніть такий документ із шаблону Calepin report або відкрийте стрілку поруч із Скомпілювати знову в проєкті Typst і оберіть Calepin у розділі Рушій (цей проєкт).

Встановіть Calepin так само, як Quarto: у Налаштування → Рушії → Calepin кнопкою Завантажити Calepin 0.0.61. Calepin збирає документ за допомогою Typst, що постачається з Oleafly. Фрагмент коду, мову якого не встановлено, показує коротку примітку, а решта документа все одно збирається. Експорт пропонує HTML, який збирає Calepin.

Дозвіл коду в проєкті

Код у документі Quarto чи Calepin запускається з вашими правами, тож у кожному проєкті він вимкнений, доки ви його не дозволите. Після компіляції, якій потрібен був код, банер над редактором повідомляє, що код вимкнено, і пропонує Дозволити запуск коду в цьому проєкті. Також можна відкрити стрілку поруч із Скомпілювати знову й обрати Запускати код на цьому комп’ютері в розділі Код (цей комп’ютер). Вимк. знову вимикає його. Дозволяйте код, лише якщо довіряєте кожному файлу в проєкті.

Цей вибір стосується лише цього комп’ютера. Він не зберігається в проєкті, а зміна рушія проєкту знову вимикає код. У спільному проєкті Oleafly питає ще раз, бо будь-хто, хто може редагувати проєкт, може змінити його код.

Поки код вимкнено:

Quarto показує код кожного фрагмента, не запускаючи його. Фільтри, шорткоди, _extensions, скрипти перед рендерингом і після нього, а також вбудований код R запускають код навіть тоді, тож документ, що їх використовує, не компілюється, доки ви не дозволите код.
Calepin не може пропустити код. Oleafly збирає PDF звичайним Typst із результатів, які Calepin зберіг під час останнього запуску. Якщо їх немає, компіляція зупиняється й просить дозволити код.

Тека, яку ви відкриваєте на місці, також має бути довіреною, перш ніж Quarto чи Calepin зможуть її скомпілювати. Синхронізація джерела й PDF недоступна для жодного з цих рушіїв.

Типовий вибір для нових проєктів

Відкрийте Налаштування → Рушії → LaTeX і оберіть Типовий рушій компіляції: Tectonic (вбудований) або latexmk (системний TeX). Кожен проєкт LaTeX, створений після цього, починається з нього:

Порожній проєкт або шаблон із діалогу Новий проєкт, а також дослідницький проєкт.
Імпортовані ZIP, тека, стаття arXiv або репозиторій GitHub.
Документ, який ви перетворюєте на проєкт LaTeX, як-от файл Word або PDF.

Рушій записується в project.json проєкту, тож співавтор, який відкриває проєкт, компілює його так само. Імпортований проєкт, що називає pdfLaTeX, XeLaTeX або LuaLaTeX, зберігає цей компілятор, коли потрапляє на latexmk. Збережений компілятор наявного проєкту лишається його власним вибором.

Тека, яку ви відкриваєте на місці без власного рушія, слідує типовому вибору, щойно ви їй довіряєте. До того часу вона показується й компілюється на Tectonic. Oleafly нічого не записує в теку в обох випадках.

Для Typst відкрийте Налаштування → Рушії → Typst і оберіть типову версію. Нові проєкти Typst закріплюють версію, яка є типовою під час їхнього створення. Зміна типового значення пізніше не пересуває наявні проєкти.

Змініть компілятор поточного проєкту

Відкрийте стрілку поруч із Скомпілювати знову на панелі інструментів проєкту. У проєкті LaTeX оберіть Tectonic, Авто, pdfLaTeX, XeLaTeX або LuaLaTeX у розділі Компілятор (цей проєкт), потім скомпілюйте. Прочитайте журнал, якщо шаблону потрібен пакунок чи шрифт, яких немає в обраній установці.

У проєкті Typst те саме меню має натомість Версія Typst (цей проєкт). Оберіть установлену версію або Типову, щоб іти за налаштуваннями. Група Рушій (цей проєкт) у цьому меню перемикає документ між Typst і Calepin.

Виявлення наявного дистрибутива TeX

Відкрийте Налаштування → Рушії → LaTeX і перегляньте виявлений інструментарій. Oleafly перевіряє наявність повного набору компіляторів, зокрема latexmk і допоміжних інструментів. Часткова системна установка не має пріоритету над робочою керованою установкою.

Встановлення керованого TinyTeX

Скористайтеся елементом керування встановленням у налаштуваннях рушія LaTeX, якщо вам потрібен традиційний компілятор, а його немає. Oleafly завантажує власну установку TinyTeX у ~/.oleafly/tinytex; права адміністратора не потрібні. Закладіть приблизно 250 МБ на початкове завантаження й додатковий простір для пакунків.

Керування пакунками

Список пакунків у налаштуваннях рушія LaTeX дозволяє фільтрувати пакунки, переглядати описи, додавати й вилучати їх. Значки тегування позначають пакунки, що потребують додаткової уваги під час створення тегованого PDF. Ці елементи керують дистрибутивом TeX, який використовує latexmk; у Tectonic окремий кеш.

Прочитайте посібник із пакунків LaTeX і тегованого PDF →