# FAQ & Fehlerbehebung

Schnelle Antworten zu den ersten Schritten, Projekten, Kompilieren, Assistenten und Sicherungen.

## Erste Schritte

### Brauche ich ein Konto?

Nein. Laden Sie Oleafly herunter, öffnen Sie es und schreiben Sie. Optionale Dienste wie ein KI-Anbieter in der Cloud, GitHub oder Dropbox nutzen eigene Konten.

### Unterstützt Oleafly LaTeX, Typst und Markdown?

Ja. Wählen Sie die Engine, wenn Sie ein Projekt anlegen. Jede Engine hat eigene Möglichkeiten zum Bearbeiten und Exportieren. Die [Kurzanleitung](/docs/getting-started/) begleitet Sie zu Ihrem ersten PDF.

### Kann ich einen bestehenden Aufsatz oder Lebenslauf mitbringen?

Ja. Importieren Sie Projektquelltext, ein ZIP-Archiv oder ein Git-Repository. Oleafly hat außerdem Konvertierungswege für DOCX und textbasierte PDFs. Lesen Sie [Ein bestehendes Projekt mitbringen](/docs/import-project/), um den richtigen Weg zu wählen.

### Kann ich offline arbeiten?

Sie können ohne Cloud-Verbindung schreiben, Dateien organisieren, lokale Korrekturhilfen nutzen und ein heruntergeladenes lokales KI-Modell ausführen. Tectonic kann mit zwischengespeicherten Paketen kompilieren. Neue Pakete, entfernte Referenzen, Cloud-Modelle, GitHub und Downloads brauchen eine Verbindung. Bereiten Sie ein Projekt mit einer erfolgreichen Kompilierung vor, bevor Sie es offline nehmen.

### Wo sind meine Dateien?

Ihre Projekte sind gewöhnliche Ordner in Ihrer lokalen Bibliothek. Sie können sie kopieren, sichern oder in einem anderen Werkzeug öffnen. [Wo Ihre Daten liegen](/docs/where-your-data-lives/) erklärt Projektdateien, App-Einstellungen und Checkpoints.

### Kann ich Oleafly für eine Abschlussarbeit oder einen Lebenslauf nutzen?

Ja. Beginnen Sie mit dem [Ablauf für Abschlussarbeiten](/docs/workflows/thesis/) oder dem [Ablauf für Lebensläufe](/docs/workflows/resume/). Beide nutzen denselben Editor, dieselbe Vorschau, dieselben Referenzen und Exportwerkzeuge wie ein Forschungsaufsatz.

## Installation

### Das Betriebssystem blockiert das Installationsprogramm

