EPUBCheck · XHTML Inhaltsdokumente

EPUBCheck HTM-003: externe Entität deklariert

Aktualisiert: 4. November 2026

EPUBCheck HTM-003 ist eine Fehlermeldung: „External entities are not allowed in EPUB v3 documents. External entity declaration found: ….“ Ein EPUB 3 Dokument deklariert eine externe Entität, was EPUB nicht erlaubt. Externe Entitäten ziehen Text aus einer anderen Datei über den DOCTYPE, und Lese-Apps lösen sie nicht auf, sodass der Text fehlt.

Die offizielle Nachricht

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

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

%1$s, %2$s… werden mit der Datei, dem Wert oder dem Element EPUBCheck ausgefüllt.

Typische Ursachen

Ein DOCTYPE mit einem internen Teilmengen (der Teil in eckigen Klammern), der Entitäten deklariert, die aus einer externen Datei geladen werden.
XML, exportiert aus einem Publikationssystem, das Entitätsdateien für gemeinsamen Text wie den Buchtitel verwendet hat.

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.
Entfernen Sie die Entitätsdeklarationen aus dem DOCTYPE; in XHTML Kapiteln sollte der DOCTYPE nur <!DOCTYPE html> sein.
Ersetzen Sie jede Verwendung der Entität durch den echten Text oder durch eine numerische Zeichenreferenz wie  , wenn sie für ein einzelnes Zeichen stand.
Rebuild den EPUB und führe EPUBCheck erneut aus, um zu bestätigen, dass die Nachricht verschwunden ist.

Wann es nicht das ist

Wenn eine Entität wie   verwendet wird, ohne dass sie deklariert wurde, ist das HTM-011, nicht HTM-003.

Andere HTM Nachrichten

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.

Quellen

EPUB 3.3, §3.9 XML conformance · 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-003?

Ist HTM-003 ein Fehler?

HTM-003 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 beendet mit Status 1.