EPUBCheck RSC-005: schem FEL i en fil
Uppdaterad:
EPUBCheck RSC-005 är ett felmeddelande: “Error while parsing file: ….” En fil följer inte det schema EPUB kräver för den. Ett element, attribut eller värde är inte tillåtet där det är, eller något som krävs saknas; texten efter "Error while parsing file:" anger vilket. Det är det vanligaste EPUBCheck-felet, och ett strukturellt misstag kan orsaka flera meddelanden.
Det officiella meddelandet
Error while parsing file: %1$s
- Standardsvårighetsgrad
- Fel. EPUB bryter mot en regel i specifikationen och är ogiltig. Butiker och Skicka till Kindle kan avvisa den, och EPUBCheck avslutas med status 1.
- EPUBCheck version
- 5.4.0
%1$s, %2$s… fylls med filen, värdet eller elementet EPUBCheck som hittades.
Typiska orsaker
- "element X not allowed here" eller "attribute X not allowed here": element inbäddade där schemat förbjuder dem (ett div inuti en p), eller attribut som HTML eller EPUB inte definierar, ofta kopierade från webbsidor eller ordbehandlare.
- "Duplicate ID": samma id-värde används två gånger i ett dokument, ofta från kopierade fotnoter eller rubriker.
- Saknad obligatorisk metadata, såsom dcterms:modified datum för ett EPUB 3 paketdokument, eller ett saknat obligatoriskt element såsom titel i XHTML huvudet.
- "value of attribute X is invalid": ett värde av fel typ, såsom ett datum i fel format eller ett id som börjar med en siffra.
Hur man åtgärdar det
- Läs texten efter kolon: EPUBCheck rapporterar filen, raden och kolumnen samt parserns egen beskrivning av problemet.
- Fixera elementet eller attributet som det namnger: flytta eller ta bort elementet, radera den okända attributen, eller gör det duplicerade id:t unikt och uppdatera länkarna som pekade på det.
- I paketdokument, lägg till den saknade metadata, till exempel
<meta property="dcterms:modified">2026-11-03T00:00:00Z</meta>(exakt en, i det formatet). - Fixera de första felen först och validera igen: ett strukturellt fel kan orsaka flera senare.
När det inte är detta
Om filen inte ens är välformaterad XML (en oescapad & eller en oavslutad tagg), rapporterar EPUBCheck den fatala RSC-016 istället.
Villkor som används här
Andra RSC meddelanden
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.
Källor
Meddelandetext och allvarlighetsgrad från EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Förklaring av EpubCC.