EPUBCheck · XHTML Inhaltsdokumente

EPUBCheck HTM-011: nicht deklarierte benannte Entität

Aktualisiert: 4. November 2026

EPUBCheck HTM-011 ist eine Fehlermeldung: „Entity is undeclared.“ Eine benannte Entität wird verwendet, die das Dokument nicht deklariert. XML kennt nur &, <, >, " und ', somit brechen HTML-Namen wie   die XHTML, und das Kapitel wird möglicherweise gar nicht geöffnet.

Die offizielle Nachricht

Entity is undeclared.

Vorschlag von EPUBCheck: Define the entity or use the numbered entity instead.

Standard-Schweregrad: Fehler. Das EPUB bricht eine Regel der Spezifikation und ist ungültig. Geschäfte und Sende an Kindle könnten es ablehnen, und EPUBCheck beendet die Ausführung mit Status 1.
EPUBCheck Version: 5.4.0

Typische Ursachen

HTML-Entities wie  , —, … oder © in XHTML eingefügt.
Text, der aus einem Textverarbeitungsprogramm oder einer Webseite exportiert wurde, wo HTML-Entitätsnamen normal sind.

Wie man es behebt

Öffnen Sie die Datei EPUBCheck Namen (die Nachricht gibt den Pfad, die Zeile und die Spalte an) in einem Text- oder EPUB Editor wie Sigil, oder entpacken Sie die EPUB und öffnen Sie sie dort.
Ersetzen Sie jede benannte Entität durch eine numerische Referenz (  für ein geschütztes Leerzeichen, — für einen langen Gedankenstrich, … für eine Auslassung) oder geben Sie das Zeichen selbst in UTF-8 ein.
Durchsuchen Sie das gesamte Buch nach &, gefolgt von Buchstaben, um die anderen Vorkommen auf einmal zu erfassen.
Rebuild den EPUB und führe EPUBCheck erneut aus, um zu bestätigen, dass die Nachricht verschwunden ist.

Wann es nicht das ist

Wenn die Entität in der DOCTYPE über eine externe Datei deklariert ist, ist die Nachricht HTM-003.

Andere HTM Nachrichten

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

Quellen

EPUB 3.3, §3.9 XML conformance · lesen 4. November 2026
EPUB 3.3, §6.1.2 XHTML requirements · lesen 4. November 2026

Nachrichtentext und Schweregrad von EPUBCheck 5.4.0 (W3C, BSD-3-Klausel). Erklärung durch EpubCC.

FAQ

Was bedeutet EPUBCheck HTM-011?

Ist HTM-011 ein Fehler?

HTM-011 wird standardmäßig als Fehler gemeldet. Das EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Stores und Send to Kindle könnten es zurückweisen, und EPUBCheck endet mit Status 1.