EPUBCheck · XHTML Inhaltsdokumente

EPUBCheck HTM_054: reservierter benutzerdefinierter Namensraum

Aktualisiert: 4. November 2026

EPUBCheck HTM_054 ist eine Fehlermeldung: „Custom attribute namespace ("…") must not include the string "…" in its domain.“ Ein benutzerdefiniertes Attribut verwendet einen Namensraum, dessen Domain w3.org oder idpf.org enthält. EPUB erlaubt benutzerdefinierte Attribute mit Präfix nur in Namensräumen außerhalb dieser beiden Domains, die für die Standards selbst reserviert sind.

Die offizielle Nachricht

Custom attribute namespace ("%1$s") must not include the string "%2$s" in its domain.

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

EPUBCheck druckt diese ID mit einem Unterstrich anstelle eines Bindestrichs; diese Seite verwendet die ID genau so, wie EPUBCheck sie berichtet.

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

Typische Ursachen

Ein Attribut in einem erfundenen Namespace unter w3.org oder idpf.org, oft ein Tippfehler für einen echten Namespace.
Ein echtes EPUB oder HTML-Attribut, das mit der falschen Namespace-URI geschrieben wurde, wird als benutzerdefiniertes betrachtet.

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.
Wenn das Attribut ein Standardattribut ist (wie epub:type), geben Sie seinen korrekten Namensraum an, zum Beispiel xmlns:epub="http://www.idpf.org/2007/ops".
Wenn es sich um Ihr eigenes oder das Attribut eines Anbieters handelt, verschieben Sie es zu einer Namensraum-URI auf einer von Ihnen kontrollierten Domain oder entfernen Sie es.
Rebuild den EPUB und führe EPUBCheck erneut aus, um zu bestätigen, dass die Nachricht verschwunden ist.

Wann es nicht das ist

Wenn das Problem ein data-* Attributsname ist, ist das HTM_061.

Andere HTM Nachrichten

HTM_055 The "…" element should not be used (discouraged construct)
HTM_056 Viewport metadata has no "…" dimension (both "width" and "height" properties are required)
HTM-051 Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM_057 Viewport "…" value must be a positive number or the keyword "device-…"
HTM_058 HTML documents must be encoded in UTF-8, but UTF-16 was detected.
HTM_059 Viewport "…" property must not be defined more than once, but found values […].

Quellen

EPUB 3.3, §6.1.3.5 Custom attributes · 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_054?

Ist HTM_054 ein Fehler?

HTM_054 wird standardmäßig als Fehler gemeldet. Der EPUB verstößt gegen eine Regel der Spezifikation und ist ungültig. Shops und Senden an Kindle können es ablehnen, und EPUBCheck beendet mit Status 1.