> ## 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 uitbreiden

> Breid TeX Live-Docker-images uit met pakketten en lettertypen voor ondersteunde compilatieomgevingen.

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

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

De TeX Live-images worden niet vaak bijgewerkt. We raden aan eigen images opnieuw te bouwen wanneer je Server Pro upgradet.

<Danger>
  De volgende secties zijn alleen van toepassing op Server Pro en [Sandboxed Compiles](/nl/on-premises/configuration/overleaf-toolkit/sandboxed-compiles).
</Danger>

### Nieuwe pakketten installeren en bijwerken

Je kunt `tlmgr`-opdrachten zoals `tlmgr install` en `tlmgr update` gebruiken om TeX Live-pakketten te beheren, zoals in het volgende voorbeeld:

```dockerfile theme={null}
FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof
```

### `tlmgr` gebruiken in een oudere TeX Live-image

Standaard downloadt `tlmgr` resources van de nieuwste TeX Live-release. Bij het patchen van een oudere TeX Live-image moeten de downloads worden omgezet naar het bijbehorende archief. Zie de lijst op [https://www.tug.org/historic/](https://www.tug.org/historic/) voor mirrors van archieven.

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

### Nieuwe lettertypen installeren

Er zijn verschillende procedures om nieuwe lettertypen in een TeX Live-distributie te installeren, en het installeren van een eigen lettertype kan meerdere stappen vergen. De [instructies voor het installeren van TeX-lettertypen](https://tug.org/fonts/fontinstall.html) in de officiële TeX Live-documentatie zijn 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 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 configureren om de nieuwe images te gebruiken

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

```bash theme={null}
docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom
```

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

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

In het bovenstaande voorbeeld gebruiken nieuwe projecten standaard de nieuwe image `2023.1-custom`, terwijl `2023.1` beschikbaar blijft voor wanneer die nodig is.


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