Расширение TeX Live

Расширение Docker-образов TeX Live пакетами и шрифтами для поддерживаемых сред компиляции.

Существующий образ TeX Live можно расширить с помощью нового Dockerfile и настроить приложение на использование нового образа.

Здесь мы приводим рекомендации по установке новых пакетов или шрифтов, однако настройка пользовательского образа не входит в условия нашей поддержки.

Образы TeX Live обновляются нечасто. Мы рекомендуем пересобирать пользовательские образы при обновлении Server Pro.

Следующие разделы относятся только к Server Pro и Sandboxed Compiles.

​

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

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

FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof

​

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

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

FROM ghcr.io/ayaka-notes/texlive-full:2022.1

RUN tlmgr option repository <MIRROR>/systems/texlive/<YEAR>/tlnet-final
# e.g. RUN tlmgr option repository ftp://tug.org/historic/systems/texlive/2022/tlnet-final

RUN tlmgr update --force ebproof

​

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

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

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

FROM ghcr.io/ayaka-notes/texlive-full:2022.1

COPY ./myfonts/*.ttf /usr/share/fonts/truetype/myfont/

# rebuild font information cache
RUN fc-cache

​

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

Соберите новый образ, используя имя ghcr.io/ayaka-notes/texlive-full и собственный тег, например:

docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom

Теперь можно настроить Server Pro на использование нового образа 2023.1-custom, обновив переменные окружения TEX_LIVE_DOCKER_IMAGE и ALL_TEX_LIVE_DOCKER_IMAGES:

TEX_LIVE_DOCKER_IMAGE: "ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
ALL_TEX_LIVE_DOCKER_IMAGES: "ghcr.io/ayaka-notes/texlive-full:2023.1,ghcr.io/ayaka-notes/texlive-full:2023.1-custom"

В приведённом примере новые проекты по умолчанию будут использовать новый образ 2023.1-custom, а образ 2023.1 по-прежнему останется доступным при необходимости.