EPUBCheck · XHTML dokumenty treści

EPUBCheck HTM-004: znaleziono nieoczekiwany DOCTYPE

Zaktualizowane: 4 listopada 2026

EPUBCheck HTM-004 to komunikat o błędzie: „Irregular DOCTYPE: found "…", expected "…".” Dokument ma DOCTYPE inny niż oczekiwany dla swojego typu i wersji EPUB. EPUBCheck pokazuje DOCTYPE, który znalazł oraz ten, którego się spodziewał, więc naprawa zwykle polega na skopiowaniu oczekiwanego.

Oficjalna wiadomość

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

DOCTYPE XHTML 1.1 pozostały z książki EPUB 2 wewnątrz pakietu, który teraz deklaruje EPUB 3.
Szablon rozdziału skopiowany z strony internetowej z HTML 4 lub XHTML 1.0 Transitional DOCTYPE.
Plik NCX lub SVG z DOCTYPE, który ma niewłaściwy identyfikator publiczny lub systemowy.

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.
Dla EPUB 3 XHTML rozdziałów, zastąp DOCTYPE <!DOCTYPE html>.
Dla innych plików, użyj dokładnie DOCTYPE EPUBCheck, który pokazuje zgodnie z oczekiwaniami, lub usuń go tam, gdzie format nie pozwala na DOCTYPE.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli EPUBCheck mówi, że DOCTYPE jest przestarzały i może zostać usunięty, to jest HTM-009; HTM-004 pokazuje oczekiwany DOCTYPE.

Terminy używane tutaj

Inne komunikaty HTM

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.

Źródła

EPUB 3.3, §B. Allowed external identifiers · czytaj 4 listopada 2026
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-004?

Czy HTM-004 to błąd?

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