TeX Live v Dockeru

​

Docker

Docker nabízí odlehčený a přenositelný způsob, jak zabalit a spouštět aplikace v izolovaných kontejnerech. Díky tomu, že kontejner obsahuje aplikaci spolu se všemi potřebnými závislostmi, zajišťuje konzistentní chování na různých strojích, od notebooků až po produkční servery.

TeX Live je výkonný, ale rozsáhlý a citlivý na rozdíly na úrovni systému. Zabalení TeX Live do Docker image činí nástrojový řetězec LaTeXu předvídatelným, reprodukovatelným a snadno distribuovatelným.

Některé balíčky TeX Live však spoléhají na přístup k shellu. Z bezpečnostních důvodů by měl kontejner běžet v omezeném prostředí, které uživatelům znemožní spouštět libovolné příkazy shellu (například prostřednictvím \write18 nebo shell escape). Tato izolace chrání hostitelský systém a zabraňuje nechtěnému přístupu k souborovému systému kontejneru nebo k nástrojům jako bash.

​

Edice TeXLive Full

TeXLive-Full@ayaka-notes je plnohodnotný TeXLive Docker image navržený pro sandboxovou kompilaci LaTeXu v Ayakaleaf Pro, Overleaf CEP nebo v samostatných prostředích pro kompilaci LaTeXu.

Cílem tohoto image je poskytnout téměř kompletní distribuci TeXLive s předinstalovanými běžnými fonty a nástroji, aby se minimalizovala selhání kompilace způsobená chybějícími balíčky nebo fonty. Poznámka: Tento Docker image neobsahuje žádnou komponentu sharelatex/overleaf. Slouží ke kompilaci v Overleaf/Overleaf Pro.

​

Funkce:

• 🚀 Podpora serverových architektur x86_64 i arm64
• 📦 Úplná a optimalizovaná instalace TeXLive
• 🧩 Předinstalované běžné fonty a nástroje
• 🐳 Připraveno k použití s Dockerem a Docker Compose
• 🧪 Otestováno s Overleaf Server Pro / Overleaf Pro
• 🔄 Pravidelně aktualizováno podle nejnovějších vydání TeXLive
• 🏷 Více tagů verzí TeXLive (2020 – nejnovější)
• 🧑‍🔬 Podpora Knitr pro kód v jazyce R v dokumentech LaTeX

​

Použití s Ayakaleaf Pro

TeX Live Full od Ayaka-notes je navržen speciálně pro ayakaleaf-pro. Pokud jste uživatelem toolkitu, můžete do souboru config/variables.env přidat následující proměnné prostředí.

Například:

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

​

Verze TeX Live

Díky GitHub Action můžeme sestavovat všechny TeXové image paralelně, mezi ně patří:

• ghcr.io/ayaka-notes/texlive-full:2026.1 (také tag 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

Používáme zrcadlový archiv z texlive info, který obsahuje téměř všechny image TeX Live z let 1996 až 2025. A díky Dockerfile od Overleaf můžeme tento projekt sestavovat rychleji.

Proč nejsou podporovány TeX Live 2019 a starší?

Údržba těchto starých image je nesmírně obtížná. Web texlive.info navíc neposkytuje informace o verzích TeX Live vydaných před rokem 2019, takže pro tyto verze nemůžeme image sestavit. Pokud potřebujete konkrétní starou verzi, založte prosím issue a dejte nám vědět.

​

Obsažené komponenty

Docker image obsahuje následující balíčky.

• Všechny balíčky TeXLive (z daného roku)
• Balíčky R (pouze vybrané)
• fontconfig inkscape pandoc python3-pygments wget python3
• gnupg gnuplot perl-modules perl ca-certificates
• ghostscript qpdf r-base-core tar

Docker image obsahuje následující fonty.

• Google Fonts
• Microsoft msttcorefonts
• Fonty podporované v Overleaf

Ověřte si prosím, zda lze příslušné fonty používat komerčně. Neneseme odpovědnost za jakékoli právní problémy vyplývající z nesprávného použití fontů z vaší strany. Stažením image s tím automaticky souhlasíte.

​

Licence

MIT

​

Problémy

Problém 01: Chybějící položky v cache fontů

Pokud při kompilaci projektu LaTeX v Overleaf chybí nějaký font, můžete zjistit, že kompilace trvá velmi dlouho. Je to proto, že když font chybí, pokusí se texlive znovu sestavit celou cache fontů. Jde o časově náročný proces.

V našem image je cache fontů předem sestavena; tento problém jsme vyřešili tímto commitem

Problém 02: Extrémně pomalý SyncTeX

Když tento image použijete v sharelatex, můžete zjistit, že SyncTeX je extrémně pomalý.

Viz: https://github.com/overleaf/overleaf/issues/1150, stačí vypnout HTTP 2.0.

Problém 03: Chyba při opakované kompilaci s oficiálním image TeX Live

Pokud používáte oficiální image TeX Live z Docker Hubu texlive/texlive, můžete zjistit, že při opakované kompilaci projektu se hlásí chyba. V našem image je však tento problém opraven, protože používáme nejnovější základní image Ubuntu a všechny závislosti instalujeme z oficiálního repozitáře Ubuntu.

​

Další technické poznámky

Při sestavování image TeX Live (starších než 2019) je třeba dát pozor na následující problémy:

• Před TeX Live 2017 je podporováno pouze http/ftp, takže pro stahování nelze použít https, pokud neupravíte skript peal.
• Před rokem 2015 je k dispozici pouze soubor sha256, takže pro kontrolu nelze použít sha512.