Udvidelse af TeX Live

Udvid TeX Live Docker-images med pakker og skrifttyper til understøttede kompileringsmiljøer.

Det er muligt at udvide et eksisterende TeX Live-image med en ny Dockerfile og konfigurere applikationen til at bruge det nye image.

Her giver vi nogle retningslinjer for installation af nye pakker eller skrifttyper, men konfiguration af et brugerdefineret image er ikke omfattet af vores supportvilkår.

TeX Live-imagesene opdateres sjældent. Vi foreslår, at du genbygger brugerdefinerede images, når du opgraderer Server Pro.

Følgende afsnit gælder kun for Server Pro og Sandboxed Compiles.

​

Installation og opdatering af nye pakker

Du kan bruge tlmgr-kommandoer såsom tlmgr install og tlmgr update til at administrere TeX Live-pakker som i følgende eksempel:

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

RUN tlmgr update --force ebproof

​

Brug af tlmgr i et ældre TeX Live-image

Som standard downloader tlmgr ressourcer fra den seneste TeX Live-udgave. Når du patcher et ældre TeX Live-image, skal downloads omstilles til det tilsvarende arkiv. Se listen på https://www.tug.org/historic/ for spejle af arkiverne.

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

​

Installation af nye skrifttyper

Der findes forskellige fremgangsmåder til at installere nye skrifttyper i en TeX Live-distribution, og installation af en brugerdefineret skrifttype kan kræve flere trin. Vejledningen i installation af TeX-skrifttyper i den officielle TeX Live-dokumentation er sandsynligvis et godt udgangspunkt.

Følgende Dockerfile viser et eksempel på installation af en TrueType-skrifttype oven på et eksisterende 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

​

Konfiguration af Server Pro til at bruge de nye images

Brug navnet ghcr.io/ayaka-notes/texlive-full og et brugerdefineret tag til at bygge det nye image, som i:

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

Nu kan vi konfigurere Server Pro til at bruge det nye 2023.1-custom-image ved at opdatere miljøvariablerne TEX_LIVE_DOCKER_IMAGE og 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 eksemplet ovenfor er nye projekter som standard sat til at bruge det nye 2023.1-custom-image, mens 2023.1 stadig er tilgængeligt, når der er brug for det.