EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM_054 : espace de noms personnalisé réservé

Mis à jour : 4 novembre 2026

EPUBCheck HTM_054 est un message d'erreur : “Custom attribute namespace ("…") must not include the string "…" in its domain.” Un attribut personnalisé utilise un espace de noms dont le domaine contient w3.org ou idpf.org. EPUB n'autorise les attributs personnalisés préfixés que dans des espaces de noms en dehors de ces deux domaines, qui sont réservés aux normes elles-mêmes.

Le message officiel

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

Gravité par défaut: Erreur. Le EPUB enfreint une règle de la spécification et est invalide. Les magasins et l'envoi à Kindle peuvent le rejeter, et EPUBCheck sort avec le statut 1.
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 attribut dans un espace de noms inventé sous w3.org ou idpf.org, souvent une faute de frappe pour un espace de noms réel.
Un véritable EPUB ou un attribut HTML écrit avec le mauvais URI d'espace de noms, il est donc traité comme un attribut personnalisé.

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à.
Si l'attribut est un standard (tel que epub:type), déclarez son bon espace de noms, par exemple xmlns:epub="http://www.idpf.org/2007/ops".
Si c'est votre propre attribut ou celui d'un fournisseur, déplacez-le vers une URI de namespace sur un domaine que vous contrôlez, ou supprimez-le.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si le problème concerne un nom d'attribut data-*, c'est HTM_061.

Termes utilisés ici

Qu'est-ce que XHTML dans EPUB ?

Autres messages HTM

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 […].

Sources

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

Est-ce que HTM_054 une erreur ?

HTM_054 est signalé comme erreur par défaut. Le EPUB enfreint une règle de la spécification et est invalide. Les boutiques et l'envoi à Kindle peuvent le rejeter, et EPUBCheck se termine avec le statut 1.