EPUBCheck · XHTML inhoudsdocumenten

EPUBCheck HTM-003: externe entiteit verklaard

Bijgewerkt: 4 november 2026

EPUBCheck HTM-003 is een foutmelding: “External entities are not allowed in EPUB v3 documents. External entity declaration found: ….” Een EPUB 3 document verklaart een externe entiteit, die EPUB niet toestaat. Externe entiteiten halen tekst uit een ander bestand via de DOCTYPE, en lees-apps lossen deze niet op, zodat de tekst ontbreekt.

Het officiële bericht

External entities are not allowed in EPUB v3 documents. External entity declaration found: %1$s.

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

%1$s, %2$s… zijn ingevuld met het bestand, waarde of element EPUBCheck gevonden.

Typische oorzaken

Een DOCTYPE met een interne subset (het deel in vierkante haken) die entiteiten declareert die zijn geladen vanuit een extern bestand.
XML geëxporteerd vanuit een publicatiesysteem dat entiteitsbestanden gebruikte voor gedeelde tekst zoals de titel van het boek.

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.
Verwijder de entiteitsverklaringen uit de DOCTYPE; in XHTML hoofdstukken zou de DOCTYPE alleen <!DOCTYPE html> moeten zijn.
Vervang elk gebruik van de entiteit door de echte tekst, of door een numerieke tekenreferentie zoals   wanneer het stond voor een enkel teken.
Herbouw de EPUB en voer EPUBCheck opnieuw uit om te bevestigen dat het bericht is verdwenen.

Wanneer het niet dit is

Als een entiteit zoals   wordt gebruikt zonder volledig te worden gedeclareerd, dat is HTM-011, niet HTM-003.

Andere HTM berichten

HTM-004 Irregular DOCTYPE: found "…", expected "…".
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.

Bronnen

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

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

FAQ

Wat betekent EPUBCheck HTM-003?

Is HTM-003 een fout?

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