# LaTeX-Engines und Pakete

Wählen Sie Tectonic oder einen latexmk-Compiler, nutzen Sie eine bestehende TeX-Distribution oder installieren Sie das von Oleafly verwaltete TinyTeX.

Oleafly liefert Tectonic mit und kann auch über `latexmk` kompilieren. Das Compiler-Menü des Projekts steuert die täglichen Builds. **Einstellungen → Engines** zeigt die TeX-Distributionen und Pakete, die auf Ihrem Rechner verfügbar sind.

## Tectonic: die Alltags-Engine

**Tectonic** ist die Standard-Engine zum Kompilieren, bis Sie unter **Standard-Engine zum Kompilieren** in **Einstellungen → Engines → LaTeX** eine andere wählen. Sie braucht keine separate Installation, lädt Pakete bei Bedarf nach und speichert sie für die Offline-Nutzung zwischen. Sie passt zu den meisten Projekten und bleibt verfügbar, auch wenn keine System-TeX-Distribution installiert ist. Siehe [Einen Standard für neue Projekte festlegen](/docs/engines/#set-a-default-for-new-projects).

Für **getaggte PDFs** verwenden Sie den LuaLaTeX-Workflow. Tags beschreiben die Dokumentstruktur für unterstützende Technologien. Prüfen Sie das Ergebnis nach dem Kompilieren mit Preflight.

### Schriften in der eingebauten Engine

Tectonic basiert auf XeTeX, das Schriftdateien direkt liest. Oleafly passt ein paar Dinge an, damit Dokumente, die für pdfLaTeX geschrieben sind, ihre Schriften und ihren Text behalten:

- Times, Helvetica, Courier, Palatino, Bookman, New Century Schoolbook und Avant Garde verwenden ihre TeX-Gyre-Versionen, statt auf Latin Modern zurückzufallen.
- `\usepackage[T1]{fontenc}` bringt auf dieser Engine getippte Akzente und Symbole durcheinander, deshalb hält Oleafly das Dokument bei Unicode-Text. Gibt es eine Schrift, die das Dokument nutzt, nur in T1, bleibt das Dokument bei T1, und die Kompilierung warnt, dass Zeichen wie ß, §, «, geschwungene Anführungszeichen und € falsch gedruckt werden oder verschwinden können. Die Warnung gibt eine Fassung der Zeile an, die T1 nur unter pdfLaTeX lädt:

  ```latex
  \usepackage{iftex}
  \ifPDFTeX
    \usepackage[T1]{fontenc}
  \fi
  ```

- Ein Dokument, das `\pdfoutput=1` setzt, wie arXiv es verlangt, wird unverändert kompiliert.
- Ein `ctex`-Dokument, das kein `fontset` setzt, bekommt die Fandol-Schriften und sieht deshalb auf jedem Rechner gleich aus. Fügen Sie `fontset=mac` zu den Klassenoptionen hinzu, um die eigenen Schriften des Mac zu verwenden.
- Schriften, die mit der eingebauten Engine kommen, werden über den Dateinamen gefunden. `\setmainfont{UnBatang}` scheitert, und die Fehlermeldung sagt Ihnen, stattdessen `UnBatang.ttf` zu schreiben.

Der Offline-Modus überspringt die Anpassungen von Schriften und Kodierung, deshalb kann ein Offline-Build eines solchen Dokuments anders aussehen als ein Online-Build.

## latexmk und System-TeX

Wählen Sie pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX oder pLaTeX aus dem Compiler-Menü eines Projekts, wenn das Projekt von einem traditionellen TeX-Live- oder MiKTeX-Workflow abhängt. Oleafly führt diese Compiler über `latexmk` aus. **Auto** liest die Hauptdatei und wählt einen davon: Eine Zeile `% !TeX program = xelatex` am Anfang hat Vorrang, dann japanische Klassen, dann Pakete, die XeLaTeX oder LuaLaTeX brauchen, etwa `fontspec`, `ctex`, `xeCJK` oder `luatexko`. Entscheidet die Hauptdatei das nicht, prüft Auto zusätzlich eine `latexmkrc` im Projekt und die Dateien, die die Präambel lädt. Alles andere läuft mit pdfLaTeX. Braucht ein Paket einen anderen Compiler als den, den Auto gewählt hat, bietet die Kompilierung den Wechsel an, etwa mit **XeLaTeX verwenden**.

Es gibt zwei Wege, diese Toolchain bereitzustellen:

1. **Eine bestehende Installation verwenden.** Oleafly erkennt MacTeX, TeX Live, MiKTeX und TinyTeX auf Ihrem System. Es sucht im selben `PATH`, den auch Ihr Terminal nutzt, und unter Windows zusätzlich in den `Path`-Einstellungen des Systems und des Benutzers, sodass ein von Hand installiertes TeX auch dann gefunden wird, wenn die App über das Dock oder das Startmenü geöffnet wurde. Eine System-Installation hat nur dann Vorrang vor der von Oleafly verwalteten Kopie, wenn ihr Binärverzeichnis `latexmk`, pdfLaTeX, XeLaTeX, LuaLaTeX, `kpsewhich` und Biber enthält. Eine Teilinstallation kann einer funktionierenden verwalteten TinyTeX nicht stillschweigend den Rang ablaufen.
2. **Verwaltetes TinyTeX installieren.** Der Download umfasst etwa 250 MB und braucht keine Administratorrechte. Siehe [TinyTeX installieren und aktualisieren](#install-and-update-tinytex).

**TeX-Distributionen verwalten** unter **Einstellungen → Engines → LaTeX** listet jede Distribution auf, die Oleafly gefunden hat. **In Verwendung** kennzeichnet die, mit der `latexmk` kompiliert, und ein Abzeichen **latexmk** markiert jede, die kompilieren kann. Wählen Sie in einer anderen Zeile **Für Kompilierläufe verwenden**, um zu ihr zu wechseln. Die gewählte Zeile zeigt dann **Automatisch**, womit Oleafly wieder selbst wählt: zuerst ein vollständiges System-TeX, dann TinyTeX.

Ist TeX in einem Ordner installiert, in dem Oleafly nicht sucht, klicken Sie auf **TeX-Ordner wählen** und wählen Sie den Ordner, in dem `latexmk` liegt, oder den TeX-Live-Jahresordner darüber, etwa `texlive/2026`. Oleafly findet `latexmk` darin und kompiliert mit dieser Installation, die die Liste als **In Verwendung** kennzeichnet. **Automatisch** macht die Wahl rückgängig. Hat der Ordner kein `latexmk`, sagt die Meldung, welchen Ordner Sie stattdessen wählen sollen.

`latexmk` ist keine Dateisystem-Sandbox. Selbst mit blockierten Shell-Befehlen kann TeX Dateien lesen, die Ihrem Konto zur Verfügung stehen. Oleafly deaktiviert außerdem `.latexmkrc`-Dateien des Projekts, des Benutzers und des Systems, weil sie ausführbares Perl sind. Verwenden Sie System-TeX nur für Projekte, denen Sie vertrauen. Ein importiertes Projekt verwendet System-TeX nur, wenn Sie es wählen, entweder als Standard-Engine zum Kompilieren oder über das Compiler-Menü des Projekts. Ein an Ort und Stelle geöffneter Ordner bleibt bei Tectonic, bis Sie ihm vertrauen.

### Wenn kein TeX installiert ist

Wählen Sie pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, pLaTeX oder Auto auf einem Rechner ohne funktionierende TeX-Distribution, öffnet sich ein Dialog mit dem Titel **Dieser Compiler braucht eine funktionierende TeX-Distribution**. Er zeigt drei Optionen, in dieser Reihenfolge:

- **TinyTeX herunterladen**, markiert als **Empfohlen**. **TinyTeX laden und verwenden** installiert TinyTeX und kompiliert das Projekt damit.
- **Mein System-LaTeX verwenden (latexmk)**, was angibt, dass keine TeX-Distribution gefunden wurde oder warum die auf diesem Rechner nicht kompilieren kann. Es hat keine Schaltfläche.
- **Weiter Tectonic verwenden**. **Zurück zu Tectonic wechseln** stellt das Projekt wieder auf die eingebaute Engine.

Kompilieren Sie zuerst, bietet die Vorschau denselben Ausweg an: **TinyTeX laden und verwenden**, **Tectonic verwenden** und **Engine-Einstellungen öffnen**. Eine Kompilierung, die Sie starten, während TinyTeX noch lädt, wartet und startet von selbst, sobald die Installation fertig ist.

Dasselbe Angebot erscheint, wenn eine TeX-Distribution da ist, aber kein `latexmk` hat. Fehlen der Distribution `latexmk`, der gewählte Compiler oder Biber, nennt die Meldung außerdem, was zu installieren ist, sofern Oleafly die Distribution kennt, etwa `sudo tlmgr install latexmk` bei MacTeX oder `sudo apt install latexmk` unter Ubuntu.

In einem gemeinsamen Projekt heißt die Schaltfläche **Tectonic für alle verwenden**, weil der Compiler im Projekt gespeichert ist und sich für jeden Koautor ändert. Die Installation von TinyTeX ändert nur Ihren Rechner.

### TinyTeX installieren und aktualisieren

Öffnen Sie **Einstellungen → Engines → LaTeX** und wählen Sie unter **TeX-Distributionen verwalten** den Eintrag **TinyTeX herunterladen (~250 MB)**, oder nutzen Sie das Angebot im Kompilierdialog. TinyTeX ist ein kompaktes TeX Live, das keine Administratorrechte braucht. Journal-Vorlagen können später Pakete hinzufügen, insgesamt bis zu etwa 1 GB, und Oleafly prüft vor dem Start, ob etwa 2 GB Speicherplatz frei sind. TinyTeX wird unter `~/.oleafly/tinytex` installiert.

- **Abbrechen** stoppt den Download und behält, was bereits angekommen ist. Die Schaltfläche heißt dann **Download fortsetzen** und zeigt die bereits geladene Menge. Beenden Sie Oleafly während der Installation, pausiert sie auf dieselbe Weise und läuft beim nächsten Öffnen der App weiter.
- Der Download kommt zuerst von Oleaflys Mirror, dann von GitHub. Schlägt eine Quelle fehl oder sendet sie eine Minute lang keine Daten, wechselt Oleafly zur nächsten und macht dort weiter, wo es aufgehört hat. Unter **Einstellungen → Downloads → Quellen** ändern Sie, woher Downloads kommen. Siehe [Reiter Quellen](/docs/settings/downloads/#sources-tab).
- Ist das verwaltete TinyTeX älter als das Release, das diese Version von Oleafly erwartet, zeigt seine Zeile **Aktualisieren**. **Entfernen** löscht es.

Ist bereits eine andere Distribution **In Verwendung**, wechselt die Installation von TinyTeX nicht zu ihm. Wählen Sie in der Zeile von TinyTeX **Für Kompilierläufe verwenden**, wenn es kompilieren soll.

Unter Linux läuft TinyTeX mit dem Perl des Systems. Oleafly prüft auf Perl, bevor es etwas herunterlädt. Fehlt Perl oder eines seiner Standardmodule, nennt die Meldung den Befehl zur Installation: `sudo apt install perl`, `sudo dnf install perl` oder `sudo pacman -S perl`.

Unter Windows kann TeX Live nicht aus einem Ordner laufen, dessen Name Buchstaben mit Akzent oder nichtlateinische Buchstaben enthält. Hat Ihr Benutzerordner so einen Namen, legt Oleafly TinyTeX stattdessen in einem Ordner unter ProgramData ab. Hält ein Virenschutz eine Datei offen, während TinyTeX an seinen Platz verschoben wird, versucht Oleafly es erneut, und wenn es trotzdem nicht fertig wird, warten Sie einen Moment und wiederholen Sie die Installation.

### MiKTeX und Perl

Das `latexmk` von MiKTeX ist ein Perl-Skript, und MiKTeX bringt kein Perl mit. Ohne Perl markieren die Einstellungen MiKTeX mit **latexmk braucht Perl**, und Oleafly kompiliert stattdessen mit TinyTeX, wenn es installiert ist. Gibt es nichts anderes, stoppt die Kompilierung und zeigt drei Wege weiter: TinyTeX unter **Einstellungen → Engines → LaTeX** installieren, das ein eigenes Perl mitbringt, Strawberry Perl installieren oder das Projekt wieder auf Tectonic stellen.

MiKTeX verwaltet seine Pakete in der MiKTeX Console, deshalb gelten die Liste **Pakete** und **Finden und installieren** dort nicht. MiKTeX wandelt EPS-Abbildungen außerdem nicht beim Kompilieren um, wandeln Sie sie also zuerst in PDF um oder nutzen Sie TinyTeX.

### Japanische Dokumente: upLaTeX und pLaTeX

Wählen Sie **upLaTeX** oder **pLaTeX** unter **Compiler (dieses Projekt)** für ein japanisches Dokument, oder lassen Sie den Compiler auf **Auto**. Auto wählt pLaTeX für `jsarticle`, `jsbook` und `jsreport` (upLaTeX, wenn die Klasse die Option `uplatex` hat), upLaTeX für die `uj`-Klassen und `jlreq` und LuaLaTeX für `ltjsarticle` und andere LuaTeX-ja-Dokumente.

Beide Compiler brauchen die japanische Unterstützung von TeX Live. Fehlt sie im verwalteten TinyTeX oder in einem TeX Live, in das Oleafly schreiben kann, bietet die gescheiterte Kompilierung **Japanische Unterstützung installieren (rund 450 MB)** an. Das installiert sie und kompiliert erneut. Bei anderen Installationen nennt die Meldung den Befehl für Ihre Distribution, etwa `sudo apt install texlive-lang-japanese`.

## Wenn Tectonic nicht reicht

Manche Dokumente brauchen Dinge, die die eingebaute Tectonic-Engine nicht kann, etwa EPS-Abbildungen oder einen erzwungenen `pdftex`-Treiber. Wenn die erste Kompilierung nach dem Öffnen eines Projekts oder eine Kompilierung, die Sie selbst starten, auf eines davon stößt, öffnet sich der Engine-Dialog von selbst. Startet Auto-Kompilieren oder ein Agent die Kompilierung, bleibt der Dialog geschlossen, und stattdessen erscheint **Engine wählen**. Wählen Sie es, um den Dialog zu öffnen. Die Schaltfläche bleibt bis zur nächsten Kompilierung, öffnet den Dialog also auch erneut, nachdem Sie ihn geschlossen haben. Wo Sie sie finden, hängt von der Ansicht ab:

- Nach einer fehlgeschlagenen Kompilierung steht sie rechts in der Vorschau-Werkzeugleiste, solange **Protokolle** geöffnet ist. Die Vorschau wechselt von selbst zu **Protokolle**, wenn die Kompilierung kein PDF erzeugt hat. Zeigt sie noch ein PDF, wählen Sie **Protokolle**, um die Schaltfläche zu sehen.
- In einer leeren Vorschau steht sie neben **Erneut kompilieren**.
- In der reinen Editor-Ansicht, wenn das PDF in einem eigenen Fenster liegt, oder nach einer erfolgreichen Kompilierung steht sie links von **Neu kompilieren**.

Der Dialog trägt den Titel **Dieses Kompilieren braucht mehr als die eingebaute Engine** und listet die gefundenen Probleme auf. Die Option mit der Markierung **Empfohlen** steht zuerst:

- **TinyTeX herunterladen** erscheint, wenn keine funktionierende TeX-Distribution installiert ist. Seine Schaltfläche **TinyTeX laden und verwenden** installiert TinyTeX, stellt das Projekt auf `latexmk` um und kompiliert erneut.
- **Mein System-LaTeX verwenden (latexmk)** hat **System-LaTeX verwenden**, was das Projekt auf `latexmk` mit der von Oleafly gefundenen TeX-Distribution umstellt. Braucht das Dokument pdfLaTeX, lautet die Option **pdfLaTeX auf meinem System-LaTeX verwenden (latexmk)** und ihre Schaltfläche **Zu pdfLaTeX wechseln und neu kompilieren**. Ohne installiertes TeX hat diese Option keine Schaltfläche.
- **Weiter Tectonic verwenden** hat **Bei Tectonic bleiben**, was das Projekt auf der eingebauten Engine lässt. Würde ein Wechsel die Probleme beheben, die der Dialog auflistet, sagt diese Option, dass sie nicht verschwinden.

Haben Sie Tectonic beibehalten, öffnen dieselben Probleme für dieses Projekt auf diesem Rechner den Dialog nicht mehr und zeigen auch kein **Engine wählen** mehr. Um später zu wechseln, wählen Sie einen Compiler unter **Compiler (dieses Projekt)**.

Wenn das Projekt außerdem externe Befehle ausführen muss, erlaubt der Wechsel zu System-LaTeX oder TinyTeX auch diese, und der Dialog weist vor dem Klick darauf hin. Der gewählte Compiler wird im Projekt gespeichert, Koautoren erhalten also dieselbe Einrichtung.

## Externe Befehle erlauben

Pakete wie `minted` und PythonTeX sowie Dokumente, die `\write18` verwenden, führen beim Kompilieren andere Programme aus. Oleafly blockiert das standardmäßig. Wenn eine Kompilierung blockiert wird oder das Protokoll zeigt, dass das Projekt diese Befehle braucht, bietet ein Banner über dem Editor **Externe Befehle erlauben** an.

Die eingebaute Engine behält diese Sperre ebenfalls bei. Tectonic startet außerhalb des Projektordners, und das Biber, das mit Oleafly kommt, behandelt die Literaturverzeichnis-Einstellungen eines Dokuments als reinen Text und überspringt `biber.conf` während einer Kompilierung.

Erlauben Sie externe Befehle nur für ein Projekt, dessen Dateien Sie vertrauen, weil LaTeX dann jedes Programm mit Ihren Berechtigungen ausführen kann. Die Berechtigung funktioniert nur mit System-LaTeX und bleibt auf diesem Rechner. Sie wird nie in `project.json` gespeichert oder an Git übergeben, Koautoren müssen sie also auf ihren eigenen Rechnern erlauben. In einem [gemeinsamen Projekt](/docs/collaboration/) warnt Oleafly Sie, bevor es sie einschaltet, weil jeder, der das Projekt bearbeiten kann, dann beim Kompilieren Programme auf Ihrem Rechner ausführen könnte. Das Zurückschalten des Projekts auf Tectonic oder sein Löschen entfernt die Berechtigung. In einem an Ort und Stelle geöffneten Ordner vertrauen Sie zuerst dem Ordner. Einem Ordner zu vertrauen erlaubt für sich allein keine externen Befehle.

Wenn eine Engine vorhanden ist, kann die Schaltfläche **Getaggt kompilieren und prüfen** im [Preflight](/docs/preflight/)-Panel mit LuaLaTeX ein getaggtes PDF erzeugen und es sofort prüfen, in einem Schritt. Sie bevorzugen Ihre eigene Toolchain? **Für barrierefreien Export vorbereiten** in Preflight schreibt Ihren Quelltext fürs Tagging um, und Sie kompilieren ihn mit einem beliebigen LuaLaTeX aus TeX Live 2026 oder einem TeX Live, das seit November 2025 aktualisiert wurde, außerhalb der App.

## Zeichen fehlen im PDF

TeX lässt jedes Zeichen aus, für das seine Schrift keine Glyphe hat, und die Kompilierung gelingt trotzdem. Ein koreanischer, chinesischer oder japanischer Absatz kann ohne Fehler leer herauskommen. Oleafly liest das Protokoll nach jeder Kompilierung. Fehlen Zeichen, erhalten Sie einmal pro Projekt einen Hinweis, das Protokoll listet sie unter **Fehlende Zeichen** auf, und die Warnung nennt einige davon.

Bei der eingebauten Engine und bei XeLaTeX gibt die Warnung außerdem für jede gefundene Schrift eine Einrichtung an, die Schriften nutzt, die mit der eingebauten Engine kommen. Fügen Sie die passende in die Präambel ein:

```latex
% Korean
\usepackage[space]{xeCJK}
\setCJKmainfont[AutoFakeBold]{UnBatang.ttf}

% Simplified Chinese
\usepackage{xeCJK}
\setCJKmainfont[AutoFakeBold]{gbsn00lp.ttf}

% Traditional Chinese
\usepackage{xeCJK}
\setCJKmainfont[AutoFakeBold]{bsmi00lp.ttf}

% Japanese
\usepackage{xeCJK}
\setCJKmainfont{ipaexm.ttf}[BoldFont=ipaexg.ttf]
```

Die Option `space` erhält die Leerzeichen zwischen koreanischen Wörtern, die einfaches `xeCJK` weglässt.

`CJKutf8` und das Paket `CJK` funktionieren nur mit pdfLaTeX. Ein Projekt, das sie in der eingebauten Engine lädt, wird ohne seinen chinesischen, japanischen oder koreanischen Text kompiliert, deshalb bietet der Hinweis **Engine wählen** an, was den Wechsel zu pdfLaTeX öffnet. Sie können auch das Paket und seine `CJK`-Umgebung entfernen und eine der obigen Einrichtungen verwenden.

Ein `ctex`-Dokument auf einem Mac, das die eigenen Schriften des Mac nutzt, kann macOS fragen lassen, ob eine Schrift geladen werden soll, und die Kompilierung wartet auf Ihre Antwort. Beantworten Sie den Dialog und kompilieren Sie erneut, oder fügen Sie `fontset=fandol` zu den Optionen von `\documentclass` hinzu.

Andere fehlende Zeichen, etwa ein Symbol oder ein Buchstabe aus einer anderen Schrift, brauchen eine Schrift, die sie hat. Wechseln Sie in der Präambel zu einer solchen. Für Typst-Projekte siehe [Zeichen, die als Kästchen erscheinen](/docs/typst/#characters-that-show-as-boxes).

## Die Paketverwaltung

Unter dem Engine-Status befindet sich eine filterbare **Pakete**-Liste für die LuaLaTeX-Seite, die auf `tlmgr` basiert:

- Beginnen Sie mit der vorgeschlagenen Paketliste, oder geben Sie mindestens zwei Zeichen ein und wählen Sie **TeX Live durchsuchen**, um den vollständigen Katalog abzufragen.
- Suchen Sie nach einem Paketnamen oder einer Datei, die ein Paket enthält. Oleafly zeigt das besitzende TeX-Live-Paket an, wenn sich die Namen unterscheiden.
- **Hinzufügen** oder **Entfernen** eines Pakets mit einem Klick. Installierte Zeilen zeigen, ob das Paket im Systembaum, in Ihrem persönlichen Baum oder in beiden liegt.
- Prüfen Sie vor einem barrierefreien Export das Tagging-Abzeichen: **Tagging: Vorsicht** markiert Pakete, die die Tag-Qualität mindern können, während **verhindert Tagging** bekannte Konflikte markiert.

Diese Paketverwaltung gilt für TeX-Live- und TinyTeX-Distributionen, die von `latexmk` verwendet werden. Tectonic verwaltet seinen eigenen Paketcache. Für MiKTeX verwenden Sie die MiKTeX Console.

### Fehlende Datei beheben

Ein Paket ist nicht immer nach der Datei benannt, die in einem Kompilierprotokoll genannt wird. So wird zum Beispiel `tikz.sty` vom Paket `pgf` installiert. Ein geratenes Paket namens `tikz` zu installieren würde scheitern.

Wenn eine `latexmk`-Kompilierung eine fehlende Datei meldet, verwenden Sie **Finden und installieren** in der Nachricht. Das umfasst Pakete, Klassen, bibliografische Stile, Schriftdateien, babel-Sprachdateien und TikZ-Bibliotheken. Oleafly fragt TeX Live, welches Paket die Datei besitzt, installiert dieses Paket und kompiliert neu. Hat kein TeX-Live-Paket die Datei, stammt sie wahrscheinlich aus der Vorlage Ihrer Universität oder Ihres Verlags, fügen Sie sie also aus der Originalvorlage zum Projekt hinzu. Haben mehrere Pakete sie, listet die Meldung diese auf, damit Sie das wählen können, das Ihre Vorlage braucht. Ist der Katalog nicht erreichbar oder behebt die Installation die Kompilierung nicht, sagt die Meldung, welcher Fall vorliegt.

Wenn Sie versuchen, eine System-Installation ohne Berechtigung zu ändern, kann Oleafly stattdessen in Ihren persönlichen TeX-Baum installieren und richtet diesen Baum zuerst ein, falls er noch nicht existiert. Die Paketzeile zeigt, wo es gelandet ist. Das Entfernen des Pakets, das die Datei bereitstellt, entfernt auch die anderen Dateien, die es mitbringt; lesen Sie also vor dem Entfernen den Hinweis **Enthalten in**.

### tlmgr und ältere TeX-Live-Releases am Laufen halten

`tlmgr`, die Paketverwaltung von TeX Live, kann hinter dem Online-Repository von TeX Live zurückfallen und verweigert dann jede Installation, bis es sich selbst aktualisiert. Beim TinyTeX, das Oleafly verwaltet, aktualisiert Oleafly `tlmgr` und wiederholt die Installation. Bei einem TeX Live oder TinyTeX, das Sie selbst installiert haben, sagt die Meldung, dass Sie `tlmgr update --self` ausführen sollen.

Sobald das Repository zu einem neuen TeX-Live-Jahr weitergezogen ist, kann eine ältere Installation nicht mehr daraus installieren. Oleafly installiert dann aus dem letzten Archiv Ihres Releases. Hat das Archiv das Paket ebenfalls nicht, bittet die Meldung Sie, TeX Live zu aktualisieren oder beim verwalteten TinyTeX in den Einstellungen **Aktualisieren** zu verwenden.

### Festlegen, woher Pakete kommen

`tlmgr` installiert Pakete aus einem TeX-Live-Repository. Das TinyTeX, das Oleafly verwaltet, nutzt den nächstgelegenen CTAN-Mirror, es sei denn, Sie wählen ein bestimmtes Repository, etwa den CTAN-Mirror Ihrer Universität, unter **TeX-Paket-Repository** in **Einstellungen → Downloads → Quellen**. Ein TeX Live, das Sie selbst installiert haben, behält sein eigenes Repository, solange Sie dort keine Adresse eingeben. Oleafly übergibt die Adresse bei jedem Lauf an `tlmgr` und ändert nie dessen gespeicherte Konfiguration.

Eine Paketsuche, die das Repository erreichen muss, kann bei langsamer Verbindung eine Weile dauern. Oleafly wartet bis zu 10 Minuten, und gibt es auf, nennt die Meldung das Repository, auf das es gewartet hat. Siehe [Reiter Quellen](/docs/settings/downloads/#sources-tab).

### TeX Live aus einer Linux-Distribution

Unter Debian, Ubuntu und Fedora kommt TeX Live aus der Paketverwaltung des Systems, deshalb fügt Oleafly ihm keine Pakete hinzu. Die Liste **Pakete** sagt, dass Sie `apt` oder `dnf` verwenden sollen, und eine fehlende Datei bekommt einen Hinweis mit einem Tipp statt **Finden und installieren**:

- Unter Debian und Ubuntu finden Sie das Paket mit `apt-file search` und dem Dateinamen, oder Sie installieren alles mit `sudo apt install texlive-full`.
- Unter Fedora gibt der Hinweis für die fehlende Datei einen Befehl `sudo dnf install 'tex(file.sty)'` an.

Ist das TeX der Distribution unvollständig, bietet der Hinweis außerdem **TinyTeX herunterladen (~250 MB)** an, für das Oleafly Pakete verwalten kann. Haben Sie unter Debian und Ubuntu mit `tlmgr init-usertree` einen persönlichen Baum eingerichtet, installiert Oleafly Pakete in diesen Baum.

## Ein Paket aus dem Editor hinzufügen

Wählen Sie **LaTeX-Pakete**, das Paketsymbol in der Symbolleiste des LaTeX-Editors, um CTAN zu durchsuchen, ohne das Dokument zu verlassen. Jedes Ergebnis zeigt, ob das Dokument es bereits lädt (**Im Dokument**). In einem `latexmk`-Projekt zeigt es auch, ob Ihre TeX-Distribution es hat (**Installiert**), und **Installieren** fügt ein fehlendes mit `tlmgr` hinzu. Bei TeX Live aus einer Linux-Distribution sagt der Dialog stattdessen, dass Sie Pakete mit `apt` oder `dnf` installieren sollen.

**Zur Präambel hinzufügen** schreibt die `\usepackage`-Zeile in die Präambel. **Optionen** erlaubt, zuerst Paketoptionen anzugeben, und **Zeile kopieren** kopiert die Zeile stattdessen. Ein Tectonic-Projekt hat nichts zu installieren: Tectonic lädt ein Paket herunter, sobald das Dokument es zum ersten Mal verwendet.

## Welche Engine hat mein PDF kompiliert?

- **Compiler (dieses Projekt)** im Kompiliermenü, der Pfeil neben **Neu kompilieren**, zeigt den für das aktuelle Projekt gespeicherten Compiler.
- Tectonic-Builds verwenden die mitgelieferte Engine.
- pdfLaTeX-, XeLaTeX-, LuaLaTeX-, upLaTeX- und pLaTeX-Builds verwenden `latexmk` und die TeX-Distribution, die in den Einstellungen als **In Verwendung** markiert ist.
- Der getaggte Export von Preflight verwendet LuaLaTeX und schreibt an den normalen Build-Speicherort.

## Vorlagen und Pakete

Vorlagen deklarieren die Pakete, die sie brauchen, und Tectonic holt sie bei der ersten Kompilierung. Vorlagen mit Fonts auf Abruf behandeln diese separat. Siehe [Vorlagen](/docs/templates/#on-demand-fonts-the-setup-badge).
