EPUBCheck RSC-005: chyba schématu v souboru
Aktualizováno:
EPUBCheck RSC-005 je chybová zpráva: „Error while parsing file: ….“ Soubor neodpovídá schématu, které EPUB vyžaduje pro něj. Element, atribut nebo hodnota není povolena tam, kde je, nebo něco požadovaného chybí; text po "Error while parsing file:" říká, co. Je to nejběžnější EPUBCheck chyba a jedna strukturální chyba může způsobit několik zpráv.
Oficiální zpráva
Error while parsing file: %1$s
- Výchozí závažnost
- Chyba. EPUB porušuje pravidlo specifikace a je neplatný. Obchody a Odeslat do Kindle ho mohou odmítnout, a EPUBCheck ukončuje s chybovým stavem 1.
- verze EPUBCheck
- 5.4.0
%1$s, %2$s… jsou vyplněny souborem, hodnotou nebo prvkem EPUBCheck, který byl nalezen.
Typické příčiny
- "element X not allowed here" nebo "attribute X not allowed here": prvky zanořené tam, kde je to schématem zakázáno (div uvnitř p), nebo atributy, které HTML nebo EPUB nedefinují, často zkopírovány z webových stránek nebo textových procesorů.
- "Duplicate ID": stejná hodnota id použita dvakrát v jednom dokumentu, často zkopírována z poznámek pod čarou nebo nadpisů.
- Chybějící požadovaná metadata, jako je datum dcterms:modified dokumentu balíčku EPUB 3, nebo chybějící požadovaný prvek, jako je název v hlavičce XHTML.
- "value of attribute X is invalid": hodnota nesprávného typu, například datum ve špatném formátu nebo id začínající číslicí.
Jak to opravit
- Přečtěte si text za dvojtečkou: EPUBCheck uvádí soubor, řádek a sloupec a vlastní popis problému parseru.
- Opravit prvek nebo atribut, který uvádí: přesunout nebo odstranit prvek, smazat neznámý atribut nebo učinit duplicitní id unikátním a aktualizovat odkazy, které na něj odkazovaly.
- V balíčkových dokumentech přidejte chybějící metadata, například
<meta property="dcterms:modified">2026-11-03T00:00:00Z</meta>(přesně jedno, v tomto formátu). - Nejprve opravte první chyby a validate znovu: jedna strukturální chyba může způsobit několik pozdějších.
Kdy to není to
Pokud soubor není ani dobře formátovaný XML (neescapovaný & nebo nezavřený tag), EPUBCheck hlásí fatální RSC-016 místo toho.
Podmínky používané zde
Další RSC zprávy
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.
Zdroje
Text zprávy a závažnost od EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Vysvětlení od EpubCC.