Estendere TeX Live

Estendi le immagini Docker di TeX Live con pacchetti e font per gli ambienti di compilazione supportati.

È possibile estendere un’immagine TeX Live esistente usando un nuovo Dockerfile e configurare l’applicazione per usare la nuova immagine.

Qui offriamo alcune linee guida per installare nuovi pacchetti o font, ma la configurazione di un’immagine personalizzata non è coperta dai nostri termini di supporto.

Le immagini TeX Live ricevono aggiornamenti poco frequenti. Consigliamo di ricompilare le immagini personalizzate quando aggiorni Server Pro.

Le sezioni seguenti si applicano solo a Server Pro e alle Sandboxed Compiles.

​

Installare e aggiornare nuovi pacchetti

Puoi usare comandi tlmgr come tlmgr install e tlmgr update per gestire i pacchetti TeX Live, come nell’esempio seguente:

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

RUN tlmgr update --force ebproof

​

Usare tlmgr in un’immagine TeX Live precedente

Per impostazione predefinita tlmgr scarica le risorse dall’ultima release di TeX Live. Quando si applicano patch a un’immagine TeX Live precedente, i download devono essere indirizzati all’archivio corrispondente. Consulta l’elenco in https://www.tug.org/historic/ per i mirror degli archivi.

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

​

Installare nuovi font

Esistono diverse procedure per installare nuovi font in una distribuzione TeX Live, e l’installazione di un font personalizzato può richiedere diversi passaggi. Consultare le istruzioni per installare i font TeX nella documentazione ufficiale di TeX Live è probabilmente un buon punto di partenza.

Il seguente Dockerfile mostra un esempio di installazione di un font TrueType su un’immagine TeX Live 2022 esistente:

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

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

# rebuild font information cache
RUN fc-cache

​

Configurare Server Pro per usare le nuove immagini

Usa il nome ghcr.io/ayaka-notes/texlive-full e un tag personalizzato per compilare la nuova immagine, come in:

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

Ora possiamo configurare Server Pro per usare la nuova immagine 2023.1-custom aggiornando le variabili d’ambiente TEX_LIVE_DOCKER_IMAGE e 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"

Nell’esempio sopra, i nuovi progetti sono impostati per usare per impostazione predefinita la nuova immagine 2023.1-custom, mentre 2023.1 resta disponibile quando serve.