[[Vorlage(Getestet, focal, noble)]]

{{{#!vorlage Wissen
[:Pakete_installieren: Installation von Programmen]
[:mit Root-Rechten arbeiten:]
[:Terminal: Ein Terminal öffnen]
[:Packprogramme:Ein Archiv entpacken]
}}}

[[Inhaltsverzeichnis()]]

[[Bild(./tex_logo.png, 100, align=left)]]
Dieser Artikel dient als Ergänzung zu [:LaTeX:]. Die Distribution [http://www.tug.org/texlive TeX Live] {en} enthält alle wichtigen [:LaTeX#TeX:TeX]-Anwendungen, Makro-Pakete und Schriften. Die TeX-Erweiterungen [wikipedia:Pdftex:pdfTeX] und [wikipedia:XeTeX:] sind ebenfalls integriert. Sie ist damit aktuell die umfangreichste TeX-Distribution.

= Installation =
Es gibt verschiedene Möglichkeiten, TeX Live zu installieren. Sie werden im Folgenden kurz erläutert.

== Offizielle Paketquellen ==
TeX Live ist in den offiziellen Paketquellen enthalten, allerdings in unterschiedlichen Versionen. Welche jeweils für die eigene Ubuntu-Version zur Verfügung steht, kann man der Paketsuche entnehmen: [packages:texlive:] {en}

TeX Live kann dann mit den folgenden Paketen installiert werden [1]: 

{{{#!vorlage Paketinstallation
texlive, universe, beinhaltet ein vollständiges TeX-System mit zusätzlichen Schriften und häufig benutzten LaTeX-Paketen
texlive-lang-german, universe, optional, enthält die deutsche Sprachunterstützung
texlive-latex-extra, universe, optional, installiert viele zusätzliche LaTeX-Pakete
}}}

Will man eine minimale Installation vornehmen und die restlichen Pakete bei Bedarf installieren, wählt man das Paket: 

{{{#!vorlage Paketinstallation
texlive-base, universe
}}}
Für eine komplette Installation von TeX Live wählt man das Paket: 

{{{#!vorlage Paketinstallation
texlive-full, universe
}}}

{{{#!vorlage warnung
Bei der Installation von '''texlive-full''' werden ca. 4 GB heruntergeladen, weil alle Sprachdateien installiert werden.
}}}


== TeX Live DVD ==
Eine Variante der nachfolgend beschriebenen manuellen Installation ist die Offline-Nutzung einer DVD. Siehe [:TeX_Live_DVD-Installation:].

== Manuell ==
Da die durch Ubuntu-/Debian-Pakete zur Verfügung gestellten Pakete den Latex-Paketen auf dem CTAN-Server häufig eine gewisse Zeit hinterherhinken, kann es sich für erfahrene Benutzer empfehlen, TeX Live manuell zu installieren. Dies gilt besonders für Nutzer, die [:LaTeX#XeTeX:XeTeX] oder [:LaTeX#LuaTeX:LuaTeX] benutzen möchten oder sonstige aktuelle Pakete benötigen.

Dazu folgt hier eine Anleitung, die im Diskussionsforum zu dieser Seite entwickelt wurde. Obwohl einige Schritte über eine [:TeX_Live_DVD-Installation:grafische Oberfläche] ausgeführt werden könnten, wird hier nur das Vorgehen über das Terminal beschrieben:

 * Zunächst muss sichergestellt werden, dass alle TeX Live-Pakete aus den offiziellen Paketquellen deinstalliert sind, man kann zum Beispiel mit [:Synaptic:] nach `texlive` suchen oder den folgenden Befehl dafür nutzen:{{{#!vorlage Befehl
apt search texlive | grep -i install}}}
 * Einen temporären Ordner für die Installationsdateien erstellen und hinein wechseln:{{{#!vorlage Befehl
mkdir install-tl && cd install-tl
}}}
 * Das aktuelle Installationsskript herunterladen und im aktuellen Ordner entpacken:{{{#!vorlage Befehl
wget -O - -- http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz | tar xzf - --strip-components=1
}}}
 * Ggf. Terminalfenster maximieren, damit während der Installation alle Optionen sichtbar sind.
 * Installation starten; dieser Befehl benötigt Root-Rechte, um in das globale Wurzelverzeichnis '''/usr/local/texlive/''' installieren zu können, was allerdings auch während der Installation angepasst werden könnte (siehe [https://tug.org/texlive/doc/texlive-de/texlive-de.html#x1-270003.11 Übersicht der TeX Live-Verzeichnisstruktur] {de}): {{{#!vorlage Befehl 
sudo ./install-tl
}}}
 * Menüpunkt „Options“ wählen: [[Vorlage(Tasten, O)]]
 * Menüpunkt „create symlinks in standard directories“ wählen: [[Vorlage(Tasten, L)]]
 * Die drei darauf folgenden Anfragen für Pfadänderungen mit Enter bestätigen (also die Vorgaben annehmen)
 * Zurück ins Hauptmenu: [[Vorlage(Tasten, R)]]
 * Falls nicht alle Sprachen unterstützt werden sollen (z.B., um Speicherplatz zu sparen), kann man Sprachen im Untermenü [[Vorlage(Tasten, C)]] an-/abwählen
 * Im Menü des Installationsscripts kann außerdem festgelegt werden, dass nicht die volle TeX Live-Distribution (2,5 GiB) installiert werden soll, sondern nur eine kleinere Untermenge von Paketen: [[Vorlage(Tasten, S)]]
 * Schließlich, zum Installieren: [[Vorlage(Tasten, I)]]
 * Den Installations-Ordner löschen: {{{#!vorlage Befehl
cd .. && rm -ir install-tl
}}}

{{{#!vorlage Warnung
Die manuelle Installation geschieht außerhalb der Paketverwaltung von Ubuntu. Zudem kann es zu Schwierigkeiten kommen, da Pakete, welche LaTeX als Abhängigkeit haben (dazu gehören viele LaTeX-Editoren), nicht mehr ohne weiteres installiert werden können.

Umgehen lässt sich dieser Nachteil, wenn man abschließend ein [:Metapakete:Metapaket] mit allen Abhängigkeiten erzeugt, das auf die manuell installierte TeX-Live-Version verweist. Wie das geht, wird im Artikel [:TeX_Live_DVD-Installation#Paketverwaltung-die-neue-TeX-Live-Version-mitteilen:] ausführlich beschrieben.
}}}

= `tlmgr` – Der TeX Live Manager =

Der mitgelieferte "TeX Live Manager" (`tlmgr`) ist der Paketmanager des TeX Live-Systems; er installiert standardmäßig aus dem [https://ctan.org/ Comprehensive TeX Archive Network] {en} bzw. dessen Spiegelservern.
Seine Bedienung ist relativ simpel; es steht auch ein GUI zur Verfügung. Einen ersten Einstieg findet man in der offiziellen [http://www.tug.org/texlive/doc/texlive-de/texlive-de.html#x1-460006 Dokumentation] {de}, bzw. auf der mitinstallierten Manpage und der mittels `tlmgr --help` aufrufbaren Kommandozeilen-Hilfe.

Allerdings müssen bei systemweiter Installation noch Rechte verändert werden (oder man stuft gemäß [https://tex.stackexchange.com/a/203940 diesem Forenbeitrag] {en} den Ordner mit den ausführbaren Programmen von TeX Live als sicheren [:sudo:]-Pfad ein): 

{{{#!vorlage Befehl
sudo chown -hR BENUTZERNAME /usr/local/texlive/20xx 
}}}

Alternativ kann auch der ''user mode'' genutzt werden, mehr dazu weiter unten.

Die allgemeine Kommandozeilen-Syntax von `tlmgr` lautet:

{{{#!vorlage Befehl
tlmgr [OPTIONEN] BEFEHL [OPTIONEN] [PAKETNAME]
}}}

Das Operieren kann durch das Nutzen einer [:Shell:] vereinfacht werden, in der die `tlmgr`-Befehle direkt angegeben werden können:

{{{#!vorlage Befehl
tlmgr shell
}}}

Für eine grafische Oberfläche benötigt man das Paket

{{{#!vorlage Paketinstallation
perl-tk, universe
}}}

Anschließend wird die graphische Oberfläche mit dem folgenden Befehl gestartet:

{{{#!vorlage Befehl
tlmgr gui
}}}

[[Vorlage(Bildunterschrift, tlmgr.png, 150, "TeX Live Manager", right)]]

Es ist empfehlenswert und für `tlmgr` selbst sogar notwendig, regelmäßig Akutalisierungen einzuspielen: 

{{{#!vorlage Befehl
tlmgr update --self --all
}}}

Eine weitere häufigere Aufgabe ist das Suchen von und in Paketen, dass normalerweise nur auf lokal installierte Pakete angewendet wird, unter Angabe
der Option `--global` aber auch auf die Paketverzeichnisses des aktuell aktiven Repositoriums ausgeweitet werden kann:

{{{#!vorlage Befehl
tlmgr search --file <suchbegriff> # sucht in der lokalen Installation nach Dateien, die diesen Begriff beinhalten
tlmgr search --global --all <suchbegriff> # sucht in den Paketverzeichnissen in den Paket-Beschreibungen-, -Namen, und -Dateien nach dem Begriff
}}}

Neben den standardmäßig von Paketverwaltern gelieferten Befehlen bietet `tlmgr` auch fortgeschrittenere Einstellungsmöglichkeiten, etwa ''Pinning'' (ähnlich wie [:APT-Pinning:]) für den Umgang mit mehreren Repositorien.

Auch das Anlegen von separaten Paketbäumen als Teil des ''user mode'', für Benutzer die keine Schreibprivilegien für das Installationsziel haben, ist möglich. Die Pakete werden dann bei Nutzung der Option `--usermode` in dem in der Variable `TEXMFHOME`, also standardmäßig '''/home/BENUTZER/texmf''', verzeichneten Ort abgelegt. Vorher muss via `tlmgr init-usertree` die Basis-Struktur angelegt werden. Nicht installierbar sind darüber zwar Pakete, die ausführbare Programme enthalten, nebst einigen grundlegenden Paketen, dies ist aber die Minderheit. Außerdem ist das GUI (noch) nicht unterstützt, und einige Befehle verhalten sich anders. 


= Ergänzungen =

= Problembehebung =
== Ubuntu-Paket zu zugehörigem LaTeX-Paket finden ==
Fehlt ein LaTeX-Paket, kann über die [packages::Ubuntu-Paketsuche] unter ''"Search the contents of packages"'' der Paketinhalt aller Ubuntu-Pakete aus einer Distribution nach dem LaTeX-Paketnamen durchsucht werden. Kann z.B. das Paket `faktor` nicht gefunden werden, sucht man nach `faktor.sty` und bekommt dann das entsprechende Suchergebnis angezeigt: [http://packages.ubuntu.com/search?searchon=contents&keywords=faktor.sty&mode=exactfilename&suite=focal&arch=any faktor.sty] {en}
In der Spalte ''"Packages"'' stehen dann alle Ubuntu-Pakete, die diesen Dateinamen beinhalten.

Möchte man auch lokal (=offline) suchen können, kann [:apt-file:] verwendet werden.

= Links =
 * [http://www.tug.org/texlive/debian.html TeX Live and Debian/Ubuntu] {en}
 * [http://geofs.uni-muenster.de/geoinf/page/doku.php?id=tex-ecke:installation Manuelle vs. Quellen-Installation von TeX Live unter Ubuntu] {de} - einschließlich einer guten Beschreibung der Themen „Manuelle Installation“ und „Updates“, Universität Münster
 * [:TeX_Live_DVD-Installation:] - alternative Installationsanleitung
 * [:LaTeX:] {Übersicht} Übersichtsartikel

#tag: Büro, Programmierung, LaTeX