EPUB FACTORY
EPUB verstehen / Wenn etwas schiefgeht
Wenn etwas schiefgeht

Wenn ein Fehler beim Einreichen auftaucht
häufige Ursachen und wie man sie behebt

Ein Shop weist Ihr EPUB zurück, oder ein Prüfwerkzeug meldet Fehler. Die Ursachen laufen auf eine Handvoll Muster hinaus. Dieser Artikel legt dar, was zuerst zu prüfen ist und was die Fehler, denen Sie am häufigsten begegnen, tatsächlich bedeuten.
In diesem Artikel
  1. Fangen Sie mit einem Prüfwerkzeug an
  2. Die Fehler, denen Sie begegnen, und ihre Behebung
  3. Wenn es die Prüfung besteht und trotzdem zurückgewiesen wird
  4. Wie man einen Fehler liest

Fangen Sie mit einem Prüfwerkzeug an

Die Fehlermeldung, die ein Shop Ihnen zeigt, ist meist vage. Manchmal steht dort nicht mehr als „Es gibt ein Problem mit Ihrer Datei“.

Das Erste ist deshalb, sie durch ein Prüfwerkzeug namens EPUBCheck laufen zu lassen. Es ist das offizielle Werkzeug des W3C und kostenlos. Es gibt auch Dienste, die es online ausführen.

Das Werkzeug nennt Ihnen genau, welche Datei, welche Zeile und was nicht stimmt. Das bringt Sie der Ursache weit schneller näher als die Fehlermeldung eines Shops.

Wenn es nichts meldet

Wenn EPUBCheck sauber ist und der Shop die Datei trotzdem zurückweist, geht es wahrscheinlich nicht um die EPUB-Spezifikation, sondern um eine Anforderung, die nur dieser Shop stellt. Siehe den Abschnitt weiter unten.

Die Fehler, denen Sie begegnen, und ihre Behebung

Wenn Sie EPUB auf eigene Faust bauen, sind die Fehler, auf die Sie stoßen, ziemlich vorhersehbar.

Fehler rund um mimetype Das ZIP ist nicht korrekt zusammengesetzt

In einem EPUB steckt eine kleine Datei namens mimetype , und die Regel lautet, dass sie als Erstes und unkomprimiert im ZIP abgelegt sein muss.

Einen Ordner mit einem gewöhnlichen Packprogramm zu komprimieren erfüllt diese Bedingung nicht. Es ist das häufigste Problem, wenn ein EPUB von Hand zusammengesetzt wurde.

Die Behebung Erzeugen Sie es mit einem EPUB-Bauwerkzeug neu. Wenn Sie von Hand neu packen müssen, brauchen Sie ein Verfahren, das mimetype zuerst und unkomprimiert ablegt.
Fehler rund um die Anmeldung von Dateien Eine Datei ist nicht gelistet, oder sie ist gelistet, fehlt aber

Jede Datei in einem EPUB muss im <manifest> von content.opf angemeldet sein.

Sie haben ein Bild hinzugefügt und vergessen, es anzumelden, oder eine angemeldete Datei gibt es nicht mehr — beide Unstimmigkeiten erzeugen einen Fehler.

Die Behebung Vergleichen Sie das manifest mit den tatsächlichen Dateien. Neu erzeugen mit einem Werkzeug ist der sichere Weg.
Fehler rund um Pflichtangaben Bibliografische Angaben fehlen

EPUB 3 verlangt Folgendes.

dc:title (der Titel)
dc:language (Sprache; de für Deutsch)
dc:identifier (Kennung)
dcterms:modified (letzte Änderung)

Die Behebung Prüfen Sie, ob Sie nicht mit leeren Feldern umgewandelt haben. Besonders der Titel ist das, was im Regal der lesenden Person erscheint.
Fehler rund um Links Ein Link im Inhaltsverzeichnis führt ins Leere

Ein Link im Inhaltsverzeichnis (nav.xhtml) zeigt auf eine Datei, die es nicht gibt. Das passiert, wenn Sie ein Kapitel löschen und vergessen, das Verzeichnis zu aktualisieren.

