# Typst-Projekte

Für jedes Projekt eine Typst-Version fixieren, Pakete aus Typst Universe hinzufügen, Schriften, Kompiliervarianten und reproduzierbare PDFs steuern und ein LaTeX-Projekt nach Typst konvertieren.

Oleafly bringt Typst 0.15.1 und den Sprachserver Tinymist 0.15.8 mit, sodass ein neues Typst-Projekt ohne jede Installation kompiliert. Diese Seite beschreibt, was Sie ändern können: welches Typst ein Projekt verwendet, woher seine Pakete und Schriften kommen und wie aus einer Quelle mehr als ein PDF entsteht. Für Syntax und die Werkzeugleiste beginnen Sie mit [In Typst schreiben](/docs/writing/typst/).

## Typst-Versionen

Öffnen Sie **Einstellungen → Engines → Typst**. Die erste Karte ist **Typst (eingebaut)**, die Version, die mit der App mitkommt. Ist auf Ihrem Rechner bereits ein `typst` installiert, auf Ihrem `PATH`, im Homebrew-Ordner oder in `~/.cargo/bin`, zeigt eine zweite Karte es als **Typst auf diesem Rechner** an. Projekte, die genau diese Version fixieren, können damit kompilieren.

Darunter listet **Versionen** die Typst-Versionen 0.11 bis 0.15 auf, die neueste zuerst. Jede Zeile nennt das Releasedatum, die Downloadgröße, woher die Kopie stammt (**Eingebaut**, **Heruntergeladen** oder **System**), und, sobald sie installiert ist, die Tinymist-Version, die sie verwendet.

- **Installieren** lädt diese Version herunter. Oleafly versucht zuerst seinen eigenen Spiegel und danach GitHub und prüft das Archiv und das Programm darin gegen SHA-256-Prüfsummen, die in die App eingebaut sind. Eine Datei, die nicht passt, wird verworfen, und eine fehlgeschlagene oder abgebrochene Installation hinterlässt nichts. Downloads liegen in `~/.oleafly/toolchains/typst/`.
- Der runde Knopf links in einer installierten Zeile macht diese Version zur Standardversion.
- **Entfernen** löscht eine heruntergeladene Version. Die Standardversion lässt sich nicht entfernen, wählen Sie also zuerst eine andere Standardversion.

### Die Standardversion und Projekt-Fixierungen

Neue Typst-Projekte fixieren die Standardversion. Dasselbe gilt für Projekte aus einer Vorlage, importierte Projekte und verknüpfte Ordner. Eine Fixierung wird in der `project.json` des Projekts als Versionsnummer gespeichert, nicht als Pfad, sodass sie weiterhin funktioniert, wenn Sie das Projekt verschieben oder auf einem anderen Rechner öffnen.

Die Standardversion später zu ändern, verschiebt bestehende Projekte nicht. Das ist Absicht: Ein fixiertes Paper behält dieselben Zeilenumbrüche und dieselbe Seitenzahl, wenn Oleafly ein neueres Typst ausliefert.

Um die Version eines einzelnen Projekts zu ändern, öffnen Sie den Pfeil neben **Neu kompilieren** und schauen Sie unter **Typst-Version (dieses Projekt)** nach. **Standard** folgt der in den Einstellungen gewählten Version und hebt die Fixierung auf. Die übrigen Einträge sind die auf diesem Rechner installierten Versionen, wo zutreffend mit **[eingebaut]** oder **[System]** markiert. Um eine Version zu verwenden, die nicht aufgeführt ist, installieren Sie sie zuerst in den Einstellungen.

### Wenn eine fixierte Version fehlt

Wenn Sie ein Projekt öffnen, das eine Version fixiert, die dieser Rechner nicht hat, baut Oleafly es nicht stillschweigend mit einem anderen Typst. Das Kompilieren stoppt mit „Typst 0.13.1 ist nicht installiert“, und die Vorschau bietet zwei Schaltflächen:

