EPUBCheck · XHTML dokumenty treści

EPUBCheck HTM-011: niezadeklarowana nazwana encja

Zaktualizowane: 4 listopada 2026

EPUBCheck HTM-011 to komunikat o błędzie: „Entity is undeclared.” Używana jest nazwana encja, której dokument nie deklaruje. XML zna tylko &, <, >, " i ', więc nazwy HTML, takie jak  , łamią XHTML i rozdział może wcale się nie otworzyć.

Oficjalna wiadomość

Entity is undeclared.

Sugestia EPUBCheck: Define the entity or use the numbered entity instead.

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

Typowe przyczyny

Podstawione byty HTML, takie jak  , —, … lub © w XHTML.
Tekst wyeksportowany z edytora tekstu lub strony internetowej, gdzie nazwy encji HTML są normalne.

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.
Zastąp każdą nazwane encję numerycznym odniesieniem (  dla spacji niełamliwej, — dla em-dash, … dla wielokropka) lub wpisz sam znak w UTF-8.
Przeszukaj całą książkę w poszukiwaniu &, po którym następują litery, aby uchwycić inne wystąpienia naraz.
Odbuduj EPUB i uruchom ponownie EPUBCheck, aby potwierdzić, że komunikat zniknął.

Kiedy to nie to

Jeśli encja jest zadeklarowana w DOCTYPE poprzez zewnętrzny plik, komunikat to HTM-003.

Terminy używane tutaj

Co to jest XHTML w EPUB?

Inne komunikaty HTM

HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-007 Empty or whitespace-only value of attribute ssml:ph.
HTM-004 Irregular DOCTYPE: found "…", expected "…".
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: ….

Źródła

EPUB 3.3, §3.9 XML conformance · czytaj 4 listopada 2026
EPUB 3.3, §6.1.2 XHTML requirements · 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-011?

Czy HTM-011 to błąd?

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