EPUBCheck · XHTML inhoudsdocumenten

EPUBCheck HTM-011: niet verklaarde benoemde entiteit

Bijgewerkt: 4 november 2026

EPUBCheck HTM-011 is een foutmelding: “Entity is undeclared.” Een benoemde entiteit wordt gebruikt die het document niet verklaart. XML kent alleen &, <, >, " en ', dus HTML-namen zoals   verstoren de XHTML en het hoofdstuk opent mogelijk helemaal niet.

Het officiële bericht

Entity is undeclared.

EPUBCheck's suggestie: Define the entity or use the numbered entity instead.

Standaard ernst: Fout. De EPUB overtreedt een regel van de specificatie en is ongeldig. Opslaan en Verzenden naar Kindle kunnen het afwijzen, en EPUBCheck verlaat met status 1.
EPUBCheck versie: 5.4.0

Typische oorzaken

HTML-entiteiten zoals  , —, … of © geplakt in XHTML.
Tekst geëxporteerd vanuit een tekstverwerker of een webpagina, waarbij HTML-entiteit namen normaal zijn.

Hoe het te repareren

Open het bestand EPUBCheck namen (het bericht geeft het pad, de regel en de kolom) in een tekst- of EPUB editor zoals Sigil, of unzip de EPUB en open het daar.
Vervang elke benoemde entiteit door een numerieke referentie (  voor een niet-afbrekende spatie, — voor een lange streep, … voor een ellips) of typ het teken zelf in UTF-8.
Zoek het hele boek op & gevolgd door letters om de andere vermeldingen in één keer te vangen.
Herbouw de EPUB en voer EPUBCheck opnieuw uit om te bevestigen dat het bericht is verdwenen.

Wanneer het niet dit is

Als de entiteit in de DOCTYPE is verklaard via een extern bestand, is het bericht HTM-003.

Andere HTM berichten

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: ….

Bronnen

EPUB 3.3, §3.9 XML conformance · lezen 4 november 2026
EPUB 3.3, §6.1.2 XHTML requirements · lezen 4 november 2026

Berichttekst en ernst van EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Uitleg door EpubCC.

FAQ

Wat betekent EPUBCheck HTM-011?

Is HTM-011 een fout?

HTM-011 wordt standaard als fout gerapporteerd. De EPUB overtreedt een regel van de specificatie en is ongeldig. Opslaan en Verzenden naar Kindle kunnen het weigeren, en EPUBCheck verlaat met status 1.