- **Typst 0.13.1 herunterladen** installiert die fixierte Version und kompiliert erneut. Die Schaltfläche erscheint, wenn die Version zu denen gehört, die Oleafly anbietet.
- **Typst 0.15.1 verwenden**, benannt nach Ihrer Standardversion, hebt die Fixierung auf und kompiliert erneut mit der Standardversion.

Das Kompiliermenü markiert die Fixierung mit **[nicht installiert]**, bis Sie sich für eine der beiden entscheiden.

### Eine neuere Version testen

Mit geöffnetem Typst-Projekt zeigt der Typst-Bereich in den Einstellungen **Neuere Version ausprobieren** an, sobald ein neueres Typst installiert ist. Wählen Sie **Mit Typst 0.15.1 prüfen** (oder mit der Version, die dort genannt ist). Oleafly baut das Projekt zweimal in temporären Ordnern, einmal mit der aktuellen Version des Projekts und einmal mit der neueren. Nichts an Ihrem Projekt ändert sich.

Der Bericht zeigt, ob jeder Build gelungen ist, seine Seitenzahl sowie seine Fehler und Warnungen. Er sagt Ihnen, wenn sich die Seitenzahl ändert. **Neu in Typst 0.15.1** listet Meldungen, die nur die neuere Version meldet, und **Von Typst 0.15.1 nicht mehr gemeldet** listet die, die wegfallen. Klicken Sie auf eine Meldung, um ihre Datei an der betreffenden Zeile zu öffnen.

Wenn Ihnen das gefällt, fixiert **Zu Typst 0.15.1 wechseln** das Projekt auf die neuere Version. **Erneut prüfen** führt beide Builds erneut aus, nachdem Sie etwas behoben haben.

### Der Sprachserver folgt der Version

