TeX Live i Docker

​

Docker

Docker giver en let og portabel måde at pakke og køre applikationer i isolerede containere. Ved at samle applikationen med alle nødvendige afhængigheder sikrer en container ensartet adfærd på tværs af forskellige maskiner, fra bærbare computere til produktionsservere.

TeX Live er kraftfuld, men stor og følsom over for forskelle på systemniveau. Når TeX Live pakkes i et Docker-image, bliver LaTeX-værktøjskæden forudsigelig, reproducerbar og nem at distribuere.

Nogle TeX Live-pakker er dog afhængige af shell-adgang. Af sikkerhedshensyn bør containeren køre i et begrænset miljø, der forhindrer brugere i at udføre vilkårlige shell-kommandoer (for eksempel via \write18 eller shell escape). Denne isolation beskytter værtssystemet og forhindrer utilsigtet adgang til containerens underliggende filsystem eller værktøjer som bash.

​

TeXLive Full Edition

TeXLive-Full@ayaka-notes er et komplet TeXLive Docker-image, der er designet til sandboxet LaTeX-kompilering i Ayakaleaf Pro, Overleaf CEP eller selvstændige LaTeX-kompileringsmiljøer.

Dette image sigter mod at levere en næsten komplet TeXLive-distribution med almindelige skrifttyper og værktøjer forudinstalleret for at minimere kompileringsfejl forårsaget af manglende pakker eller skrifttyper. Bemærk: Dette Docker-image indeholder ikke nogen sharelatex/overleaf-komponent. Det bruges til kompilering i Overleaf/Overleaf Pro.

​

Funktioner:

• 🚀 Understøtter både x86_64- og arm64-serverarkitekturer
• 📦 Fuld og optimeret TeXLive-installation
• 🧩 Forudinstallerede almindelige skrifttyper og værktøjer
• 🐳 Klar til brug med Docker og Docker Compose
• 🧪 Testet med Overleaf Server Pro / Overleaf Pro
• 🔄 Opdateres jævnligt med de nyeste TeXLive-udgaver
• 🏷 Flere TeXLive-versionstags (2020 – nyeste)
• 🧑‍🔬 Knitr-understøttelse af R-kode i LaTeX-dokumenter

​

Brug med Ayakaleaf Pro

TeX Live Full fra Ayaka-notes er specielt designet til ayakaleaf-pro. Hvis du er toolkit-bruger, kan du tilføje følgende miljøvariabler til filen config/variables.env.

For eksempel:

config/variables.env

ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1

​

TeX Live-versioner

Takket være GitHub Actions kan vi bygge alle TeX-images parallelt, herunder:

• ghcr.io/ayaka-notes/texlive-full:2026.1 (også tagget latest)
• ghcr.io/ayaka-notes/texlive-full:2025.1
• ghcr.io/ayaka-notes/texlive-full:2024.1
• ghcr.io/ayaka-notes/texlive-full:2023.1
• ghcr.io/ayaka-notes/texlive-full:2022.1
• ghcr.io/ayaka-notes/texlive-full:2021.1
• ghcr.io/ayaka-notes/texlive-full:2020.1
• ghcr.io/ayaka-notes/texlive-full:base

Vi bruger spejlarkivet fra texlive info, som indeholder næsten alle TeX Live-udgaver fra 1996 til 2025. Og takket være Overleafs Dockerfile kan vi bygge dette projekt hurtigere.

Hvorfor understøttes TeX Live 2019 og tidligere ikke?

Det er ekstremt vanskeligt at vedligeholde disse gamle images. Desuden giver webstedet texlive.info ikke oplysninger om TeX Live-versioner udgivet før 2019, så vi kan ikke bygge images til disse versioner. Hvis du har brug for en bestemt gammel version, så opret et issue og fortæl os det.

​

Indhold

Følgende pakker er inkluderet i Docker-imaget.

• Alle TeXLive-pakker (fra det pågældende år)
• R-pakker (kun udvalgte)
• fontconfig inkscape pandoc python3-pygments wget python3
• gnupg gnuplot perl-modules perl ca-certificates
• ghostscript qpdf r-base-core tar

Følgende skrifttyper er inkluderet i Docker-imaget.

• Google Fonts
• Microsoft msttcorefonts
• Skrifttyper understøttet af Overleaf

Kontrollér venligst, om de relevante skrifttyper må bruges kommercielt. Vi er ikke ansvarlige for juridiske problemer, der opstår som følge af forkert brug af skrifttyper. Når du downloader imaget, accepterer du automatisk dette.

​

Licens

MIT

​

Problemer

Problem 01: Manglende skrifttype i cachen

Når Overleaf kompilerer et LaTeX-projekt, og en skrifttype mangler, kan du opleve, at kompileringen tager lang tid. Det skyldes, at TeX Live forsøger at genopbygge hele skrifttypecachen, når en skrifttype mangler. Det er en tidskrævende proces.

I vores image har vi bygget skrifttypecachen på forhånd og løst dette problem med dette commit

Problem 02: SyncTeX er ekstremt langsom

Når du bruger dette image i sharelatex, kan du opleve, at SyncTeX er ekstremt langsom.

Se: https://github.com/overleaf/overleaf/issues/1150 — deaktiver blot HTTP 2.0.

Problem 03: Fejl ved genkompilering med det officielle TeX Live-image

Hvis du bruger det officielle TeX Live-image på Docker Hub, texlive/texlive, kan du opleve, at der rapporteres en fejl, når du genkompilerer et projekt. I vores image er dette problem dog løst, fordi vi bruger det nyeste Ubuntu-baseimage og installerer alle afhængigheder fra Ubuntus officielle repository.

​

Andre tekniske påmindelser

Når du bygger TeX Live-images (før 2019), skal du muligvis være opmærksom på følgende problemer:

• Før TeX Live 2017 understøttes kun http/ftp, så du kan ikke bruge https til at downloade, medmindre du ændrer peal-scriptet.
• Før 2015 leveres kun en sha256-fil. Du kan derfor ikke bruge sha512 til kontrol.