Fehlerbehebung¶

Export schlägt fehl: "Pandoc not found"¶

Wenn der PDF-, DOCX- oder HTML-Export mit der Fehlermeldung "Pandoc not found" abbricht, ist Pandoc nicht auf dem System installiert oder nicht im PATH verfügbar.

Lösung:

Pruefe, ob Pandoc installiert ist: pandoc --version
Falls nicht installiert:
Linux (Debian/Ubuntu): sudo apt install pandoc
macOS: brew install pandoc
Windows: Installer von pandoc.org
Für PDF-Export zusätzlich eine LaTeX-Distribution installieren (z.B. sudo apt install texlive-full).
Starte das Backend nach der Installation neu.

Wenn du Docker verwendest (make prod), sind Pandoc und LaTeX bereits im Container enthalten. In diesem Fall liegt das Problem wahrscheinlich an einem Konfigurationsfehler.

EPUB-Export funktioniert auch ohne Pandoc, da manuscripta eine eigene EPUB-Generierung mitbringt.

Stimmen werden nicht geladen¶

Wenn das Stimmen-Dropdown im Audiobook-Bereich leer bleibt oder "Keine Stimmen verfügbar" anzeigt, kann das mehrere Ursachen haben:

Edge TTS: Benötigt eine Internetverbindung. Die Stimmen werden beim Start der Anwendung in den Voice-Cache geladen. Starte die Anwendung neu, wenn die Stimmen nicht erscheinen.
ElevenLabs: Pruefe, ob der API-Key in den Einstellungen hinterlegt ist (Einstellungen > Audiobook). Der Key wird beim Speichern gegen die ElevenLabs-API validiert.
Google Cloud TTS: Stelle sicher, dass die API-Zugangsdaten korrekt konfiguriert sind.
pyttsx3: Die verfügbaren Stimmen hängen vom Betriebssystem ab. Unter Linux muss espeak oder espeak-ng installiert sein.
Falsche Sprache: Manche Engines bieten nur Stimmen für bestimmte Sprachen an. Stelle sicher, dass die gewählte Buchsprache von der Engine unterstützt wird.

Bilder werden im Export nicht angezeigt¶

Wenn Bilder im Editor sichtbar sind, aber in der exportierten EPUB- oder PDF-Datei fehlen:

Stelle sicher, dass die Bilder als Assets im Buch gespeichert sind (nicht nur als externe URLs).
Pruefe in den Buch-Metadaten, ob das Coverbild korrekt hinterlegt ist.
Bei EPUB: Öffne die EPUB-Datei mit einem ZIP-Tool und prüfe, ob die Bilder im assets/-Ordner vorhanden sind.
Beim Import aus einem write-book-template-Projekt: Die Bildpfade werden automatisch umgeschrieben. Falls Bilder fehlen, prüfe, ob sie im assets/figures/-Ordner des Quellprojekts vorhanden waren.
Für Bücher, die aus externen Quellen importiert wurden (write-book-template, EPUB, DOCX) und auf einer Version älter als v0.15.0 exportiert wurden: PDF- und DOCX-Exporte konnten Bildabbildungen stillschweigend verlieren. v0.15.0 behebt das. Exportiere erneut, um zu prüfen, dass deine Ausgabe nun alle erwarteten Bilder enthält.

Backend startet nicht¶

Wenn make dev oder make prod nicht startet:

Pruefe, ob alle Abhängigkeiten installiert sind: make install
Pruefe, ob Port 8000 (Backend) und Port 5173 (Frontend) frei sind.
Pruefe die Log-Ausgabe auf Fehlermeldungen. Häufige Ursachen: fehlende Python-Pakete, fehlerhafte Plugin-Konfiguration oder beschaedigte SQLite-Datei.
Im Docker-Modus: Pruefe mit docker compose logs die Container-Ausgabe.