EPUBCheck · XHTML dokumenty obsahu

EPUBCheck HTM-004: nalezen neočekávaný DOCTYPE

Aktualizováno: 4. listopadu 2026

EPUBCheck HTM-004 je chybová zpráva: „Irregular DOCTYPE: found "…", expected "…".“ Dokument má DOCTYPE jiný než ten, který je očekáván pro jeho typ a EPUB verzi. EPUBCheck ukazuje DOCTYPE, který našel, a ten, který očekával, takže oprava obvykle spočívá v zkopírování očekávaného.

Oficiální zpráva

Irregular DOCTYPE: found "%1$s", expected "%2$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

Soubor XHTML 1.1 DOCTYPE zůstal z knihy EPUB 2 uvnitř balíčku, který nyní deklaruje EPUB 3.
Šablona kapitoly zkopírovaná z webové stránky se HTML 4 nebo XHTML 1.0 přechodným DOCTYPE.
NCX nebo SVG soubor s DOCTYPE, který má nesprávný veřejný nebo systémový identifikátor.

Jak to opravit

Otevřete soubor EPUBCheck jmen (hlášení dává cestu, řádek a sloupec) v textovém nebo EPUB editoru, jako je Sigil, nebo rozbalte EPUB a otevřete ho tam.
Pro EPUB 3 XHTML kapitoly, nahraďte DOCTYPE <!DOCTYPE html>.
Pro ostatní soubory použijte přesně DOCTYPE, který EPUBCheck zobrazuje, jak se očekává, nebo jej odstraňte, pokud formát neumožňuje žádný DOCTYPE.
Znovu sestavte EPUB a znovu spusťte EPUBCheck, abyste potvrdili, že zpráva zmizela.

Kdy to není to

Pokud EPUBCheck říká, že DOCTYPE je zastaralý a může být odstraněn, to je HTM-009; HTM-004 ukazuje očekávaný DOCTYPE.

Podmínky používané zde

Další HTM zprávy

HTM-003 External entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-001 Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….
HTM-007 Empty or whitespace-only value of attribute ssml:ph.
HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-011 Entity is undeclared.

Zdroje

EPUB 3.3, §B. Allowed external identifiers · číst 4. listopadu 2026
EPUB 3.3, §3.9 XML conformance · číst 4. listopadu 2026

Text zprávy a závažnost od EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Vysvětlení od EpubCC.

FAQ

Co znamená EPUBCheck HTM-004?

Je HTM-004 chyba?

HTM-004 je ve výchozím nastavení hlášena jako chyba. EPUB porušuje pravidlo specifikace a je neplatná. Obchody a Odeslat do Kindle ji mohou odmítnout, a EPUBCheck končí s kódem 1.