EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM-051 : Microdata sans RDFa

Mis à jour : 4 novembre 2026

EPUBCheck HTM-051 est un message d'avertissement : “Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.” Le contenu utilise des Microdata mais pas de RDFa, et le profil EDUPUB recommande RDFa Lite. EPUBCheck n'alerte cela que lorsqu'il valide par rapport au profil EDUPUB, défini par les métadonnées dc:type ou en le faisant fonctionner avec -profile edupub. C'est un avertissement : le EPUB reste valide.

Le message officiel

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

Gravité par défaut: Avertissement. Le EPUB est toujours valide, mais quelque chose risque de causer des problèmes dans certaines applications de lecture. EPUBCheck sort avec 0 sauf si vous passez --failonwarnings.
version EPUBCheck: 5.4.0

Causes typiques

Un livre éducatif déclaré comme EDUPUB dont la balise sémantique utilise les attributs itemscope et itemprop.
Un livre validé avec -profile edupub par erreur.

Comment le corriger

Si le livre est censé suivre EDUPUB, exprimez la même sémantique avec des attributs RDFa Lite (vocab, typeof, property) plutôt qu'avec, ou en plus de, Microdata.
Si le livre n'est pas une publication EDUPUB, retirez le edupub dc:type ou exécutez EPUBCheck sans -profile edupub.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

En dehors du profil EDUPUB, le Microdata est autorisé dans EPUB 3 et ce message n'apparaît pas.

Termes utilisés ici

Qu'est-ce que XHTML dans EPUB ?

Autres messages HTM

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)

Sources

EPUB 3.3, §6.1.3.2 RDFa · lire 4 novembre 2026
EPUBCheck wiki: Running EPUBCheck (command-line options) · lire 4 novembre 2026

Texte et gravité du message de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explication par EpubCC.

FAQ

Que signifie EPUBCheck HTM-051 ?

Est-ce que HTM-051 une erreur ?

HTM-051 est signalé comme avertissement par défaut. Le EPUB est toujours valide, mais quelque chose est susceptible de poser des problèmes dans certaines applications de lecture. EPUBCheck se termine avec 0 sauf si vous passez --failonwarnings.