> 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/nl/onderhoud/extending-tex-live.md).

# TeX Live uitbreiden

Het is mogelijk om een bestaande TeX Live-image uit te breiden met een nieuw Dockerfile en de applicatie te configureren om de nieuwe image te gebruiken.

Hier bieden we enkele richtlijnen voor het installeren van nieuwe pakketten of lettertypen, maar de configuratie van een aangepaste image valt niet onder onze ondersteuningsvoorwaarden.

De TeX Live-images krijgen onregelmatige updates. We raden aan om aangepaste images opnieuw op te bouwen wanneer u Server Pro upgradet.

{% hint style="danger" %}
De volgende secties zijn van toepassing op Server Pro en [Sandboxed Compiles](broken://pages/d91211ccf4ca260d651a1eda0a74fce6bd7aa7ce) alleen.
{% endhint %}

### Nieuwe pakketten installeren en bijwerken

U kunt `tlmgr` commando's zoals `tlmgr install` en `tlmgr update` gebruiken om TeX Live-pakketten te beheren, zoals in het volgende voorbeeld:

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

RUN tlmgr update --force ebproof
```

### Gebruik van `tlmgr` in een oudere TeX Live-image

Standaard `tlmgr` worden bronnen gedownload uit de nieuwste TeX Live-release. Bij het patchen van een oudere TeX Live-image moeten de downloads worden omgeschakeld naar het betreffende archief. Zie de lijst op <https://www.tug.org/historic/> voor mirrors van archieven.

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

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

RUN tlmgr update --force ebproof
```

### Nieuwe lettertypen installeren

Er zijn verschillende procedures om nieuwe lettertypen te installeren in een TeX Live-distributie, en het installeren van een aangepast lettertype kan meerdere stappen vereisen. Het raadplegen van de [instructies voor het installeren van TeX-lettertypen](https://tug.org/fonts/fontinstall.html) in de officiële TeX Live-documentatie is waarschijnlijk een goed startpunt.

Het volgende `Dockerfile` toont een voorbeeld van het installeren van een TrueType-lettertype bovenop een bestaande TeX Live 2022-image:

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

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

# lettertype-informatiecache opnieuw opbouwen
RUN fc-cache
```

### Server Pro configureren om de nieuwe images te gebruiken

Gebruik de naam `ghcr.io/ayaka-notes/texlive-full` en een aangepaste tag om de nieuwe image te bouwen, zoals in:

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

We kunnen Server Pro nu configureren om de nieuwe `2023.1-custom` image te gebruiken door de `TEX_LIVE_DOCKER_IMAGE` en `ALL_TEX_LIVE_DOCKER_IMAGES` omgevingsvariabelen bij te werken:

{% 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 %}

In het bovenstaande voorbeeld worden nieuwe projecten standaard ingesteld om de nieuwe `2023.1-custom` image te gebruiken, terwijl `2023.1` nog steeds beschikbaar is wanneer dat nodig is.


---

# 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/nl/onderhoud/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.