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.

De volgende secties zijn alleen van toepassing op Server Pro en Sandboxed Compiles.

​

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:

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/ voor mirrors van archieven.

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

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:

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:

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.