> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

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

<Danger>
  Следующие разделы относятся только к Server Pro и [Sandboxed Compiles](/ru/on-premises/configuration/overleaf-toolkit/sandboxed-compiles).
</Danger>

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

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

```dockerfile theme={null}
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/](https://www.tug.org/historic/).

```dockerfile theme={null}
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](https://tug.org/fonts/fontinstall.html) в официальной документации TeX Live.

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

```dockerfile theme={null}
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` и собственный тег, например:

```bash theme={null}
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`:

```text wrap theme={null}
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` по-прежнему останется доступным при необходимости.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.