# arXiv zu Typst

Den LaTeX-Quelltext eines arXiv-Papers nach Typst umwandeln, mit einer Kompilierprüfung, die auflistet, was nicht umgewandelt wurde.

arXiv zu Typst beginnt beim Quelltext, den die Autoren eingereicht haben, nicht beim PDF. Oleafly lädt den E-Print herunter oder entpackt ihn, wandelt seine LaTeX-Hauptdatei nach Typst um und kompiliert das Ergebnis einmal, damit Sie sehen, was noch eine Korrektur braucht.

## Wann Sie es nutzen

- Sie die Struktur eines arXiv-Papers in Typst haben möchten;
- Sie als Autor Ihre eigene Einreichung nach Typst überführen;
- die Lizenz des Papers die Weiterverwendung erlaubt, die Sie im Sinn haben.

Um das Paper in LaTeX zu behalten, nutzen Sie [arXiv zu LaTeX](/docs/tools/arxiv-to-latex/). Ein Paper ohne Quellpaket kann diesen Weg nicht gehen. [PDF zu Typst](/docs/tools/pdf-to-typst/) stellt den Quelltext stattdessen aus dem PDF wieder her.

## Ein Paper umwandeln

1. Öffnen Sie **arXiv zu Typst** oder führen Sie `/arxiv-to-typst` aus.
2. Geben Sie unter **arXiv-ID** eine Kennung wie `1706.03762` ein. Um offline zu arbeiten, wechseln Sie zu **Gespeichertes Archiv** und wählen Sie ein Quellarchiv im Format `.tar.gz`, `.tgz` oder `.gz`.
3. Wählen Sie **Umwandeln**.
4. Lesen Sie den Hinweis unter dem Ergebnis. Er nennt die LaTeX-Hauptdatei, sagt, ob Typst das Ergebnis kompiliert hat, und zählt die Elemente, die nicht umgewandelt wurden. Die Liste unter dem Hinweis zeigt jeden Typst-Fehler mit seiner Zeilennummer und jedes Element, das nicht umgewandelt wurde.
5. Wählen Sie **ZIP speichern**, um `main.typ` mit den übrigen Dateien des Papers zu behalten, oder **Projekt erstellen**, um es als Typst-Projekt zu öffnen.

## Was die Umwandlung tut

Oleafly findet die Hauptdatei und zieht den Text der Dateien hinein, die sie über `\input`, `\include` oder `\subfile` lädt. Pandoc wandelt dieses LaTeX nach Typst um, mit nummerierten Abschnitten. Abbildungen, Literaturverzeichnis-Dateien und die übrigen Nicht-TeX-Dateien im Archiv behalten ihre Ordner neben `main.typ`, sodass die umgewandelte Datei ihre Bilder noch findet. Typst kompiliert die umgewandelte Datei dann als Prüfung.

Das Nachschlagen einer ID lädt den Quelltext von arXiv herunter und braucht eine Netzverbindung. Ein gespeichertes Archiv wird vollständig auf Ihrem Gerät umgewandelt, mit dem Pandoc, das Oleafly mitliefert.

## Was Sie von Hand korrigieren

Eigene Makros, Pakete ohne Typst-Gegenstück, TikZ-Bilder, komplexe Tabellen und Literaturverzeichnis-Stile sind die üblichen Überbleibsel. Arbeiten Sie zuerst die Typst-Fehler in der Liste ab und vergleichen Sie dann das kompilierte PDF Abschnitt für Abschnitt mit dem Paper. Typst kann EPS-Abbildungen nicht anzeigen; wandeln Sie diese deshalb nach PDF, PNG oder SVG um.

:::caution[Prüfen Sie zuerst die Lizenz]
Papers auf arXiv tragen unterschiedliche Lizenzen. Prüfen Sie die Lizenz des Papers und die Bedingungen der Autoren, bevor Sie seinen Text oder seine Abbildungen weiterverwenden.
:::

Um ein LaTeX-Projekt umzuwandeln, das bereits in Oleafly liegt, nutzen Sie stattdessen **In ein Typst-Projekt umwandeln** aus der Befehlspalette. [Typst-Projekte](/docs/typst/#convert-a-latex-project-to-typst) erklärt es.
