# Pakete

Durchsuchen Sie CTAN nach LaTeX-Paketen und das Typst Universe nach Typst-Paketen und fügen Sie dann eines über die Editor-Symbolleiste zu Ihrem Dokument hinzu.

LaTeX- und Typst-Dokumente beziehen die meisten ihrer Zusatzfunktionen aus Paketen. Die Pakete-Schaltfläche am rechten Ende der Editor-Symbolleiste öffnet eine durchsuchbare Liste für die Sprache des Projekts und schreibt die Zeile, die ein Paket lädt, für Sie. Markdown-Projekte haben keine Pakete-Schaltfläche.

Sie können die Liste auch über die ⌘K-Palette mit **LaTeX-Pakete durchsuchen** oder **Typst-Pakete durchsuchen** öffnen.

## LaTeX-Pakete

Wählen Sie in einem LaTeX-Projekt **LaTeX-Pakete**. Durchsuchen Sie CTAN nach Paketname oder Beschreibung. Wenn CTAN nicht erreichbar ist oder Sie offline sind, meldet das Dialogfeld das und zeigt stattdessen die eingebaute Liste von Oleafly. Eine Liste, die nicht aktualisiert werden konnte, zeigt das Datum ihres Downloads.

Jede Zeile kann diese Bezeichnungen zeigen:

- **Im Dokument**: Die Hauptdatei lädt dieses Paket bereits.
- **Dokumentklasse**: Der Eintrag ist eine Klasse, kein Paket. Klassen werden mit `\documentclass` gesetzt, daher lässt sich diese Zeile kopieren, aber nicht hinzufügen.
- **Installiert**: Ihre TeX-Distribution enthält das Paket bereits.

Jede Zeile hat außerdem diese Steuerelemente:

- **Optionen**, ein Feld für Paketoptionen wie `margin=2cm`. Geschweifte Klammern müssen paarweise auftreten, und `]` oder `%` sind nicht erlaubt.
- **Zur Präambel hinzufügen** schreibt `\usepackage[options]{name}` in die Präambel der Hauptdatei. Wenn die Datei das Paket bereits lädt, ändert sich nichts, und das Dialogfeld meldet das.
- **Zeile kopieren** kopiert dieselbe `\usepackage`-Zeile oder für eine Klasse die Zeile `\documentclass`.
- **CTAN** öffnet die Seite des Pakets auf CTAN.
- **Installieren**, für ein Paket, das Ihrer TeX-Distribution fehlt. Siehe unten.

### LaTeX-Pakete installieren

Was „installiert“ bedeutet, hängt davon ab, wie das Projekt kompiliert:

- **Tectonic**, der eingebaute Compiler, lädt ein Paket herunter, sobald Ihr Dokument es erstmals verwendet. Es gibt nichts zu installieren, und das Dialogfeld sagt das oben.
- **latexmk mit TeX Live oder TinyTeX**: Wenn Ihre TeX-Distribution `tlmgr` enthält, prüft Oleafly, welche Pakete Sie haben, markiert sie als **Installiert** und bietet für die übrigen **Installieren** an. Installieren führt `tlmgr` für genau dieses eine Paket aus.
- **TeX Live von Debian, Ubuntu oder Fedora**: Die Paketverwaltung des Systems besitzt es, deshalb sagt das Dialogfeld, dass Sie Pakete mit `apt` oder `dnf` installieren sollen, und hat keine Schaltfläche **Installieren**.
- **Andere TeX-Konfigurationen**, etwa MiKTeX: Oleafly kann nicht erkennen, welche Pakete vorhanden sind; die Zeilen zeigen daher keinen Installationsstatus. Nutzen Sie für MiKTeX die MiKTeX Console.

Bei TeX Live oder TinyTeX bietet eine Kompilierung, die eine Datei nicht findet, **Finden und installieren** im Fehler an, was ermittelt, zu welchem Paket die Datei gehört. Siehe [Fehlende Datei beheben](/docs/latex-engines/#recover-from-a-missing-file).

Wählen Sie den Compiler über den Pfeil neben **Neu kompilieren**. Siehe [LaTeX-Engines](/docs/latex-engines/).

## Typst-Pakete

Wählen Sie in einem Typst-Projekt **Typst-Pakete**, um das Typst Universe zu durchsuchen. Suchen Sie nach Name, Schlüsselwort oder Kategorie oder grenzen Sie die Liste mit einem Kategorie-Chip ein. Das Dialogfeld zeigt bis zu 100 Pakete auf einmal; suchen Sie also, wenn die Liste lang ist.

Jede Zeile zeigt den Paketnamen, die neueste Version, ein Abzeichen **Vorlage** für Vorlagenpakete und eine kurze Beschreibung. Wenn ein Paket ein neueres Typst braucht, als das Projekt verwendet, nennt die Zeile die benötigte Version.

- **Import einfügen** fügt `#import "@preview/name:version": *` nach den Imports oben in der geöffneten `.typ`-Datei ein. Wenn die Datei das Paket bereits importiert, ändert sich nur die Versionsnummer. Eine Typst-Datei muss im Editor geöffnet sein.
- **Import kopieren** kopiert dieselbe Zeile.

### Hinweise zu Updates

Wenn ein `@preview`-Import in Ihrer Datei älter ist als die neueste Version im Typst Universe, markiert der Editor die Version mit einem Hinweis wie „cetz 0.4.2 ist verfügbar. Dieser Import nutzt 0.3.4.“ Die Aktion **Auf 0.4.2 aktualisieren** des Hinweises ändert die Zahl direkt an Ort und Stelle.

### Pakete beim Projekt behalten

Typst lädt Pakete beim ersten Import durch ein Projekt in einen gemeinsamen Cache herunter. Damit ein Projekt eigene Kopien mitführt, verwenden Sie **Projektpakete** unten im Dialogfeld:

- **Pakete aus dem Projektordner verwenden** lässt Typst zuerst im Ordner `typst-packages` des Projekts nachsehen. Ein so eingerichtetes Projekt kompiliert offline und auf anderen Computern.
- **Pakete ins Projekt kopieren** kopiert jedes Paket, das das Projekt importiert, aus dem Cache nach `typst-packages`. Wenn ein Paket noch nicht im Cache ist, kompilieren Sie einmal online und kopieren Sie dann erneut.

Beides braucht Typst 0.12 oder neuer. Bei einem Projekt, das auf Typst 0.11 fixiert ist, sagt der Abschnitt das.

Der Abschnitt zeigt außerdem, wie viele Pakete das Projekt enthält.

### Offline

Bei eingeschaltetem Offline-Modus verwendet das Dialogfeld die zuletzt heruntergeladene Paketliste und zeigt ihr Datum. Wenn noch nie eine Liste heruntergeladen wurde, kann keine angezeigt werden, bis Sie online gehen.

## Verwandte Seiten

- [Der Editor](/docs/editor/#the-editor-toolbar): der Rest der Editor-Symbolleiste
- [Kompilieren](/docs/compiling/): wie Pakete während eines Builds geladen werden
- [Dokumenteinstellungen](/docs/document-settings/): Papierformat, Ränder und Schriften ohne Paketcode
