EPUBCheck · XHTML dokumenty treści

EPUBCheck HTM-001: wersja XML nie jest 1.0

Zaktualizowane: 4 listopada 2026

EPUBCheck HTM-001 to komunikat o błędzie: „Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….” Plik XML w EPUB deklaruje wersję XML inną niż 1.0. EPUB wymaga, aby każdy zasób oparty na XML (XHTML rozdziały, dokument pakietu, NCX, obrazy SVG) był dokumentem XML 1.0 zgodnym, a EPUBCheck wymienia wersję, którą znalazł.

Oficjalna wiadomość

Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: %1$s.

Domyślna powaga: Błąd. EPUB łamie zasady specyfikacji i jest nieprawidłowy. Sklepy i Wysłanie do Kindle mogą go odrzucić, a EPUBCheck kończy działanie ze statusem 1.
Wersja EPUBCheck: 5.4.0

%1$s, %2$s… wypełnione są plikiem, wartością lub elementem EPUBCheck znalezionym.

Typowe przyczyny

Deklaracja XML, która mówi version="1.1", napisana przez edytora lub narzędzie eksportowe, które domyślnie to ustawiają.
Szablon skopiowany z innego projektu XML i używany w każdym rozdziale.

Jak to naprawić

Otwórz plik EPUBCheck (komunikat podaje ścieżkę, linię i kolumnę) w edytorze tekstu lub EPUB, takim jak Sigil, lub wypakuj EPUB i otwórz go tam.
Zmień pierwszą linię na <?xml version="1.0" encoding="UTF-8"?> lub usuń deklarację XML: bez niej XML 1.0 i UTF-8 są domyślnie zakładane.
Jeśli narzędzie, które stworzyło książkę, zapisuje 1.1 w każdym pliku, napraw jego szablon, aby następny eksport był poprawny.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli deklaracja mówi 1.0, ale plik jest zapisany w UTF-16, to jest HTM_058, a nie HTM-001.

Terminy używane tutaj

Co to jest XHTML w EPUB?

Inne komunikaty HTM

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.

Źródła

EPUB 3.3, §3.9 XML conformance · czytaj 4 listopada 2026

Tekst wiadomości i poważność z EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Wyjaśnienie przez EpubCC.

FAQ

Co oznacza EPUBCheck HTM-001?

Czy HTM-001 to błąd?

HTM-001 jest zgłaszany jako błąd domyślnie. EPUB łamie zasady specyfikacji i jest nieprawidłowe. Sklepy i Wyślij do Kindle mogą je odrzucić, a EPUBCheck kończy z kodem stanu 1.