Перейти к основному содержанию
Существующий образ TeX Live можно расширить с помощью нового Dockerfile и настроить приложение на использование нового образа. Ниже приведены рекомендации по установке новых пакетов или шрифтов. Образы TeX Live обновляются нечасто. Мы рекомендуем пересобирать пользовательские образы при обновлении Ayakaleaf Pro.
Следующие разделы относятся только к Sandboxed Compiles.

Установка и обновление пакетов

Для управления пакетами TeX Live можно использовать команды tlmgr, такие как tlmgr install и tlmgr update, как показано в следующем примере:

Использование tlmgr в более старом образе TeX Live

По умолчанию tlmgr загружает ресурсы из последнего выпуска TeX Live. При доработке более старого образа TeX Live загрузку необходимо переключить на соответствующий архив. Список зеркал архивов приведён на странице https://www.tug.org/historic/.

Установка новых шрифтов

Существуют разные способы установки новых шрифтов в дистрибутив TeX Live, и установка пользовательского шрифта может потребовать нескольких шагов. Хорошей отправной точкой, вероятно, станут инструкции по установке шрифтов TeX в официальной документации TeX Live. Следующий Dockerfile показывает пример установки шрифта TrueType поверх существующего образа TeX Live 2022:

Настройка Ayakaleaf Pro на использование новых образов

Соберите новый образ, используя имя ghcr.io/ayaka-notes/texlive-full и собственный тег, например:
Теперь можно настроить Ayakaleaf Pro на использование нового образа 2023.1-custom, обновив переменные окружения TEX_LIVE_DOCKER_IMAGE, ALL_TEX_LIVE_DOCKER_IMAGES и ALL_TEX_LIVE_DOCKER_IMAGE_NAMES (имена необязательны и следуют в том же порядке, что и образы):
В приведённом примере новые проекты по умолчанию будут использовать новый образ 2023.1-custom, а образ 2023.1 по-прежнему останется доступным при необходимости. Пользовательский образ существует только на вашем хосте, поэтому bin/up не может его загрузить. Задайте SIBLING_CONTAINERS_PULL=false в config/overleaf.rc (остальные образы загружайте самостоятельно командой docker pull), затем выполните bin/up -d, чтобы применить новые настройки.

Вопросы и ответы

Ответ: Нет, при использовании образов texlive-full — не нужно. Они включают китайские пакеты TeX Live (ctex, xeCJK) со шрифтами Fandol, а также шрифты Noto CJK (например, Noto Serif CJK SC). Выберите XeLaTeX в качестве компилятора проекта в настройках редактора и выполните компиляцию, например:
Чтобы использовать Noto вместо Fandol, добавьте \setCJKmainfont{Noto Serif CJK SC}. Файл latexmkrc не нужен. Для других шрифтов соберите собственный образ, как показано в разделе Установка новых шрифтов.
Последнее изменение 2 ноября 2026 г.