Zum Inhalt springen
EPUBCheck · Ressourcen und Verweise

EPUBCheck RSC-005: Schemafehler in einer Datei

Aktualisiert:

EPUBCheck RSC-005 ist eine Fehlermeldung: „Error while parsing file: ….“ Eine Datei entspricht nicht dem Schema, das EPUB dafür verlangt. Ein Element, Attribut oder Wert ist an der aktuellen Stelle nicht erlaubt, oder etwas Erforderliches fehlt; der Text nach "Error while parsing file:" sagt, was das ist. Es handelt sich um den häufigsten EPUBCheck-Fehler, und ein struktureller Fehler kann mehrere Meldungen auslösen.

Die offizielle Nachricht

Error while parsing file: %1$s

Standard-Schweregrad
Fehler. Das EPUB bricht eine Regel der Spezifikation und ist ungültig. Geschäfte und Sende an Kindle könnten es ablehnen, und EPUBCheck beendet die Ausführung mit Status 1.
EPUBCheck Version
5.4.0

%1$s, %2$s… werden mit der Datei, dem Wert oder dem Element EPUBCheck ausgefüllt.

Typische Ursachen

  • "element X not allowed here" oder "attribute X not allowed here": Elemente, die geschachtelt sind, wo das Schema sie verbietet (ein div innerhalb eines p), oder Attribute, die HTML oder EPUB nicht definiert, oft von Webseiten oder Textverarbeitungsprogrammen kopiert.
  • "Duplicate ID": derselbe ID-Wert, der zweimal in einem Dokument verwendet wird, oft von kopierten Fußnoten oder Überschriften.
  • Fehlende erforderliche Metadaten, wie das dcterms:modified Datum eines EPUB 3 Paketdokuments oder ein fehlendes erforderliches Element wie den Titel im XHTML Kopf.
  • "value of attribute X is invalid": ein Wert des falschen Typs, etwa ein Datum im falschen Format oder eine ID, die mit einer Ziffer beginnt.

Wie man es behebt

  1. Lese den Text nach dem Doppelpunkt: EPUBCheck gibt die Datei, die Zeile und Spalte sowie die eigene Beschreibung des Problems durch den Parser an.
  2. Repariere das Element oder Attribut, auf das es sich bezieht: Verschiebe oder entferne das Element, lösche das unbekannte Attribut oder mache die doppelte id eindeutig und aktualisiere die Links, die darauf verwiesen haben.
  3. Fügen Sie in Paketdokumenten die fehlenden Metadaten hinzu, zum Beispiel <meta property="dcterms:modified">2026-11-03T00:00:00Z</meta> (genau eins, in diesem Format).
  4. Behebe zuerst die ersten Fehler und validiere erneut: Ein struktureller Fehler kann mehrere spätere Fehler verursachen.

Wann es nicht das ist

Wenn die Datei nicht einmal gut formatiertes XML ist (ein nicht escaped & oder ein nicht geschlossener Tag), meldet EPUBCheck anstelle dessen die fatale RSC-016.

Hier verwendete Begriffe

Andere RSC Nachrichten

  • RSC-004 File "…" is encrypted, its content will not be checked.
  • RSC-006 Remote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.
  • RSC-006b Resource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.
  • RSC-003 No rootfile tag with media type "application/oebps-package+xml" was found in the container.
  • RSC-007 Referenced resource "…" could not be found in the EPUB.
  • RSC-002 Required META-INF/container.xml resource could not be found.

Quellen

Nachrichtentext und Schweregrad von EPUBCheck 5.4.0 (W3C, BSD-3-Klausel). Erklärung durch EpubCC.

FAQ

Was bedeutet EPUBCheck RSC-005?

EPUBCheck RSC-005 ist eine Fehlermeldung: „Error while parsing file: ….“ Eine Datei entspricht nicht dem Schema, das EPUB dafür verlangt. Ein Element, Attribut oder Wert ist an der aktuellen Stelle nicht erlaubt, oder etwas Erforderliches fehlt; der Text nach "Error while parsing file:" sagt, was das ist. Es handelt sich um den häufigsten EPUBCheck-Fehler, und ein struktureller Fehler kann mehrere Meldungen auslösen.

Ist RSC-005 ein Fehler?

RSC-005 wird standardmäßig als Fehler gemeldet. Das EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Geschäfte und Senden an Kindle können es ablehnen, und EPUBCheck beendet mit Status 1.

PDF zu EPUB Tools

Jedes Tool verwendet die gleiche Engine. Bis zu 3 Bücher pro Tag sind kostenlos.

Alle Werkzeuge ansehen