TeX Live i Docker

​

Docker

Docker gir en lett og portabel måte å pakke og kjøre applikasjoner i isolerte containere på. Ved å samle applikasjonen med alle nødvendige avhengigheter sikrer en container konsistent oppførsel på tvers av ulike maskiner, fra bærbare datamaskiner til produksjonsservere.

TeX Live er kraftig, men stort og følsomt for forskjeller på systemnivå. Når TeX Live pakkes i et Docker-image, blir LaTeX-verktøykjeden forutsigbar, reproduserbar og enkel å distribuere.

Enkelte TeX Live-pakker er imidlertid avhengige av skalltilgang. Av sikkerhetshensyn bør containeren kjøre i et begrenset miljø som hindrer brukere i å kjøre vilkårlige skallkommandoer (for eksempel via \write18 eller shell escape). Denne isolasjonen beskytter vertssystemet og forhindrer utilsiktet tilgang til containerens underliggende filsystem eller verktøy som bash.

​

TeXLive Full Edition

TeXLive-Full@ayaka-notes er et fullverdig TeXLive-Docker-image laget for sandboxed LaTeX-kompilering i Ayakaleaf Pro, Overleaf CEP eller frittstående LaTeX-kompileringsmiljøer.

Dette imaget har som mål å tilby en nesten komplett TeXLive-distribusjon med vanlige skrifter og verktøy forhåndsinstallert, for å minimere kompileringsfeil forårsaket av manglende pakker eller skrifter. Merk: Dette Docker-imaget inneholder ingen sharelatex/overleaf-komponenter. Det brukes til kompilering i Overleaf/Overleaf Pro.

​

Funksjoner:

• 🚀 Støtter både x86_64- og arm64-serverarkitekturer
• 📦 Full og optimalisert TeXLive-installasjon
• 🧩 Vanlige skrifter og verktøy forhåndsinstallert
• 🐳 Klar til bruk med Docker og Docker Compose
• 🧪 Testet med Overleaf Server Pro / Overleaf Pro
• 🔄 Oppdateres jevnlig med de nyeste TeXLive-utgivelsene
• 🏷 Flere TeXLive-versjonstagger (2020 – nyeste)
• 🧑‍🔬 Knitr-støtte for R-kode i LaTeX-dokumenter

​

Bruk med Ayakaleaf Pro

TeX Live Full fra Ayaka-notes er spesielt laget for ayakaleaf-pro. Hvis du er Toolkit-bruker, kan du legge til følgende miljøvariabler i 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-versjoner

Takket være GitHub Action kan vi bygge alle TeX-images parallelt, blant annet:

• ghcr.io/ayaka-notes/texlive-full:2026.1 (også taggen 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 bruker speilarkivet fra texlive info, som inneholder nesten alle TeX Live-images fra 1996 til 2025. Og takket være Overleafs Dockerfile kan vi bygge dette prosjektet raskere.

Hvorfor støttes ikke TeX Live 2019 og eldre?

Det er svært vanskelig å vedlikeholde disse gamle imagene. I tillegg gir nettstedet texlive.info ikke informasjon om TeX Live-versjoner utgitt før 2019, så vi kan ikke bygge images for disse versjonene. Hvis du trenger en bestemt gammel versjon, kan du opprette en issue og gi oss beskjed.

​

Inkluderte komponenter

Følgende pakker er inkludert i Docker-imaget.

• Alle TeXLive-pakker (for det aktuelle året)
• R-pakker (kun et utvalg)
• fontconfig inkscape pandoc python3-pygments wget python3
• gnupg gnuplot perl-modules perl ca-certificates
• ghostscript qpdf r-base-core tar

Følgende skrifter er inkludert i Docker-imaget.

• Google Fonts
• Microsoft msttcorefonts
• Skrifter som støttes av Overleaf

Kontroller om de aktuelle skriftene kan brukes kommersielt. Vi er ikke ansvarlige for eventuelle juridiske problemer som følge av feil bruk av skrifter. Når du laster ned imaget, godtar du dette automatisk.

​

Lisens

MIT

​

Problemer

Problem 01: Manglende treff i skrifthurtigbufferen

Når Overleaf kompilerer et LaTeX-prosjekt og en skrift mangler, kan du oppleve at kompileringen tar lang tid. Det skyldes at TeX Live, når en skrift mangler, prøver å bygge hele skrifthurtigbufferen på nytt. Dette er en tidkrevende prosess.

I imaget vårt har vi forhåndsbygget skrifthurtigbufferen; vi løste dette problemet med denne commiten

Problem 02: SyncTeX er ekstremt tregt

Når du bruker dette imaget i sharelatex, kan du oppleve at SyncTeX er ekstremt tregt.

Se: https://github.com/overleaf/overleaf/issues/1150 – deaktiver ganske enkelt HTTP 2.0.

Problem 03: Feil ved ny kompilering med det offisielle TeX Live-imaget

Hvis du bruker det offisielle TeX Live-imaget texlive/texlive fra Docker Hub, kan du oppleve at det rapporteres en feil når du kompilerer et prosjekt på nytt. I vårt image er dette problemet imidlertid løst, fordi vi bruker det nyeste Ubuntu-baseimaget og installerer alle avhengigheter fra Ubuntus offisielle repository.

​

Andre tekniske påminnelser

Når du bygger TeX Live-images (før 2019), må du være oppmerksom på følgende problemer:

• Før TeX Live 2017 støttes bare http/ftp, så du kan ikke bruke https til nedlasting med mindre du endrer peal-skriptet.
• Før 2015 finnes bare sha256-filer. Du kan derfor ikke bruke sha512 til kontroll.