EPUBCheck · XHTML dokumenty obsahu

EPUBCheck HTM-001: XML verze není 1.0

Aktualizováno: 4. listopadu 2026

EPUBCheck HTM-001 je chybová zpráva: „Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….“ XML soubor v EPUB prohlašuje XML verzi jinou než 1.0. EPUB vyžaduje, aby každý XML-založený zdroj (XHTML kapitoly, dokument balíčku, NCX, SVG obrázky) byl platným XML 1.0 dokumentem, a EPUBCheck uvádí verzi, kterou našel.

Oficiální zpráva

Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version 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

Deklarace XML, která říká version="1.1", napsaná editorem nebo exportním nástrojem, který k tomu implicitně přistupuje.
Šablona zkopírovaná z jiného XML projektu a opakovaně použita pro každou kapitolu.

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.
Změňte první řádek na <?xml version="1.0" encoding="UTF-8"?>, nebo odstraňte XML deklaraci: bez ní se předpokládá, že XML 1.0 a UTF-8.
Pokud nástroj, který vytvořil knihu, zapisuje 1.1 do každého souboru, opravte jeho šablonu, aby byl příští export správný.
Znovu sestavte EPUB a znovu spusťte EPUBCheck, abyste potvrdili, že zpráva zmizela.

Kdy to není to

Pokud deklarace říká 1.0, ale soubor je uložen v UTF-16, pak je to HTM_058, ne HTM-001.

Podmínky používané zde

Co je XHTML v EPUB?

Další HTM zprávy

HTM-003 External entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004 Irregular DOCTYPE: found "…", expected "…".
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-001?

Je HTM-001 chyba?

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