Tinymist treibt Vervollständigung, Hover-Karten, Umbenennen und Formatierung in Typst-Dateien (siehe [Code-Intelligenz](/docs/code-intelligence/#typst-files)). Jede Typst-Nebenversion hat ihre eigene Tinymist-Version, und ein Projekt spricht mit derjenigen, die zu seiner Typst-Version passt.

Das eingebaute Tinymist deckt Typst 0.15 ab. Wenn Sie ein Projekt öffnen, das auf eine ältere Linie fixiert ist, lädt Oleafly das passende Tinymist im Hintergrund herunter, mit derselben Prüfsummenprüfung, und der Status lautet „Tinymist 0.13.30 wird passend zur Typst-Version dieses Projekts heruntergeladen.“ Schlägt der Download fehl, versucht Oleafly es später erneut. Wenn die Einstellungen Tinymist-Downloads finden, die keine installierte Typst-Version mehr braucht, bieten sie **Ungenutzte Sprachserver-Downloads entfernen** an.

### Was jede Version kann

Ältere Versionen existieren, damit Projekte, die auf ihnen begonnen wurden, weiterhin auf dieselbe Weise bauen. Einige Funktionen hängen davon ab, was die Typst-Version selbst unterstützt:

| Funktion | 0.11 | 0.12 | 0.13 | 0.14 und später |
| --- | --- | --- | --- | --- |
| Nur Projektschriften | Nein | Ja | Ja | Ja |
| Reproduzierbarer Build | Nein | Ja | Ja | Ja |
| Seitenbereiche im PNG- und SVG-Export | Nein | Ja | Ja | Ja |
| PDF/A | Nein | PDF/A-2b | PDF/A-2b, PDF/A-3b | Alle PDF/A-Stufen, die Typst anbietet |
| PDF/UA-1 | Nein | Nein | Nein | Ja |
| Pakete im Projektordner behalten | Nein | Ja | Ja | Ja |
| HTML-Export sowie Word- oder Markdown-Export über Typsts HTML | Nein | Nein | Ja | Ja |
| [Abgleich von Quelltext und PDF](/docs/synctex/) | Nein | Nein | Ja | Ja |
| Getaggtes PDF bei jedem Kompilieren | Nein | Nein | Nein | Ja |

Die Schriftauswahl kann auf Typst 0.15 und später sagen, woher jede Schrift stammt. Wenn eine Einstellung auf die Version, die ein Projekt verwendet, nicht anwendbar ist, markiert das Kompiliermenü sie mit **Braucht ein neueres Typst**.

## Pakete aus Typst Universe

Wählen Sie **Typst-Pakete**, das Paketsymbol am rechten Ende der Typst-Werkzeugleiste. Durchsuchen Sie Typst Universe nach Name, Stichwort oder Kategorie. Jedes Paket zeigt seine neueste Version, und ein Paket, das ein neueres Typst braucht, als das Projekt verwendet, sagt das: „Braucht Typst 0.14.0. Dieses Projekt nutzt Typst 0.13.1.“

**Import einfügen** schreibt die `#import`-Zeile an den Anfang der geöffneten Typst-Datei. **Import kopieren** legt sie stattdessen in die Zwischenablage.

Typst lädt ein `@preview`-Paket herunter, sobald ein Kompilieren es zum ersten Mal importiert, und behält es in einem Zwischenspeicher, den sich alle Projekte teilen. Auch die Paketliste wird zwischengespeichert. Offline zeigt der Dialog die zuletzt geladene Liste mit ihrem Datum an.

### Neuere Releases

Wenn ein Import ein älteres Release nennt, als das auf Typst Universe liegt, ist seine Versionsnummer unterstrichen, mit einem Hinweis wie „cetz 0.4.2 ist verfügbar. Dieser Import nutzt 0.3.4.“ Die Hinweiskarte bietet **Auf 0.4.2 aktualisieren**, was die Versionsnummer im Import ändert. Lesen Sie das Änderungsprotokoll des Pakets, bevor Sie zustimmen, denn ein neues Release kann ändern, wie das Paket aufgerufen wird. Auch das Daraufzeigen über einem Import bietet **Auf Typst Universe öffnen**.

### Pakete im Projekt behalten

Unter **Projektpakete** im selben Dialog kopiert **Pakete ins Projekt kopieren** jedes Paket, das das Projekt importiert, in einen Ordner `typst-packages` im Projektstamm. Es kopiert auch die Pakete, die diese Pakete importieren, und schaltet **Pakete aus dem Projektordner verwenden** ein.

Von da an schaut Typst zuerst in `typst-packages`. Ein Projekt mit eigenen Paketkopien kompiliert offline und auf jedem Rechner, und der Ordner kann mit Ihrem Quelltext in Git einziehen. Ein Paket, das Sie nicht ins Projekt kopiert haben, kommt weiterhin aus dem geteilten Zwischenspeicher. Das braucht Typst 0.12 oder neuer, und bei einem Projekt, das auf 0.11 fixiert ist, bittet der Dialog Sie, zuerst die Version zu wechseln.

Wenn ein Paket noch nicht im Zwischenspeicher liegt, nennt der Dialog es: „Diese Pakete liegen nicht im Paket-Zwischenspeicher: …“ Kompilieren Sie einmal online und kopieren Sie die Pakete dann erneut ins Projekt.

### Offline-Modus

Mit eingeschaltetem **Offline-Modus** unter **Einstellungen → Allgemein** kann Typst nichts herunterladen. Jedes Paket muss bereits im geteilten Zwischenspeicher oder in `typst-packages` liegen. Wenn eines fehlt, schlägt das Kompilieren fehl, und die Meldung nennt das Paket, sodass Sie wissen, was Sie beim nächsten Mal holen müssen, wenn Sie online sind.

## Schriften

Typst findet Schriften an vier Orten: die in Typst eingebauten Schriften, die auf Ihrem Rechner installierten Schriften, die Schriftpakete, die Sie in Oleafly herunterladen, und Schriftordner im Projekt. Legen Sie Schriftdateien in einen Ordner namens `fonts` im Projektstamm, und sowohl der Compiler als auch der Sprachserver nehmen sie auf. Weitere Ordner lassen sich unter `typst.font_paths` in `project.json` auflisten. Ordner außerhalb des Projekts werden ignoriert.

Unter **Schriften (dieses Projekt)** im Kompiliermenü ist **Systemschriften verwenden** die Standardeinstellung. **Nur Projektschriften** hindert Typst daran, die auf diesem Rechner installierten Schriften zu lesen. Das PDF sieht dann auf jeder Maschine gleich aus, und wenn das Dokument eine Schrift verlangt, die das Projekt nicht enthält, merken Sie es auf Ihrem eigenen Rechner statt auf dem eines Mitautors.

Um eine Grundschrift zu wählen, öffnen Sie **Dokumenteinstellungen**, das Schieberegler-Symbol in der Typst-Werkzeugleiste, und klicken Sie auf **Grundschrift**. Die Liste zeigt jede Schriftfamilie, die Typst mit den aktuellen Schrifteinstellungen des Projekts finden kann. Auf Typst 0.15 und später trägt jede Familie die Kennzeichnung **Projekt**, **System**, **Schriftpaket** oder **Eingebaut**. Wählen Sie eine und dann **Übernehmen**, und Oleafly schreibt sie in die `#set`-Regeln des Dokuments.

### Schriftpakete

Unter **Einstellungen → Downloads → Schriften** gibt es fünf kostenlose Schriftpakete für Typst: **Chinesisch, Japanisch und Koreanisch**, **Klassische Textschriften**, **Moderne Sans- und Serifenschriften**, **Code** und **Symbole und Emoji**. Sobald ein Paket heruntergeladen ist, kann jedes Typst-Projekt seine Schriften beim Namen verwenden, und dasselbe gilt für die Downloads von Lato, PT Sans und PT Serif auf diesem Reiter. Ein Paket nimmt erst an Kompilierungen teil, wenn sein ganzer Download fertig ist, deshalb beeinflusst ein halb fertiger Download nie einen Build.

Projekte mit **Nur Projektschriften** oder **Reproduzierbarer Build** lesen keine Schriftpakete. Kopieren Sie für sie die Schriftdatei in den Ordner `fonts` des Projekts.

### Zeichen, die als Kästchen erscheinen

Nach jeder Kompilierung prüft Oleafly, ob es Zeichen gibt, die keine verfügbare Schrift zeichnen konnte. Typst zeichnet sie als Kästchen. Findet Oleafly welche, erhält die Kompilierung eine Warnung, und über dem Editor erscheint ein Hinweis:

- **Leere Kästchen** bedeuten, dass keine Schrift, die Typst nutzen kann, die Zeichen hat, und die Warnung nennt einige. Deckt ein Schriftpaket sie ab, wie das Paket Chinesisch, Japanisch und Koreanisch es für CJK-Text und das Paket Symbole und Emoji es für Emoji tut, bietet der Hinweis **Schriften herunterladen** mit der Downloadgröße an, und das Protokoll bietet **Herunterladen und kompilieren** an. Andernfalls legen Sie eine Schrift, die sie hat, in den Ordner `fonts` des Projekts.
- **Kästchen mit einem Fragezeichen** bedeuten, dass Typst die Zeichen mit einer Ersatzschrift gezeichnet hat. Nennen Sie eine Schrift, die sie hat, unter **Grundschrift** in den **Dokumenteinstellungen** oder in einer Schriftliste wie `#set text(font: ("Libertinus Serif", "Apple SD Gothic Neo"))`.
- In einem Projekt mit **Nur Projektschriften** gelten Schriftpakete und Systemschriften nicht. Legen Sie eine Schrift in den Ordner `fonts`, oder stellen Sie das Projekt auf **Systemschriften verwenden** und **Standard-Build**.

**Dokumenteinstellungen** im Hinweis öffnet das Panel, in dem Sie die Grundschrift wählen. Schließen Sie den Hinweis, um ihn für diese Warnung auszublenden.

## Kompiliervarianten und sys.inputs

Eine Kompilivariante ist ein benannter Satz von Werten, den Ihr Dokument über `sys.inputs` liest. Verwenden Sie Varianten, wenn eine Quelle unterschiedliche PDFs erzeugen soll, etwa eine anonymisierte Review-Fassung und eine druckfertige Fassung oder einen Entwurf mit Wasserzeichen.

Das Dokument entscheidet, was jeder Wert tut. Werte kommen immer als Text an:

```typst
#let draft = sys.inputs.at("draft", default: "false") == "true"

#if draft [*Draft. Do not circulate.*]
```

So richten Sie eine Variante ein:

1. Öffnen Sie **Dokumenteinstellungen** und blättern Sie zu **Kompiliervarianten**.
2. Wählen Sie **Variante hinzufügen** und benennen Sie sie, zum Beispiel `review`.
3. Wählen Sie **Wert hinzufügen**, geben Sie dann `draft` unter **Name** und `true` unter **Wert** ein.
4. Wählen Sie **Übernehmen**.
5. Öffnen Sie das Kompiliermenü. **Variante (dieses Projekt)** listet jetzt `review`. Wählen Sie es aus und kompilieren Sie.

**Keine Variante** baut ohne alle Variantenwerte. Die gewählte Variante wird nur auf diesem Rechner gemerkt, sodass ein Mitautor aus demselben Projekt eine andere bauen kann. Die Varianten selbst werden in `project.json` gespeichert. Auch Exporte verwenden die gewählte Variante.

Werte, die jeder Build bekommen soll, gehören unter `typst.inputs` in `project.json`. Wenn eine Variante einen Wert mit demselben Namen setzt, gewinnt die Variante.

## Reproduzierbare Builds

Unter **Build (dieses Projekt)** im Kompiliermenü sorgt **Reproduzierbarer Build** dafür, dass dieselben Quellen auf jedem Rechner dasselbe PDF ergeben. Er verwendet nur Projektschriften und die eingebauten Schriften von Typst und datiert das PDF auf den letzten Git-Commit. Ein Projekt, das kein Git-Repository ist, bekommt ein festes Datum des 1. Januar 1970.

Das zählt, wenn ein PDF zu einer Prüfsumme passen muss, für eine Archiv-Ablage oder einen Vergleich in CI. Es braucht Typst 0.12 oder später. Während es an ist, ist **Systemschriften verwenden** nicht verfügbar. **Standard-Build** ist die Voreinstellung.

![Typst kompiliert beim Tippen: Jede neue Zeile erscheint im PDF.](https://cdn.oleafly.com/images/gifs/desktop/typst-live.gif?v=2)

## Live-Vorschau mit Automatisch kompilieren

Setzen Sie **Automatisch kompilieren** im Kompiliermenü auf **Ein**. In einem Typst-Projekt hält Oleafly dann einen Typst-Prozess laufen. Die geöffnete Datei speichert sich kurz nachdem Sie mit dem Tippen aufhören von selbst, Typst kompiliert sie, und die Vorschau lädt an derselben Scroll-Position neu. Es gibt keine separate Einstellung für die Live-Vorschau: Automatisch kompilieren ist die Live-Vorschau.

Während Typst startet, zeigt das Menü „Typst wird gestartet“. Stoppt er nach wiederholten Fehlern, sagt das Menü das, und Ihre nächste Bearbeitung startet ihn erneut. **Kompilieren stoppen** beendet den Prozess, und die nächste Bearbeitung startet ihn ebenfalls erneut. LaTeX- und Markdown-Projekte behandeln Automatisch kompilieren anders; siehe [Kompilieren](/docs/compiling/#auto-compile).

## Von der Befehlszeile aus bauen

Der `oleafly`-Befehl baut Projekte, ohne die App zu öffnen. Er kommt mit Oleafly, und [Befehlszeilenwerkzeug](/docs/cli/#install) zeigt, wie Sie ihn in Ihren PATH legen.

Für ein Typst-Projekt lesen `oleafly build` und `oleafly watch` die `project.json` und verwenden dieselben Einstellungen wie die App: die fixierte Version, die ins Projekt kopierten Pakete, die Schriftordner, den Schalter für Systemschriften, Eingaben und reproduzierbare Builds.

- `--variant review` baut eine Variante. Ein Name, den das Projekt nicht definiert, stoppt den Build, und die Meldung listet die Varianten, die es tatsächlich gibt.
- `--offline` blockiert Paket-Downloads, wie der Offline-Modus in der App.
- Ein fixiertes Projekt baut nur mit genau diesem Typst. Die CLI schaut auf `OLEAFLY_TYPST`, dann auf die Versionen, die die App geladen hat, dann auf das `typst` neben der CLI, dann auf Ihren `PATH`. Meldet keine davon die fixierte Version, stoppt der Build, bevor Typst läuft, und sagt Ihnen, wie Sie sie installieren.
- Ein Projekt ohne Fixierung verwendet `OLEAFLY_TYPST`, wenn es gesetzt ist. Andernfalls verwendet es die Standardversion, die Sie unter **Einstellungen → Downloads** oder mit `oleafly typst default` gewählt haben, und ohne gewählte Standardversion das mitgelieferte Typst oder das auf Ihrem `PATH`.
- `oleafly doctor` listet jedes Typst, das es gefunden hat, und die Einstellungen, die ein Build verwenden würde. Es schlägt fehl, wenn die fixierte Version fehlt.

Wenn eine Einstellung auf das verwendete Typst nicht anwendbar ist, druckt der Build einen Hinweis, zum Beispiel dass Typst 0.11.1 Systemschriften nicht ignorieren kann. Fehler im Terminal enthalten die eigenen Hinweise von Typst.

## Ein LaTeX-Projekt nach Typst konvertieren

Öffnen Sie das LaTeX-Projekt, drücken Sie ⌘K (Ctrl+K) und führen Sie **In ein Typst-Projekt umwandeln** aus. Geben Sie dem neuen Projekt einen Namen und wählen Sie **Umwandeln**. Das LaTeX-Projekt bleibt genau so, wie es war. Oleafly baut daraus ein separates Typst-Projekt:

- Pandoc konvertiert Text, Mathe, Abbildungen und Tabellen. Ist Pandoc noch nicht eingerichtet, richtet Oleafly es zuerst ein.
- Jede Datei, die über `\input`, `\include` oder `\subfile` eingebunden wird, bekommt ihre eigene `.typ`-Datei.
- BibTeX-Dateien werden unverändert kopiert.
- Typst kompiliert das neue Projekt, um es zu prüfen.

Der Bericht sagt dann, ob das Projekt kompiliert, und zählt, was konvertiert wurde: Quelldateien, Abbildungen, Tabellen, abgesetzte Formeln, Querverweise, vom Mathe-Konverter reparierte Formeln und kopierte Dateien, zusammen mit dem Bibliografiestil, den er gewählt hat. **Braucht Aufmerksamkeit** listet, was von Hand zu fixen ist, etwa ein fehlendes Include oder Bild, ein Bildformat, das Typst nicht anzeigen kann, Mathe, das der Konverter nicht bewältigen konnte, ein BibTeX-Stil ohne Typst-Gegenstück oder ein Label auf einer einzelnen Zeile einer mehrzeiligen Gleichung, das nun auf die ganze Gleichung zeigt. Kompilierfehler und Warnungen verlinken auf ihre Datei und Zeile.

Wählen Sie **Typst-Projekt öffnen**, um zu ihm zu wechseln. Das neue Projekt fixiert Ihre Standard-Typst-Version. Solange Oleafly offen ist, holt **Bericht zur Typst-Umwandlung anzeigen** in der Befehlspalette den Bericht zurück.

Um eine einzelne Datei statt eines ganzen Projekts zu konvertieren, verwenden Sie [LaTeX zu Typst](/docs/tools/latex-to-typst/) auf der Werkzeuge-Seite.

## Verwandte Seiten

- [In Typst schreiben](/docs/writing/typst/) für die Werkzeugleiste und ein erstes Dokument.
- [Kompilieren](/docs/compiling/) für Protokolle, das Kompiliermenü und den Offline-Modus.
- [Ein Projekt exportieren und konvertieren](/docs/export/#typst-images-and-html) für PNG, SVG, HTML, PDF/A und PDF/UA.
- [Preflight-Prüfungen](/docs/preflight/#typst-projects) für die Prüfungen, die Typst-Quelltexte lesen.
