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
- Lese den Text nach dem Doppelpunkt: EPUBCheck gibt die Datei, die Zeile und Spalte sowie die eigene Beschreibung des Problems durch den Parser an.
- 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.
- 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). - 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-004File "…" is encrypted, its content will not be checked.RSC-006Remote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.RSC-006bResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.RSC-003No rootfile tag with media type "application/oebps-package+xml" was found in the container.RSC-007Referenced resource "…" could not be found in the EPUB.RSC-002Required 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.