EPUBCheck · XHTML Inhaltsdokumente

EPUBCheck HTM-051: Microdata ohne RDFa

Aktualisiert: 4. November 2026

EPUBCheck HTM-051 ist eine Warnmeldung: „Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.“ Der Inhalt verwendet Microdata, jedoch kein RDFa, und das EDUPUB-Profil empfiehlt RDFa Lite. EPUBCheck meldet dies nur, wenn es gegen das EDUPUB-Profil validiert, das durch dc:type-Metadaten oder durch Ausführen mit -profile edupub festgelegt wird. Es ist eine Warnung: die EPUB bleibt gültig.

Die offizielle Nachricht

Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.

Standard-Schweregrad: Warnung. Die EPUB ist weiterhin gültig, aber irgendetwas wird wahrscheinlich Probleme in einigen Leseanwendungen verursachen. EPUBCheck beendet die Ausführung mit 0, es sei denn, Sie übergeben --failonwarnings.
EPUBCheck Version: 5.4.0

Typische Ursachen

Ein Bildungsbuch, das als EDUPUB deklariert ist und dessen semantische Auszeichnung die Attribute itemscope und itemprop verwendet.
Ein Buch, das fälschlicherweise mit -profile edupub validiert wurde.

Wie man es behebt

Wenn das Buch EDUPUB folgen soll, drücke die gleichen Semantiken mit RDFa Lite-Attributen (vocab, typeof, property) aus, anstelle von oder zusätzlich zu Microdata.
Wenn das Buch keine EDUPUB-Publikation ist, entferne den edupub dc:type oder führe EPUBCheck ohne -profile edupub aus.
Rebuild den EPUB und führe EPUBCheck erneut aus, um zu bestätigen, dass die Nachricht verschwunden ist.

Wann es nicht das ist

Außerhalb des EDUPUB-Profils ist Microdata in EPUB 3 erlaubt, und diese Meldung erscheint nicht.

Andere HTM Nachrichten

HTM-048 SVG Fixed-Layout Documents must have a "viewBox" attribute (on the outermost "svg" element).
HTM_054 Custom attribute namespace ("…") must not include the string "…" in its domain.
HTM-047 Viewport metadata "…" has a syntax error
HTM_055 The "…" element should not be used (discouraged construct)
HTM-046 Fixed layout document has no "viewport" meta element.
HTM_056 Viewport metadata has no "…" dimension (both "width" and "height" properties are required)

Quellen

EPUB 3.3, §6.1.3.2 RDFa · lesen 4. November 2026
EPUBCheck wiki: Running EPUBCheck (command-line options) · 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-051?

Ist HTM-051 ein Fehler?

HTM-051 wird standardmäßig als Warnung gemeldet. Der EPUB ist weiterhin gültig, aber etwas könnte Probleme in einigen Lese-Apps verursachen. EPUBCheck beendet mit 0, es sei denn, Sie übergeben --failonwarnings.