> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/uk/obslugovuvannya/extending-tex-live.md).

# Розширення TeX Live

Можна розширити наявний образ TeX Live, використовуючи новий Dockerfile, і налаштувати застосунок на використання нового образу.

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

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

{% hint style="danger" %}
Наведені нижче розділи стосуються Server Pro та [Ізольованих компіляцій](broken://pages/b9ca3bcc97e34b56334d9d294bf1334d5794a4bd) лише.
{% endhint %}

### Встановлення та оновлення нових пакунків

Ви можете використовувати `tlmgr` команди, такі як `tlmgr install` та `tlmgr update` для керування пакунками Tex Live, як у наведеному нижче прикладі:

```dockerfile
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/> для дзеркал архівів.

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

RUN tlmgr option repository <MIRROR>/systems/texlive/<YEAR>/tlnet-final
# напр. 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
FROM ghcr.io/ayaka-notes/texlive-full:2022.1

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

# перебудувати кеш інформації про шрифти
RUN fc-cache
```

### Налаштування Server Pro для використання нових образів

Використайте назву `ghcr.io/ayaka-notes/texlive-full` та користувацький тег, щоб зібрати новий образ, як у прикладі:

```bash
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` змінні середовища:

{% code overflow="wrap" %}

```
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"
```

{% endcode %}

У наведеному вище прикладі нові проєкти за замовчуванням налаштовані на використання нового `2023.1-custom` образу, тоді як `2023.1` залишається доступним, коли це потрібно.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/uk/obslugovuvannya/extending-tex-live.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.