FAQ & Fehlerbehebung
Schnelle Antworten zu den ersten Schritten, Projekten, Kompilieren, Assistenten und Sicherungen.
Erste Schritte
Abschnitt betitelt „Erste Schritte“Brauche ich ein Konto?
Abschnitt betitelt „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?
Abschnitt betitelt „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 begleitet Sie zu Ihrem ersten PDF.
Kann ich einen bestehenden Aufsatz oder Lebenslauf mitbringen?
Abschnitt betitelt „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, um den richtigen Weg zu wählen.
Kann ich offline arbeiten?
Abschnitt betitelt „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?
Abschnitt betitelt „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 erklärt Projektdateien, App-Einstellungen und Checkpoints.
Kann ich Oleafly für eine Abschlussarbeit oder einen Lebenslauf nutzen?
Abschnitt betitelt „Kann ich Oleafly für eine Abschlussarbeit oder einen Lebenslauf nutzen?“Ja. Beginnen Sie mit dem Ablauf für Abschlussarbeiten oder dem Ablauf für Lebensläufe. Beide nutzen denselben Editor, dieselbe Vorschau, dieselben Referenzen und Exportwerkzeuge wie ein Forschungsaufsatz.
Installation
Abschnitt betitelt „Installation“Das Betriebssystem blockiert das Installationsprogramm
Abschnitt betitelt „Das Betriebssystem blockiert das Installationsprogramm“Prüfen Sie, dass die Datei von den offiziellen Releases (öffnet in einem neuen Tab) stammt und zu Ihrer Plattform passt. Folgen Sie der Installationsanleitung für die Schritte zum ersten Start der Plattform.
Welches Linux-Paket soll ich verwenden?
Abschnitt betitelt „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 zu den Systemanforderungen.
Kompilieren
Abschnitt betitelt „Kompilieren“Meine erste Kompilierung ist langsam
Abschnitt betitelt „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, um zu sehen, was geschieht.
Ein Paket fehlt
Abschnitt betitelt „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.
Ich habe pdfLaTeX gewählt, und Oleafly verlangt eine TeX-Distribution
Abschnitt betitelt „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.
MiKTeX meldet, latexmk braucht Perl
Abschnitt betitelt „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.
In meinem PDF fehlt Text
Abschnitt betitelt „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 und Zeichen, die als Kästchen erscheinen.
Oleafly hat meine Kompilierung abgebrochen, weil sie zu lange dauerte
Abschnitt betitelt „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?
Abschnitt betitelt „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.
Mein Dokument verwendet minted oder PythonTeX
Abschnitt betitelt „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.
Die Kompilierung endete mit Warnungen
Abschnitt betitelt „Die Kompilierung endete mit Warnungen“Öffnen Sie Protokolle und prüfen Sie zuerst undefinierte Zitationen und Referenzen. Preflight hilft, die betroffenen Stellen im Quelltext zu finden, bevor Sie exportieren.
Ich verstehe einen Build-Fehler nicht
Abschnitt betitelt „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 posten.
Warum fehlt ein Exportformat?
Abschnitt betitelt „Warum fehlt ein Exportformat?“Verfügbare Formate hängen von Engine und Dokumenttyp ab. Sehen Sie in der Export-Tabelle nach.
KI-Assistenten
Abschnitt betitelt „KI-Assistenten“Welchen Assistenten kann ich nutzen?
Abschnitt betitelt „Welchen Assistenten kann ich nutzen?“Verbinden Sie einen Modellanbieter, nutzen Sie ein lokales Modell oder wählen Sie einen CLI-Agenten. KI einrichten behandelt jeden Weg.
Brauche ich KI, um den Editor zu nutzen?
Abschnitt betitelt „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?
Abschnitt betitelt „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.
Was bedeutet „Geprüft“ neben einem Modell?
Abschnitt betitelt „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.
Warum wird die Nutzung als Unbekannt angezeigt?
Abschnitt betitelt „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.
Kann ich einen externen Assistenten verbinden?
Abschnitt betitelt „Kann ich einen externen Assistenten verbinden?“Ja. Nutzen Sie eine eingebaute Verbindung für CLI-Agenten, aktivieren Sie Oleaflys lokalen MCP-Server oder verbinden Sie Ihren Agenten mit dem oleafly-Befehl, der auch bei geschlossener App funktioniert.
Historie und Zusammenarbeit
Abschnitt betitelt „Historie und Zusammenarbeit“Wie stelle ich eine frühere Version wieder her?
Abschnitt betitelt „Wie stelle ich eine frühere Version wieder her?“Öffnen Sie Checkpoints, um Quelltext aus erfolgreichen Durchläufen zu vergleichen und eine Version wiederherzustellen. Nutzen Sie die Versionsverwaltung für Git-Commits, die Sie selbst verwalten.
Kann ich mit einem Mitautor arbeiten?
Abschnitt betitelt „Kann ich mit einem Mitautor arbeiten?“Ja. Mit Live-Zusammenarbeit 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 nutzen, um Commits auszutauschen.
Kann ich meine Projekte an zwei Computern nutzen?
Abschnitt betitelt „Kann ich meine Projekte an zwei Computern nutzen?“Ja. Cloud-Abgleich 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 zwischen Computern verschieben.
Sichert der Quelltext-Export alles?
Abschnitt betitelt „Sichert der Quelltext-Export alles?“Er sichert den Projektquelltext. Automatische Checkpoints, App-Einstellungen und Zugangsdaten liegen getrennt. Folgen Sie der Sicherungsanleitung, um alles Nötige einzuschließen.
Ein Problem melden
Abschnitt betitelt „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 (öffnet in einem neuen Tab); nutzen Sie die Discord-Community für Fragen und Hilfe zu Abläufen.