TeX Live aktualisieren

Aktualisieren Sie TeX Live oder installieren Sie Pakete in einer Overleaf Community Edition-Bereitstellung.

Die folgenden Anweisungen gelten nur für Community Edition-Installationen. Wir empfehlen Nutzerinnen und Nutzern von Ayakaleaf Pro dringend, Sandboxed Compiles zu aktivieren, da dies Zugriff auf nahezu dieselben TeX Live-Images bietet, die auf overleaf.com verwendet werden, und zudem für mehr Sicherheit die Kompilierungen der einzelnen Projekte voneinander isoliert.

Um Bandbreite zu sparen, enthalten sowohl die Images von Overleaf Community Edition als auch von Ayakaleaf Pro nur eine minimale Installation von TeX Live. Sie können weitere Pakete installieren oder auf eine vollständige TeX Live-Installation upgraden, indem Sie den Befehl tlmgr im Container sharelatex verwenden.

​

In den sharelatex-Container gelangen

Um eine Shell im Container sharelatex zu starten, führen Sie Folgendes aus:

bin/shell

Sie erhalten eine Eingabeaufforderung, die etwa so aussieht:

root@309b192d4030:/#

In den folgenden Anweisungen gehen wir davon aus, dass Sie sich im Container befinden.

​

Ihre aktuelle TeX Live-Version ermitteln

TeX Live wird jedes Jahr etwa im April veröffentlicht. Die Schritte zur Verwendung von tlmgr unterscheiden sich je nachdem, ob Sie die aktuelle oder eine ältere Version verwenden. Mit tlmgr --version können Sie prüfen, welche TeX Live-Version Sie verwenden. Diese Installation läuft beispielsweise mit TeX Live 2021:

# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 2021

Die aktuelle Version von TeX Live finden Sie auf der TeX Live-Homepage.

Wenn Sie eine ältere TeX Live-Version verwenden, haben Sie zwei Möglichkeiten. Eine neue Version des Overleaf-Docker-Images erscheint in der Regel kurz nach einer TeX Live-Veröffentlichung. Sie können entweder darauf warten und Ihre Bereitstellung mit dem Skript bin/upgrade aktualisieren, oder – falls Sie die ältere TeX Live-Version beibehalten möchten – Sie müssen tlmgr zunächst anweisen, ein historisches Repository zu verwenden. Eine Anleitung dazu finden Sie hier.

​

Pakete installieren

Um eine vollständige TeX Live-Installation einzurichten, führen Sie diesen Befehl im Container sharelatex aus:

tlmgr install scheme-full

Sie können auch einzelne Pakete manuell installieren:

tlmgr install tikzlings tikzmarmots tikzducks

Ab Version 3.3.0 ist es wieder erforderlich, nach jeder Verwendung von tlmgr install den Befehl tlmgr path add auszuführen, damit alle Binärdateien korrekt in den Systempfad verlinkt werden.

Es stehen viele weitere Befehle zur Verfügung. Mehr dazu erfahren Sie mit:

tlmgr help

Wenn Sie fertig sind, geben Sie exit ein oder drücken Sie Strg-D, um die Shell zu verlassen.

​

Ihre Änderungen speichern

Die soeben vorgenommenen Änderungen haben den Container sharelatex verändert, sind aber flüchtig – sie gehen verloren, wenn Docker Compose den Container neu erstellt, z. B. im Rahmen einer Konfigurationsänderung.

Um sie dauerhaft zu machen, speichern Sie die Änderungen mit docker commit in einem neuen Docker-Image:

cat config/version #5.2.1
docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full
echo 5.2.1-with-texlive-full > config/version

Passen Sie nach dem Commit der Änderungen config/version entsprechend an. Führen Sie dann bin/up aus, um den Container sharelatex neu zu erstellen.

Sie müssen diese Schritte bei jedem Upgrade auf eine neue Overleaf-Version wiederholen.