EPUBCheck RSC-005: schema-fout in een bestand
Bijgewerkt:
EPUBCheck RSC-005 is een foutmelding: “Error while parsing file: ….” Een bestand volgt niet het schema dat EPUB vereist. Een element, attribuut of waarde is niet toegestaan waar het is, of iets vereiste ontbreekt; de tekst na "Error while parsing file:" zegt wat. Het is de meest voorkomende EPUBCheck-fout, en één structurele fout kan meerdere berichten veroorzaken.
Het officiële bericht
Error while parsing file: %1$s
- Standaard ernst
- Fout. De EPUB overtreedt een regel van de specificatie en is ongeldig. Opslaan en Verzenden naar Kindle kunnen het afwijzen, en EPUBCheck verlaat met status 1.
- EPUBCheck versie
- 5.4.0
%1$s, %2$s… zijn ingevuld met het bestand, waarde of element EPUBCheck gevonden.
Typische oorzaken
- "element X not allowed here" of "attribute X not allowed here": elementen genest waar het schema ze verbiedt (een div binnen een p), of attributen die HTML of EPUB niet definieert, vaak gekopieerd van webpagina's of tekstverwerkers.
- "Duplicate ID": dezelfde id-waarde die twee keer in één document wordt gebruikt, vaak van gekopieerde voetnoten of koppen.
- Ontbrekende vereiste metadata, zoals de dcterms:modified datum van een EPUB 3 pakketdocument, of een ontbrekend vereiste element zoals titel in de XHTML kop.
- "value of attribute X is invalid": een waarde van het verkeerde type, zoals een datum in het verkeerde formaat of een id die begint met een cijfer.
Hoe het te repareren
- Lees de tekst na de dubbele punt: EPUBCheck rapporteert het bestand, de regel en kolom, en de eigen beschrijving van het probleem door de parser.
- Herstel het element of attribuut dat het benoemt: verplaats of verwijder het element, verwijder het onbekende attribuut, of maak de dubbele id uniek en werk de links bij die ernaar verwezen.
- Voeg in pakketdocumenten de ontbrekende metadata toe, bijvoorbeeld
<meta property="dcterms:modified">2026-11-03T00:00:00Z</meta>(exact één, in dat formaat). - Herstel eerst de eerste fouten en valideer opnieuw: één structurele fout kan meerdere latere veroorzaken.
Wanneer het niet dit is
Als het bestand zelfs niet goed gevormd XML is (een ongeëscaped & of een niet-gesloten tag), meldt EPUBCheck de fatale RSC-016 in plaats daarvan.
Termen die hier worden gebruikt
Andere RSC berichten
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.
Bronnen
Berichttekst en ernst van EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Uitleg door EpubCC.