Utöka TeX Live

Utöka TeX Live Docker-avbilder med paket och typsnitt för kompileringsmiljöer som stöds.

Det är möjligt att utöka en befintlig TeX Live-avbild med en ny Dockerfile och konfigurera applikationen att använda den nya avbilden.

Här ger vi några riktlinjer för att installera nya paket eller typsnitt, men konfigurationen av en anpassad avbild omfattas inte av våra supportvillkor.

TeX Live-avbilderna uppdateras sällan. Vi rekommenderar att du bygger om anpassade avbilder när du uppgraderar Server Pro.

Följande avsnitt gäller endast Server Pro och Sandboxed Compiles.

​

Installera och uppdatera nya paket

Du kan använda tlmgr-kommandon som tlmgr install och tlmgr update för att hantera TeX Live-paket, som i följande exempel:

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

RUN tlmgr update --force ebproof

​

Använda tlmgr i en äldre TeX Live-avbild

Som standard laddar tlmgr ner resurser från den senaste TeX Live-utgåvan. När du patchar en äldre TeX Live-avbild måste nedladdningarna växlas till motsvarande arkiv. Se listan på https://www.tug.org/historic/ för speglar av arkiven.

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

​

Installera nya typsnitt

Det finns olika metoder för att installera nya typsnitt i en TeX Live-distribution, och installation av ett anpassat typsnitt kan kräva flera steg. Instruktionerna för att installera TeX-typsnitt i den officiella TeX Live-dokumentationen är förmodligen en bra utgångspunkt.

Följande Dockerfile visar ett exempel på hur man installerar ett TrueType-typsnitt ovanpå en befintlig TeX Live 2022-avbild:

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

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

# rebuild font information cache
RUN fc-cache

​

Konfigurera Server Pro att använda de nya avbilderna

Använd namnet ghcr.io/ayaka-notes/texlive-full och en anpassad tagg för att bygga den nya avbilden, till exempel:

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

Nu kan vi konfigurera Server Pro att använda den nya avbilden 2023.1-custom genom att uppdatera miljövariablerna TEX_LIVE_DOCKER_IMAGE och ALL_TEX_LIVE_DOCKER_IMAGES:

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"

I exemplet ovan använder nya projekt som standard den nya avbilden 2023.1-custom, medan 2023.1 fortfarande finns tillgänglig när den behövs.