Prüfen Sie, dass die Datei von den [offiziellen Releases](https://github.com/Oleafly/Oleafly/releases/latest) stammt und zu Ihrer Plattform passt. Folgen Sie der [Installationsanleitung](/docs/install/#first-launch) für die Schritte zum ersten Start der Plattform.

### Welches Linux-Paket soll ich verwenden?

Wählen Sie die Architektur, die zu Ihrem Computer passt, und das AppImage, das Debian-Paket oder das RPM. Siehe [Linux-Installation](/docs/install/#linux) zu den Systemanforderungen.

## Kompilieren

### Meine erste Kompilierung ist langsam

Tectonic muss möglicherweise Pakete herunterladen, die dieses Dokument verwendet, und die erste Kompilierung auf einem Rechner holt außerdem eine Reihe häufig genutzter Pakete. Sie werden für spätere Durchläufe zwischengespeichert. Solange noch Pakete geladen werden, kann die Kompilierung über ihr übliches Fünf-Minuten-Limit hinauslaufen. Öffnen Sie die [Protokolle](/docs/compiling/#reading-the-logs), um zu sehen, was geschieht.

### Ein Paket fehlt

Ist der Offline-Modus eingeschaltet, wählen Sie in der Meldung **Ausschalten und kompilieren**, oder schalten Sie ihn für eine Kompilierung aus, um das Paket zu holen. Verwenden Sie bei einer System-TeX-Toolchain **Finden und installieren** im Fehler. TeX Live von Debian, Ubuntu oder Fedora bekommt seine Pakete über `apt` oder `dnf`. Siehe [LaTeX-Engines und -Pakete](/docs/latex-engines/#recover-from-a-missing-file).

### Ich habe pdfLaTeX gewählt, und Oleafly verlangt eine TeX-Distribution

pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX und pLaTeX laufen auf einer TeX-Distribution, die auf Ihrem Rechner installiert ist. Gibt es keine, öffnet die Wahl eines dieser Compiler einen Dialog, bevor etwas kompiliert wird. Wählen Sie **TinyTeX laden und verwenden**, um eine zu installieren, oder **Zurück zu Tectonic wechseln**, um zur eingebauten Engine zurückzukehren. Nach einer gescheiterten Kompilierung bietet die Vorschau dieselbe Wahl als **TinyTeX laden und verwenden** und **Tectonic verwenden** an. Siehe [Wenn kein TeX installiert ist](/docs/latex-engines/#when-no-tex-is-installed).

### MiKTeX meldet, latexmk braucht Perl

Das `latexmk` von MiKTeX läuft auf Perl, das MiKTeX nicht mitbringt. Installieren Sie Strawberry Perl oder TinyTeX unter **Einstellungen → Engines → LaTeX**, das ein eigenes Perl mitbringt und die Kompilierung von MiKTeX übernimmt. Siehe [MiKTeX und Perl](/docs/latex-engines/#miktex-and-perl).

### In meinem PDF fehlt Text

Die Schrift hat für diese Zeichen keine Glyphen. Das passiert am häufigsten bei koreanischem, chinesischem und japanischem Text, und TeX lässt die Zeichen aus, ohne die Kompilierung scheitern zu lassen. Oleafly warnt Sie und listet sie im Protokoll auf. Fügen Sie in LaTeX die Einrichtung ein, die die Warnung für Ihre Schrift angibt. Laden Sie in Typst das Schriftpaket herunter, das der Hinweis anbietet, oder legen Sie eine Schrift mit den Zeichen in den Ordner `fonts` des Projekts. Setzen Sie in Markdown `mainfont` oder `CJKmainfont` im YAML-Kopf auf eine Schrift, die sie hat. Siehe [Zeichen fehlen im PDF](/docs/latex-engines/#characters-missing-from-the-pdf) und [Zeichen, die als Kästchen erscheinen](/docs/typst/#characters-that-show-as-boxes).

### Oleafly hat meine Kompilierung abgebrochen, weil sie zu lange dauerte

Eine Kompilierung darf 5 Minuten laufen. Solange noch Pakete geladen werden, dehnt sich das Limit auf bis zu 30 Minuten. Markdown zu PDF bekommt 15 Minuten, Quarto und Calepin bekommen eine Stunde. Kompilieren Sie erneut: Ein Download setzt dort fort, wo er stehen geblieben ist. Stellen Sie bei langen Entwürfen auf Tectonic den **Kompiliermodus** im Kompiliermenü auf **Schnell**.

### Können neue Projekte meine eigene TeX-Installation nutzen?

Ja. Öffnen Sie **Einstellungen → Engines → LaTeX** und setzen Sie **Standard-Engine zum Kompilieren** auf **latexmk (System-TeX)**. Neue, importierte und konvertierte LaTeX-Projekte starten dann damit. Siehe [Standard für neue Projekte festlegen](/docs/engines/#set-a-default-for-new-projects).

### Mein Dokument verwendet minted oder PythonTeX

Diese Pakete führen während des Kompilierens andere Programme aus, was Oleafly standardmäßig blockiert. Sie brauchen System-LaTeX. Wenn Sie jeder Datei im Projekt vertrauen, wählen Sie **Externe Befehle erlauben** im Banner über dem Editor. Siehe [Externe Befehle erlauben](/docs/latex-engines/#allow-external-commands).

### Die Kompilierung endete mit Warnungen

Öffnen Sie **Protokolle** und prüfen Sie zuerst undefinierte Zitationen und Referenzen. [Preflight](/docs/preflight/) hilft, die betroffenen Stellen im Quelltext zu finden, bevor Sie exportieren.

### Ich verstehe einen Build-Fehler nicht

Bitten Sie den Assistenten, das Protokoll zu lesen, den Fehler zu beheben und erneut zu kompilieren. Nutzen Sie **Um Freigabe bitten**, wenn Sie vorgeschlagene Aktionen unterwegs prüfen wollen. Sie können das Protokoll auch im Hilfeforum auf [Discord](/discord) posten.

### Warum fehlt ein Exportformat?

Verfügbare Formate hängen von Engine und Dokumenttyp ab. Sehen Sie in der [Export-Tabelle](/docs/export/#editable-formats) nach.

## KI-Assistenten

### Welchen Assistenten kann ich nutzen?

Verbinden Sie einen Modellanbieter, nutzen Sie ein lokales Modell oder wählen Sie einen [CLI-Agenten](/docs/cli-agents/). [KI einrichten](/docs/ai-setup/) behandelt jeden Weg.

### Brauche ich KI, um den Editor zu nutzen?

Nein. Schreiben, Kompilieren, Zitationen, Vorschauen, Diagramme, Projekthistorie und Exporte gibt es auch ohne Assistenten.

### Was kann der Assistent?

Er kann Projektdateien bearbeiten, Quellen nachschlagen, ein PDF prüfen, Abbildungen erstellen, Werkzeuge ausführen und bei der Reparatur eines Builds helfen. Wählen Sie einen Plan und eine Freigaberichtlinie, die zur Arbeit passt. Siehe [Chat & Werkzeuge](/docs/ai-chat/).

### Was bedeutet „Geprüft“ neben einem Modell?

Das Modell hat eine Prüfung seiner Werkzeugaufrufe bestanden. Das hilft Ihnen, ein Modell für Projektaktionen zu wählen; es bewertet weder die Qualität seines Schreibens noch seiner Recherche. Siehe [KI einrichten](/docs/ai-setup/).

### Warum wird die Nutzung als Unbekannt angezeigt?

Manche Anbieter und CLI-Agenten melden keine Nutzung. Unbekannt bedeutet, dass der Wert nicht verfügbar ist. Lesen Sie [Nutzung & Budgets](/docs/ai-usage/).

### Kann ich einen externen Assistenten verbinden?

Ja. Nutzen Sie eine eingebaute [Verbindung für CLI-Agenten](/docs/cli-agents/), aktivieren Sie Oleaflys lokalen [MCP-Server](/docs/mcp/) oder verbinden Sie Ihren Agenten mit dem [`oleafly`-Befehl](/docs/cli/), der auch bei geschlossener App funktioniert.

## Historie und Zusammenarbeit

### Wie stelle ich eine frühere Version wieder her?

Öffnen Sie [Checkpoints](/docs/checkpoints/), um Quelltext aus erfolgreichen Durchläufen zu vergleichen und eine Version wiederherzustellen. Nutzen Sie die [Versionsverwaltung](/docs/git-history/) für Git-Commits, die Sie selbst verwalten.

### Kann ich mit einem Mitautor arbeiten?

Ja. Mit [Live-Zusammenarbeit](/docs/collaboration/) bearbeiten Sie und Ihre Mitautoren dasselbe Projekt gleichzeitig über einen Kollaborationsserver, den Ihre Gruppe betreibt. Jeder von Ihnen behält das Projekt als Dateien auf dem eigenen Computer. Sie können auch Quelltext-Archive teilen oder [GitHub-Sync](/docs/github-sync/) nutzen, um Commits auszutauschen.

### Kann ich meine Projekte an zwei Computern nutzen?

Ja. [Cloud-Abgleich](/docs/cloud-sync/) bewahrt Ihre Bibliotheksprojekte und Einstellungen in Ihrer eigenen Dropbox, und jeder Computer, den Sie verbinden, kann sie herunterladen. Öffnen Sie **Einstellungen → Datenspeicher → Cloud-Abgleich**, um ihn zu verbinden. Sie können ein Projekt auch mit [GitHub-Sync](/docs/github-sync/) zwischen Computern verschieben.

### Sichert der Quelltext-Export alles?

Er sichert den Projektquelltext. Automatische Checkpoints, App-Einstellungen und Zugangsdaten liegen getrennt. Folgen Sie der [Sicherungsanleitung](/docs/where-your-data-lives/#back-up-your-work), um alles Nötige einzuschließen.

## Ein Problem melden

Öffnen Sie **Einstellungen → Hilfe & Über → Infos kopieren** und geben Sie diese Details zusammen mit einer kurzen Beschreibung, Schritten zum Nachvollziehen des Problems und dem einschlägigen Protokoll an. Melden Sie es unter [Issues](https://github.com/Oleafly/Oleafly/issues); nutzen Sie die [Discord-Community](/discord) für Fragen und Hilfe zu Abläufen.
