# Vorhandene Arbeiten in Oleafly übernehmen

Importieren Sie ein Projektarchiv, wandeln Sie ein Dokument um, bringen Sie ein arXiv-Quellpaket ein, kopieren Sie ein GitHub-Repository oder verwandeln Sie ein LaTeX-Projekt in ein Typst-Projekt.

Wählen Sie **Neues Projekt → Ein Projekt importieren** oder verwenden Sie **Importieren** in der Bibliothek. Oleafly erstellt ein neues lokales Projekt und lässt die ursprüngliche Datei oder das ursprüngliche Repository unverändert. Bringt der Import kein eigenes Git-Repository mit, werden die importierten Dateien zum [ersten Git-Commit](/docs/new-project/#the-first-git-commit) des Projekts, **Projekt erstellen**.

![Wählen Sie „Projekt importieren“ im Dialog für neue Projekte, um mit vorhandener Arbeit zu beginnen.](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

## Wählen Sie den Weg, der zu Ihrem Ausgangsmaterial passt

| Was Sie haben | Importweg | Projekt, das Sie erstellen können |
| --- | --- | --- |
| Ein vollständiger Projektordner | **Vorhandenes Projekt** (`.zip`) | Der archivierte Quelltext, Abbildungen, Bibliografie und lokale Stildateien |
| Ein Word-Dokument | **Word-Dokument** (`.docx`) | LaTeX, Markdown oder Typst |
| Ein Markdown-Dokument | **Markdown-Dokument** (`.md`, `.markdown`) | LaTeX oder Typst |
| Ein HTML-Dokument | **HTML-Seite** (`.html`, `.htm`) | LaTeX, Markdown oder Typst |
| Ein Typst-Dokument | **Typst-Dokument** (`.typ`) | LaTeX oder Markdown |
| Ein arXiv-Aufsatz | **arXiv-Aufsatz** mit ID oder URL | Das LaTeX-Quellpaket des Aufsatzes |
| Ein GitHub-Repository | **GitHub** | Ein lokales Projekt, das mit dem Repository verbunden ist |
| Eine PDF-Datei ohne bearbeitbaren Quelltext | **Oleafly Tools → PDF-Konverter** | Rekonstruiertes LaTeX, Markdown oder Typst, je nach gewähltem Werkzeug |
| Ein LaTeX-Projekt, das schon in Oleafly liegt | **In ein Typst-Projekt umwandeln** in der Befehlspalette | Ein neues Typst-Projekt, das LaTeX-Projekt bleibt, wie es war |

Wählen Sie dasselbe Autorenformat nur, wenn Oleafly es anbietet. Um eine Markdown- oder Typst-Datei in ihrem ursprünglichen Format zu behalten, starten Sie ein leeres Projekt für dieses Format und fügen Sie die Quelldatei über den [Dateibaum](/docs/files/#adding-existing-files) hinzu.

## Ein vollständiges Projektarchiv importieren

Verwenden Sie ein ZIP, wenn Sie bereits eine funktionierende Quelltextstruktur haben.

1. Legen Sie das Hauptdokument, Abbildungen, Bibliografie und lokale Klassen- oder Stildateien in einen Ordner. Behalten Sie die relativen Pfade bei, die der Quelltext verwendet.
2. Komprimieren Sie den Ordner als `.zip`-Datei.
3. Wählen Sie **Importieren → Vorhandenes Projekt** und wählen Sie das ZIP aus.
4. Prüfen Sie das mit einem Stern markierte Hauptdokument im importierten Dateibaum.
5. Kompilieren Sie. Braucht das Projekt eine andere LaTeX-Toolchain, wählen Sie sie im Compiler-Menü.

Behalten Sie zum Beispiel `main.tex`, `references.bib`, `sections/method.tex` und `figures/plot.pdf` zusammen. Ein Quell-ZIP bewahrt diese Beziehungen. Eine PDF-Datei enthält nicht dieselbe bearbeitbare Projektstruktur.

Enthält das Archiv mehr als ein wahrscheinliches Hauptdokument, bestätigen Sie das richtige über das Dateimenü, bevor Sie kompilieren.

## Welchen LaTeX-Compiler ein Import verwendet

Ein importiertes oder umgewandeltes LaTeX-Projekt startet mit der Standard-Kompilier-Engine aus **Einstellungen → Engines → LaTeX**, das ist Tectonic, sofern Sie sie nicht geändert haben. Ist dieser Standard `latexmk` und das Projekt nennt pdfLaTeX, XeLaTeX oder LuaLaTeX, behält es diesen Compiler. Findet der Import Funktionen, die Tectonic nicht beherrscht, öffnet sich der Engine-Dialog, damit Sie einen anderen wählen können. Siehe [Einen Standard für neue Projekte festlegen](/docs/engines/#set-a-default-for-new-projects) und [Wenn Tectonic nicht reicht](/docs/latex-engines/#when-tectonic-isnt-enough).

## Word, Markdown, HTML oder Typst umwandeln

1. Wählen Sie den passenden Dokumenttyp unter **Importieren**.
2. Wählen Sie die Datei aus.
3. Bietet Oleafly mehr als ein Ziel an, wählen Sie das Format, in dem Sie als Nächstes schreiben möchten. LaTeX ist als empfohlener Weg markiert.
4. Schließen Sie die Pandoc-Einrichtung ab, wenn Sie dazu aufgefordert werden. Oleafly kann eine kompatible Installation nutzen oder seine verwaltete Version herunterladen.
5. Öffnen Sie das neue Projekt, kompilieren Sie es und vergleichen Sie es mit dem Original.

Umwandlungen laufen lokal über Pandoc. Ein Word- oder HTML-Import extrahiert außerdem eingebettete Medien in das Projekt, sodass der umgewandelte Quelltext darauf verweisen kann. Ein Markdown-Dokument, das in ein LaTeX-Projekt importiert wird, behält seine Zitationen: `[@key]` wird zu `\citep` oder `\citet`, und die Bibliografiedatei kommt mit, sodass das Referenzen-Panel Ihre Quellen von Anfang an enthält.

Wählen Sie das Ziel für die bevorstehende Arbeit:

- **LaTeX** passt zu Zeitschriftsvorlagen, detailliertem Satz und Tagged-PDF-Workflows.
- **Markdown** passt zu einem leichteren Quellformat und breiter Dokumentumwandlung.
- **Typst** passt zu schnellem Kompilieren und Typst-eigenen Vorlagen.

Die Umwandlung bewahrt die Dokumentstruktur, soweit das Quellformat sie offenlegt. Word-spezifische Seitenlayouts, eigenes HTML-Styling, handgefeilte Tabellen, Zitationen und komplexe Formeln können trotzdem einen Bereinigungsdurchlauf brauchen. Vergleichen Sie Überschriften, Listen, Tabellen, Formeln, Links, Zitationen und die Platzierung von Bildern, bevor Sie das Original löschen.

## Ein arXiv-Quellpaket importieren

Wählen Sie **arXiv-Aufsatz** und fügen Sie dann eine Kennung wie `2401.01234` oder eine `arxiv.org/abs/...`-URL ein. Oleafly lädt das eingereichte Quellpaket herunter und öffnet es als LaTeX-Projekt.

Nutzen Sie diesen Weg, wenn Sie den bearbeitbaren Quelltext der Autoren brauchen. Nutzen Sie [arXiv zu LaTeX](/docs/tools/arxiv-to-latex/), wenn Sie ein Quellarchiv ansehen oder speichern möchten, ohne den Import-Dialog zu öffnen, und [arXiv zu Typst](/docs/tools/arxiv-to-typst/), wenn der Aufsatz nach Typst umgewandelt werden soll. Eine arXiv-Kennung braucht eine Netzwerkverbindung; ein Quellarchiv, das bereits auf der Festplatte liegt, nicht.

Prüfen Sie immer die Lizenz und die Bedingungen der Autoren, bevor Sie Quelltext oder Abbildungen weiterverwenden.

## Aus GitHub importieren

Wählen Sie im Import-Dialog **GitHub**. Verbinden Sie bei Bedarf Ihr Konto über **Einstellungen → Integrationen → GitHub** und wählen Sie dann ein Repository, auf das Sie Zugriff haben.

Oleafly erstellt eine lokale Kopie in der Bibliothek. Prüfen Sie das Hauptdokument und kompilieren Sie einmal, bevor Sie mit dem Bearbeiten beginnen. [GitHub-Sync](/docs/github-sync/) erklärt Pullen, Committen und Veröffentlichen von Änderungen nach dem Import.

## Ein LaTeX-Projekt nach Typst umwandeln

Oleafly kann eine Typst-Kopie eines vorhandenen LaTeX-Projekts erstellen. Das LaTeX-Projekt wird nicht verändert.

1. Öffnen Sie das LaTeX-Projekt.
2. Öffnen Sie die Befehlspalette mit ⌘K (Ctrl+K) und führen Sie **In ein Typst-Projekt umwandeln** aus.
3. Prüfen Sie den **Namen des neuen Projekts**. Standardmäßig ist es der Projektname, gefolgt von `(Typst)`.
4. Wählen Sie **Umwandeln**. Oleafly wandelt das Projekt mit Pandoc um, erstellt das Typst-Projekt und kompiliert es einmal zur Kontrolle.
5. Lesen Sie den Bericht und wählen Sie dann **Typst-Projekt öffnen**.

Der Bericht sagt, ob das neue Projekt kompiliert, zählt, was umgewandelt wurde, und listet, was von Hand nachgebessert werden muss, mit Links zu jedem Kompilierfehler. [Typst-Projekte](/docs/typst/#convert-a-latex-project-to-typst) erklärt die Umwandlung und den Bericht im Detail.

## Eine PDF-Datei rekonstruieren

Aktivieren Sie **LaTeX-Werkzeuge** unter **Einstellungen → Experimente** und wählen Sie dann das Werkzeug, das zur gewünschten Ausgabe passt:

- [PDF zu LaTeX](/docs/tools/pdf-to-latex/) für ein LaTeX-Projekt oder Quellarchiv
- [PDF zu Markdown](/docs/tools/pdf-to-markdown/) für bearbeitbares Markdown
- [PDF zu Typst](/docs/tools/pdf-to-typst/) für bearbeitbares Typst

Die lokale PDF-Pipeline liest die Textebene, stellt die Lesereihenfolge wieder her und extrahiert Abbildungen. Wechseln Sie in **PDF zu LaTeX** in den Modus für gescannte Dokumente, wenn die PDF-Datei aus Seitenbildern besteht. Dieser Weg nutzt das Modell für Tools, ein lokales Ollama-Modell, sofern Sie kein anderes wählen, und unterstützt Dokumente mit bis zu 50 Seiten.

Vergleichen Sie das Ergebnis Seite für Seite mit der PDF-Datei. Spalten, Formeln, Tabellen, Fußnoten und Lesereihenfolge sind Rekonstruktionsprobleme, deshalb sollte keine PDF-Umwandlung als ursprüngliche Quelle behandelt werden.

## Literaturangaben hinzufügen, ohne ein Manuskript zu importieren

Importieren Sie BibTeX, RIS, EndNote XML oder Zotero RDF über [Zitationen & Literaturverzeichnis](/docs/citations/#import-a-whole-reference-library). Verknüpfen Sie einen Ordner mit Aufsätzen oder Daten als [schreibgeschützten Recherchekontext](/docs/linked-folders/), wenn er außerhalb des Projekts bleiben soll.