Движки и пакеты LaTeX
Выберите Tectonic или компилятор через latexmk, используйте существующий дистрибутив TeX или установите управляемый TinyTeX от Oleafly.
В Oleafly встроен Tectonic, кроме того, приложение может компилировать через latexmk. Повседневными сборками управляет меню компилятора проекта. В разделе Настройки → Движки видны дистрибутивы TeX и пакеты, доступные на вашем компьютере.
Tectonic: повседневный движок
Заголовок раздела «Tectonic: повседневный движок»Tectonic — движок компиляции по умолчанию, пока вы не выберете другой в пункте Движок компиляции по умолчанию в разделе Настройки → Движки → LaTeX. Он не требует отдельной установки, скачивает пакеты по мере необходимости и кэширует их для офлайн-работы. Он подходит большинству проектов и остаётся доступным, даже когда системный дистрибутив TeX не установлен. См. Значение по умолчанию для новых проектов.
Для тегированных PDF используйте рабочий процесс LuaLaTeX. Теги описывают структуру документа для вспомогательных технологий. Проверьте результат с помощью «Предпроверки» после компиляции.
Шрифты во встроенном движке
Заголовок раздела «Шрифты во встроенном движке»Tectonic основан на XeTeX, который читает файлы шрифтов напрямую. Oleafly подстраивает несколько вещей, чтобы документы, написанные для pdfLaTeX, сохраняли свои шрифты и текст:
-
Times, Helvetica, Courier, Palatino, Bookman, New Century Schoolbook и Avant Garde используют свои версии из TeX Gyre вместо возврата к Latin Modern.
-
\usepackage[T1]{fontenc}в этом движке ломает набранные акценты и символы, поэтому Oleafly оставляет документ на тексте Unicode. Если шрифт, который использует документ, существует только в T1, документ остаётся на T1, а компиляция предупреждает, что такие символы, как ß, §, «, типографские кавычки и €, могут напечататься неверно или пропасть. В предупреждении есть вариант строки, который загружает T1 только под pdfLaTeX:\usepackage{iftex}\ifPDFTeX\usepackage[T1]{fontenc}\fi -
Документ, который задаёт
\pdfoutput=1, как просит arXiv, компилируется как есть. -
Документ
ctex, где не заданfontset, получает шрифты Fandol, чтобы выглядеть одинаково на любом компьютере. Добавьтеfontset=macв параметры класса, чтобы использовать собственные шрифты Mac. -
Шрифты, которые поставляются со встроенным движком, находятся по имени файла.
\setmainfont{UnBatang}не работает, и ошибка предлагает написать вместо этогоUnBatang.ttf.
Офлайн-режим пропускает эти подстройки шрифтов и кодировки, поэтому офлайн-сборка такого документа может выглядеть иначе, чем онлайн-сборка.
latexmk и системный TeX
Заголовок раздела «latexmk и системный TeX»Выберите pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX или pLaTeX в меню компилятора проекта, если проект зависит от традиционного рабочего процесса TeX Live или MiKTeX. Oleafly запускает эти компиляторы через latexmk. Автоматически читает главный файл и выбирает один из них: побеждает строка % !TeX program = xelatex в начале, затем японские классы, затем пакеты, которым нужен XeLaTeX или LuaLaTeX, такие как fontspec, ctex, xeCJK или luatexko. Если главный файл не решает дело, режим «Автоматически» проверяет также latexmkrc в проекте и файлы, которые загружает преамбула. Всё остальное использует pdfLaTeX. Если пакету нужен другой компилятор, чем выбранный автоматически, компиляция предлагает переключиться, например кнопкой Использовать XeLaTeX.
Этот набор инструментов можно предоставить двумя способами:
- Использовать существующую установку. Oleafly обнаруживает на вашей системе MacTeX, TeX Live, MiKTeX и TinyTeX. Он смотрит в тот же
PATH, что и ваш терминал, а в Windows ещё и в системные и пользовательские настройкиPath, поэтому TeX, установленный вручную, находится, даже если приложение открыто из Dock или меню «Пуск». Системная установка получает приоритет над управляемой копией Oleafly, только если её каталог с бинарными файлами содержитlatexmk, pdfLaTeX, XeLaTeX, LuaLaTeX,kpsewhichи Biber. Частичная установка не может незаметно обойти работающий управляемый TinyTeX. - Установить управляемый TinyTeX. Загрузка составляет около 250 МБ и не требует прав администратора. См. Установка и обновление TinyTeX.
Управление дистрибутивами TeX в Настройки → Движки → LaTeX перечисляет все дистрибутивы, которые нашёл Oleafly. Пометка Используется отмечает тот, которым компилирует latexmk, а значок latexmk — каждый, способный компилировать. Выберите Использовать для компиляции в другой строке, чтобы переключиться на него. Выбранная строка тогда показывает Автоматически, что позволяет Oleafly выбрать снова: сначала полный системный TeX, затем TinyTeX.
Если TeX установлен в папке, где Oleafly не ищет, нажмите Выбрать папку TeX и укажите папку, в которой лежит latexmk, или папку года TeX Live, которая выше неё, например texlive/2026. Oleafly находит внутри latexmk и компилирует с этой установкой, которую список помечает как Используется. Автоматически отменяет выбор. Если в папке нет latexmk, сообщение подскажет, какую папку выбрать вместо неё.
latexmk — не песочница для файловой системы. Даже при заблокированных командах оболочки TeX может читать файлы, доступные вашей учётной записи. Oleafly также отключает файлы .latexmkrc проекта, пользователя и системы, поскольку это исполняемый Perl. Используйте системный TeX только для проектов, которым доверяете. Импортированный проект использует системный TeX, только когда вы его выберете — как движок компиляции по умолчанию или из меню компилятора проекта. Папка, открытая на месте, остаётся на Tectonic, пока вы не признаете её доверенной.
Когда TeX не установлен
Заголовок раздела «Когда TeX не установлен»Выбор pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, pLaTeX или режима «Автоматически» на компьютере без работающего дистрибутива TeX открывает диалог с заголовком Этому компилятору нужен работающий дистрибутив TeX. В нём три варианта в таком порядке:
- Скачать TinyTeX с пометкой Рекомендуется. Скачать и использовать TinyTeX устанавливает TinyTeX и компилирует проект с ним.
- Использовать системный LaTeX (latexmk), где сказано, что дистрибутив TeX не найден или почему тот, что есть на этом компьютере, не может компилировать. Кнопки у него нет.
- Продолжить с Tectonic. Вернуться к Tectonic возвращает проект на встроенный движок.
Если вы сначала запускаете компиляцию, предпросмотр предлагает тот же выход: Скачать и использовать TinyTeX, Использовать Tectonic и Открыть настройки движка. Компиляция, запущенная, пока TinyTeX ещё скачивается, ждёт и стартует сама, когда установка завершится.
То же предложение появляется, когда дистрибутив TeX есть, но в нём нет latexmk. Если в дистрибутиве не хватает latexmk, выбранного компилятора или Biber, сообщение также называет, что установить, когда Oleafly знает дистрибутив, например sudo tlmgr install latexmk в MacTeX или sudo apt install latexmk в Ubuntu.
В общем проекте кнопка называется Использовать Tectonic для всех, потому что компилятор сохраняется в проекте и меняется у каждого соавтора. Установка TinyTeX меняет только ваш компьютер.
Установка и обновление TinyTeX
Заголовок раздела «Установка и обновление TinyTeX»Откройте Настройки → Движки → LaTeX и выберите Скачать TinyTeX (~250 МБ) в разделе Управление дистрибутивами TeX либо воспользуйтесь предложением в диалоге компиляции. TinyTeX — компактный TeX Live, которому не нужны права администратора. Шаблоны журналов могут позже добавить пакеты, примерно до 1 ГБ в сумме, а перед началом Oleafly проверяет, что на диске около 2 ГБ свободного места. TinyTeX устанавливается в ~/.oleafly/tinytex.
- Отмена останавливает загрузку и сохраняет уже полученное. Кнопка тогда называется Продолжить загрузку и показывает, сколько уже готово. Выход из Oleafly во время установки приостанавливает её так же, и она продолжится при следующем открытии приложения.
- Загрузка идёт сначала с зеркала Oleafly, затем с GitHub. Если источник не отвечает или минуту не присылает данные, Oleafly переходит к следующему и продолжает с того места, где остановился. Настройки → Загрузки → Источники меняет, откуда идут загрузки. См. Вкладка «Источники».
- Когда управляемый TinyTeX старше выпуска, которого ждёт эта версия Oleafly, в его строке появляется Обновить. Удалить убирает его.
Если другой дистрибутив уже Используется, установка TinyTeX не переключает на него. Выберите Использовать для компиляции в строке TinyTeX, когда хотите, чтобы он компилировал.
В Linux TinyTeX работает на системном Perl. Oleafly проверяет Perl до начала загрузки. Если Perl или один из его стандартных модулей отсутствует, сообщение даёт команду для установки: sudo apt install perl, sudo dnf install perl или sudo pacman -S perl.
В Windows TeX Live не может работать из папки, в имени которой есть буквы с диакритикой или не латинские буквы. Если у вашей пользовательской папки такое имя, Oleafly размещает TinyTeX в папке внутри ProgramData. Если антивирус удерживает файл открытым, пока TinyTeX становится на место, Oleafly повторяет попытку, а если всё равно не может закончить, подождите немного и повторите установку.
MiKTeX и Perl
Заголовок раздела «MiKTeX и Perl»latexmk в MiKTeX — это скрипт на Perl, а сам MiKTeX Perl не включает. Без Perl в настройках MiKTeX получает пометку latexmk требует Perl, и Oleafly компилирует с TinyTeX, если он установлен. Если больше использовать нечего, компиляция останавливается и предлагает три пути: установить TinyTeX из Настройки → Движки → LaTeX, у которого свой Perl, установить Strawberry Perl или вернуть проект на Tectonic.
MiKTeX управляет пакетами в MiKTeX Console, поэтому список Пакеты и Найти и установить к нему не относятся. MiKTeX также не преобразует рисунки EPS во время компиляции, поэтому сначала преобразуйте их в PDF или используйте TinyTeX.
Японские документы: upLaTeX и pLaTeX
Заголовок раздела «Японские документы: upLaTeX и pLaTeX»Выберите upLaTeX или pLaTeX в разделе Компилятор (этот проект) для японского документа либо оставьте компилятор на Автоматически. Режим «Автоматически» выбирает pLaTeX для jsarticle, jsbook и jsreport (upLaTeX, если у класса есть параметр uplatex), upLaTeX для классов uj и jlreq, а LuaLaTeX — для ltjsarticle и других документов на LuaTeX-ja.
Обоим компиляторам нужна поддержка японского в TeX Live. Когда её нет в управляемом TinyTeX или в TeX Live, в который Oleafly может писать, неудавшаяся компиляция предлагает Установить поддержку японского (около 450 МБ). Это устанавливает её и компилирует снова. В других установках сообщение называет команду для вашего дистрибутива, например sudo apt install texlive-lang-japanese.
Когда Tectonic недостаточно
Заголовок раздела «Когда Tectonic недостаточно»Некоторым документам нужны вещи, которые встроенный движок Tectonic не делает, например рисунки EPS или принудительный драйвер pdftex. Когда первая компиляция после открытия проекта или запущенная вами компиляция наталкивается на что-то из этого, диалог выбора движка открывается сам. Когда компиляцию запускает автокомпиляция или агент, диалог остаётся закрытым, а вместо него появляется Выбрать движок. Выберите его, чтобы открыть диалог. Кнопка остаётся до следующей компиляции, поэтому с её помощью диалог можно открыть снова, если вы его закрыли. Где её искать, зависит от вида:
- После неудачной компиляции она справа на панели инструментов предпросмотра, пока открыт Журнал. Если компиляция не создала PDF, предпросмотр сам переключается на Журнал. Если PDF всё ещё показан, выберите Журнал, чтобы увидеть кнопку.
- В пустом предпросмотре она рядом с Скомпилировать заново.
- В режиме только редактора, когда PDF в отдельном окне или после успешной компиляции, она слева от Скомпилировать заново.
Диалог называется Этой компиляции нужно больше, чем даёт встроенный движок и перечисляет найденные проблемы. Первым идёт вариант с пометкой Рекомендуется:
- Скачать TinyTeX появляется, когда нет работающего дистрибутива TeX. Его кнопка Скачать и использовать TinyTeX устанавливает TinyTeX, переключает проект на
latexmkи компилирует заново. - У Использовать системный LaTeX (latexmk) есть кнопка Использовать системный LaTeX: она переключает проект на
latexmkс тем дистрибутивом TeX, который нашёл Oleafly. Если документу нужен pdfLaTeX, вариант называется Использовать pdfLaTeX из системного LaTeX (latexmk), а его кнопка — Перейти на pdfLaTeX и скомпилировать заново. Если TeX не установлен, у этого варианта нет кнопки. - У Продолжить с Tectonic есть кнопка Оставить Tectonic: она оставляет проект на встроенном движке. Когда переключение исправило бы проблемы из списка диалога, этот вариант предупреждает, что они не исчезнут.
После того как вы оставили Tectonic, те же проблемы больше не открывают диалог и не показывают Выбрать движок для этого проекта на этом компьютере. Чтобы переключиться позже, выберите компилятор в разделе Компилятор (этот проект).
Если проекту нужно также запускать внешние команды, переключение на системный LaTeX или TinyTeX разрешает и их, и диалог сообщает об этом до нажатия. Выбранный компилятор сохраняется в проекте, поэтому соавторы получают ту же настройку.
Разрешить внешние команды
Заголовок раздела «Разрешить внешние команды»Пакеты вроде minted и PythonTeX, а также документы, использующие \write18, запускают другие программы во время компиляции. По умолчанию Oleafly это блокирует. Если компиляция заблокирована или журнал показывает, что проекту нужны такие команды, плашка над редактором предлагает Разрешить внешние команды.
Встроенный движок тоже сохраняет эту блокировку. Tectonic запускается вне папки проекта, а Biber, который входит в Oleafly, воспринимает настройки библиографии документа как обычный текст и во время компиляции пропускает biber.conf.
Разрешайте внешние команды только для проекта, чьим файлам вы доверяете: после этого LaTeX сможет запускать любые программы с вашими правами. Разрешение работает только с системным LaTeX и остаётся на этом компьютере. Оно никогда не сохраняется в project.json и не попадает в Git, поэтому соавтору придётся разрешить его на собственном компьютере. В общем проекте Oleafly предупреждает вас перед включением: любой, кто может редактировать проект, сможет тогда запускать программы на вашем компьютере во время компиляции. Возврат проекта на Tectonic или его удаление снимает разрешение. В папке, открытой на месте, сначала сделайте папку доверенной. Доверие к папке само по себе не разрешает внешние команды.
Когда движок установлен, кнопка Скомпилировать с тегами и проверить панели «Предпроверка» может за один шаг создать тегированный PDF через LuaLaTeX и сразу проверить его. Предпочитаете собственный набор инструментов? «Подготовить к доступному экспорту» в «Предпроверке» переписывает ваш исходник для тегирования, а компилируете вы его любым LuaLaTeX из TeX Live 2026 или из TeX Live, обновлённого с ноября 2025 года, вне приложения.
Символы, отсутствующие в PDF
Заголовок раздела «Символы, отсутствующие в PDF»TeX пропускает любой символ, для которого в шрифте нет глифа, а компиляция при этом всё равно проходит успешно. Абзац на корейском, китайском или японском может выйти пустым без всякой ошибки. Oleafly читает журнал после каждой компиляции, поэтому, когда символы пропадают, вы один раз на проект получаете уведомление, журнал перечисляет их в группе Отсутствующие символы, а предупреждение называет несколько из них.
Во встроенном движке и в XeLaTeX предупреждение также даёт настройку для каждого найденного письма, использующую шрифты, которые поставляются со встроенным движком. Вставьте нужную в преамбулу:
% Korean\usepackage[space]{xeCJK}\setCJKmainfont[AutoFakeBold]{UnBatang.ttf}
% Simplified Chinese\usepackage{xeCJK}\setCJKmainfont[AutoFakeBold]{gbsn00lp.ttf}
% Traditional Chinese\usepackage{xeCJK}\setCJKmainfont[AutoFakeBold]{bsmi00lp.ttf}
% Japanese\usepackage{xeCJK}\setCJKmainfont{ipaexm.ttf}[BoldFont=ipaexg.ttf]Параметр space сохраняет пробелы между корейскими словами, которые обычный xeCJK теряет.
CJKutf8 и пакет CJK работают только в pdfLaTeX. Проект, который загружает их во встроенном движке, компилируется без китайского, японского или корейского текста, поэтому уведомление предлагает Выбрать движок, что открывает переключение на pdfLaTeX. Можно также убрать пакет и его окружение CJK и использовать одну из настроек выше.
Документ ctex на Mac, использующий собственные шрифты Mac, может заставить macOS спросить, скачивать ли шрифт, и компиляция ждёт вашего ответа. Ответьте на диалог и скомпилируйте снова или добавьте fontset=fandol в параметры \documentclass.
Другим отсутствующим символам, например символу или букве из другого письма, нужен шрифт, в котором они есть. Переключитесь на него в преамбуле. Для проектов Typst см. Символы, которые выглядят как квадратики.
Менеджер пакетов
Заголовок раздела «Менеджер пакетов»Под статусом движка находится фильтруемый список Пакеты для стороны LuaLaTeX, работающий на tlmgr:
- Начните с предлагаемого списка пакетов либо введите минимум два символа и выберите Искать в TeX Live, чтобы запросить полный каталог.
- Ищите по имени пакета или по файлу, который он содержит. Когда имена различаются, Oleafly показывает пакет TeX Live, которому файл принадлежит.
- Добавить или Удалить пакет можно одним щелчком. Строки установленных пакетов показывают, находится ли пакет в системном дереве, в вашем личном дереве или в обоих.
- Перед доступным экспортом проверяйте значок тегирования: тегирование: осторожно отмечает пакеты, которые могут снизить качество тегов, а ломает тегирование — известные конфликты.
Этот менеджер пакетов применяется к дистрибутивам TeX Live и TinyTeX, используемым latexmk. Tectonic управляет собственным кэшем пакетов. Для MiKTeX используйте MiKTeX Console.
Восстановление после отсутствующего файла
Заголовок раздела «Восстановление после отсутствующего файла»Пакет не всегда назван так же, как файл, упомянутый в журнале компиляции. Например, tikz.sty устанавливается пакетом pgf. Установка угаданного пакета tikz завершилась бы ошибкой.
Когда компиляция latexmk сообщает об отсутствующем файле, используйте Найти и установить в сообщении. Это охватывает пакеты, классы, стили библиографии, файлы шрифтов, языковые файлы babel и библиотеки TikZ. Oleafly спрашивает у TeX Live, какому пакету принадлежит файл, устанавливает этот пакет и компилирует заново. Если файла нет ни в одном пакете TeX Live, он, скорее всего, пришёл с шаблоном вашего университета или издательства, поэтому добавьте его в проект из исходного шаблона. Если файл есть в нескольких пакетах, сообщение перечисляет их, чтобы вы выбрали тот, который нужен шаблону. Если каталог недоступен или установка не исправляет компиляцию, сообщение говорит, что именно случилось.
Если вы пытаетесь изменить системную установку без прав, Oleafly может установить пакет в ваше личное дерево TeX и сначала создаёт это дерево, если его ещё нет. Строка пакета показывает, куда он попал. Удаление пакета-владельца удаляет и остальные файлы, которые он предоставляет, поэтому прочитайте пометку Входит в … перед удалением.
Как поддерживать работу tlmgr и старых выпусков TeX Live
Заголовок раздела «Как поддерживать работу tlmgr и старых выпусков TeX Live»tlmgr, менеджер пакетов TeX Live, может отстать от онлайн-репозитория TeX Live, и тогда он отказывается что-либо устанавливать, пока не обновит сам себя. Для управляемого Oleafly TinyTeX Oleafly обновляет tlmgr и повторяет установку. В TeX Live или TinyTeX, которые вы установили сами, сообщение предлагает выполнить tlmgr update --self.
Когда репозиторий переходит на новый год TeX Live, старая установка не может ставить из него пакеты. Тогда Oleafly устанавливает из финального архива вашего выпуска. Если нужного пакета нет и в архиве, сообщение просит обновить TeX Live или нажать Обновить у управляемого TinyTeX в настройках.
Выбор источника пакетов
Заголовок раздела «Выбор источника пакетов»tlmgr устанавливает пакеты из репозитория TeX Live. TinyTeX, которым управляет Oleafly, использует ближайшее зеркало CTAN, если только вы не выберете конкретный репозиторий, например зеркало CTAN вашего университета, в разделе Репозиторий пакетов TeX в Настройки → Загрузки → Источники. TeX Live, который вы установили сами, сохраняет свой репозиторий, пока вы не введёте там адрес. Oleafly передаёт адрес tlmgr при каждом запуске и никогда не меняет его сохранённую конфигурацию.
Поиск пакета, которому нужно обратиться к репозиторию, при медленном соединении может занять много времени. Oleafly ждёт до 10 минут, а если сдаётся, сообщение называет репозиторий, которого оно ждало. См. Вкладка «Источники».
TeX Live из дистрибутива Linux
Заголовок раздела «TeX Live из дистрибутива Linux»В Debian, Ubuntu и Fedora TeX Live приходит из системного менеджера пакетов, поэтому Oleafly не добавляет в него пакеты. Список Пакеты предлагает использовать apt или dnf, а для отсутствующего файла вместо Найти и установить появляется уведомление с подсказкой:
- В Debian и Ubuntu найдите пакет командой
apt-file searchс именем файла или установите всё сразу командойsudo apt install texlive-full. - В Fedora уведомление даёт для отсутствующего файла команду
sudo dnf install 'tex(file.sty)'.
Если TeX дистрибутива неполон, уведомление также предлагает Скачать TinyTeX (~250 МБ), пакетами которого Oleafly может управлять. В Debian и Ubuntu, если вы настроили личное дерево командой tlmgr init-usertree, Oleafly устанавливает пакеты в это дерево.
Добавление пакета из редактора
Заголовок раздела «Добавление пакета из редактора»Выберите Пакеты LaTeX — значок пакетов на панели инструментов редактора LaTeX, — чтобы искать в CTAN, не покидая документ. Каждый результат показывает, подключён ли пакет уже в документе (В документе). В проекте latexmk видно также, есть ли пакет в вашем дистрибутиве TeX (Установлен), а Установить добавляет недостающий через tlmgr. С TeX Live из дистрибутива Linux диалог вместо этого предлагает устанавливать пакеты через apt или dnf.
Добавить в преамбулу записывает строку \usepackage в преамбулу. Параметры позволяет сначала задать параметры пакета, а Копировать строку копирует строку. В проекте на Tectonic устанавливать нечего: Tectonic скачивает пакет, когда документ впервые его использует.
Какой движок скомпилировал мой PDF?
Заголовок раздела «Какой движок скомпилировал мой PDF?»- Компилятор (этот проект) в меню компиляции — стрелка рядом с Скомпилировать заново — показывает компилятор, сохранённый для текущего проекта.
- Сборки Tectonic используют встроенный движок.
- Сборки pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX и pLaTeX используют
latexmkи дистрибутив TeX, помеченный в настройках как Используется. - Тегированный экспорт «Предпроверки» использует LuaLaTeX и пишет в обычное место сборки.
Шаблоны и пакеты
Заголовок раздела «Шаблоны и пакеты»Шаблоны объявляют нужные им пакеты, и Tectonic скачивает их при первой компиляции. Шаблоны со шрифтами по запросу обрабатывают их отдельно. См. Шаблоны.