Zum Inhalt springen
Oleaflyv0.4.12

Dokumentwerkzeuge

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.

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.

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.

Wählen Sie den Compiler über den Pfeil neben Neu kompilieren. Siehe LaTeX-Engines.

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.

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.

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.

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.

Bildvorschau

KI-Antworten konnten nicht geladen werden

Versuchen Sie es erneut oder durchsuchen Sie die Dokumentation.