EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM_055 : élément HTML déconseillé

Mis à jour : 4 novembre 2026

EPUBCheck HTM_055 est un message d'usage : “The "…" element should not be used (discouraged construct).” Le document utilise un élément HTML que EPUB déconseille. EPUB 3.3 liste base, rp et embed comme des constructions déconseillées car elles causent des problèmes d'interopérabilité ; EPUBCheck nomme l'élément et le rapporte en tant que note d'usage.

Le message officiel

The "%1$s" element should not be used (discouraged construct)

Gravité par défaut: Utilisation. Informative uniquement et cachée par défaut : elle apparaît lorsque EPUBCheck s'exécute avec -u (--usage). Cela ne rend pas le EPUB invalide.
version EPUBCheck: 5.4.0

EPUBCheck imprime cet ID avec un soulignement au lieu d'un tiret ; cette page utilise l'ID tel que EPUBCheck le rapporte.

%1$s, %2$s… sont remplis avec le fichier, la valeur ou l'élément EPUBCheck trouvé.

Causes typiques

Un élément de base copié à partir d'une page web, qui peut faire pointer des liens relatifs vers un site web.
éléments rp autour des annotations ruby, dont les applications de lecture EPUB 3 n'ont pas besoin.
Un élément embed utilisé pour un contenu scripté ou interactif.

Comment le corriger

Ouvrez le fichier EPUBCheck (le message indique le chemin, la ligne et la colonne) dans un éditeur de texte ou EPUB tel que Sigil, ou décompressez le EPUB et ouvrez-le là.
Supprimer les éléments de base et s'assurer que chaque lien est relatif au chapitre lui-même.
Supprimer les éléments rp et conserver la balise ruby et rt.
Remplacez embed par object, qui dispose d'un mécanisme de remplacement, ou par une image simple.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si l'élément est obsolète plutôt que déconseillé, EPUBCheck le signale comme OBS-001.

Termes utilisés ici

Qu'est-ce que XHTML dans EPUB ?

Autres messages HTM

HTM_054 Custom attribute namespace ("…") must not include the string "…" in its domain.
HTM_056 Viewport metadata has no "…" dimension (both "width" and "height" properties are required)
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-051 Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.
HTM_059 Viewport "…" property must not be defined more than once, but found values […].

Sources

EPUB 3.3, §6.1.4.3 Discouraged constructs · 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_055 ?

Est-ce que HTM_055 une erreur ?

HTM_055 est signalé comme utilisation par défaut. Informative seulement et cachée par défaut : elle apparaît lorsque EPUBCheck est exécuté avec -u (--usage). Cela ne rend pas le EPUB invalide.