EPUBCheck · XHTML dokumenty obsahu

EPUBCheck HTM-003: externí entita prohlášena

Aktualizováno: 4. listopadu 2026

EPUBCheck HTM-003 je chybová zpráva: „External entities are not allowed in EPUB v3 documents. External entity declaration found: ….“ EPUB 3 dokument prohlašuje externí entitu, což EPUB nepovoluje. Externí entity načítají text z jiného souboru prostřednictvím DOCTYPE, a čtecí aplikace je nevyřeší, takže by text chyběl.

Oficiální zpráva

External entities are not allowed in EPUB v3 documents. External entity declaration found: %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

DOCTYPE s interním podmnožinou (část ve hranatých závorkách), která deklaruje entity načítané z externího souboru.
XML exportováno z publikačního systému, který používal soubory entit pro sdílený text, jako je název knihy.

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.
Odstraňte deklarace entit z DOCTYPE; v XHTML kapitolách by měl být DOCTYPE pouze <!DOCTYPE html>.
Nahraďte každé použití entity skutečným textem, nebo číselnou znakovou referencí, jako je  , když představovala jediný znak.
Znovu sestavte EPUB a znovu spusťte EPUBCheck, abyste potvrdili, že zpráva zmizela.

Kdy to není to

Pokud je entita jako   použita bez deklarace, to je HTM-011, ne HTM-003.

Podmínky používané zde

Co je XHTML v EPUB?

Další HTM zprávy

HTM-004 Irregular DOCTYPE: found "…", expected "…".
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, §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-003?

Je HTM-003 chyba?

HTM-003 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.