Die Behebung Prüfen Sie die Linkziele. Wenn Sie das Manuskript geändert haben, ist das EPUB neu zu bauen der sichere Zug.
Fehler rund um das XHTML selbst Nicht geschlossene Tags und Tippfehler

Der Textkörper eines EPUB ist in XHTML geschrieben, das strenger ist als gewöhnliches HTML. Ein nicht geschlossenes Tag, oder <br> zu schreiben (es muss <br /> heißen), erzeugt einen Fehler.

Das passiert meist, wenn HTML-Tags direkt ins Manuskript getippt wurden.

Die Behebung Nehmen Sie die HTML-Tags aus dem Manuskript heraus. Wenn Sie Auszeichnung brauchen, nutzen Sie die Schreibweise, die Ihr Werkzeug unterstützt.

Wenn es die Prüfung besteht und trotzdem zurückgewiesen wird

Wenn EPUBCheck null Fehler meldet und der Shop die Datei trotzdem zurückweist, ist es eine Anforderung des Shops und nicht der Spezifikation.

Häufige Anforderungen

Anforderungen ändern sich

Die Einreichungsanforderungen jedes Shops werden von Zeit zu Zeit aktualisiert. Bestätigen Sie die aktuellen immer auf den Hilfeseiten dieses Shops.

Zusammenfassungen von Dritten, diesen Artikel eingeschlossen, können veraltet sein. In der Hilfe des Shops nach dem genauen Wortlaut der Fehlermeldung zu suchen ist der zuverlässigste Weg.

Für Kindle

Amazon wandelt das eingereichte EPUB in ein eigenes Format um. Bei diesem Umwandlungsschritt können Probleme auftauchen, deshalb grenzt eine Prüfung im Kindle Previewer vor dem Einreichen die Ursache schneller ein.

Wenn Previewer es öffnet, die Einreichung aber zurückgewiesen wird, liegt das Problem eher bei Ihren Eintragungsangaben oder der Prüfung als bei der Datei selbst.

Wie man einen Fehler liest

EPUBCheck schreibt auf Englisch, aber wenn man die Form kennt, ist es nicht schwer.

ERROR(RSC-001): book.epub/OEBPS/content.opf(12,45):
  File "OEBPS/image/cover.jpg" could not be found.
↑Art ↑welche Datei, welche Zeile ↑was nicht stimmt
KennzeichnungBedeutung
FATALFatal. Die Datei hält überhaupt nicht zusammen
ERRORVerstößt gegen die Spezifikation. Muss behoben werden
WARNINGWarnung. Funktioniert, ist aber nicht empfohlen
INFOInformation. Erfordert meist nichts

Schauen Sie zuerst auf FATAL und ERROR. WARNING lässt sich in der Regel so ausliefern.

Wenn es Dutzende Fehler gibt

Vierzig Fehler am Stück sehen aussichtslos aus, aber sie kommen in der Regel alle aus einer einzigen Ursache.

Eine schlechte Zeile im manifest lässt zum Beispiel jede von dort referenzierte Datei scheitern.Beheben Sie nur den ersten von oben und prüfen Sie erneut — die Zahl bricht oft auf einen Schlag zusammen.

Manchmal ist Neubauen schneller

Wenn Sie ein von einem Werkzeug erzeugtes EPUB von Hand bearbeitet und dabei kaputt gemacht haben, ist ein Neubau aus dem Ursprungsmanuskript meist schneller. Das Manuskript zu korrigieren und neu umzuwandeln ist verlässlicher, als Fehler einzeln zu erschlagen.

Bauen Sie ein EPUB, das die Prüfung besteht

EPUB FACTORY schickt jede erzeugte Datei durch eine standardkonforme Prüfung und zeigt Ihnen das Ergebnis. Ohne Konto, ohne Installation.

EPUB FACTORY ausprobieren
Wenn EPUBCheck durchgeht und Sie trotzdem ein ungutes Gefühl haben

Unsere EPUB-Diagnose zeigt die Stellen auf, die auf dem Papier gültig sind, für echte Leserinnen und Leser aber kaputtgehen — in Ihrer eigenen Sprache. Sie läuft vollständig im Browser, Ihre Datei wird also nirgendwohin geschickt. Kostenlos, ohne Anmeldung.

Ein EPUB prüfen →