EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM-011 : entité nommée non déclarée

Mis à jour : 4 novembre 2026

EPUBCheck HTM-011 est un message d'erreur : “Entity is undeclared.” Une entité nommée est utilisée que le document ne déclare pas. XML ne connaît que &, <, >, " et ', donc des noms HTML tels que   rompent le XHTML et le chapitre peut ne pas s'ouvrir du tout.

Le message officiel

Entity is undeclared.

Suggestion de EPUBCheck : Define the entity or use the numbered entity instead.

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

Causes typiques

Des entités HTML telles que  , —, … ou © collées dans XHTML.
Texte exporté d'un traitement de texte ou d'une page web, où les noms d'entités HTML sont normaux.

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à.
Remplacez chaque entité nommée par une référence numérique (  pour un espace insécable, — pour un tiret em, … pour une ellipse) ou tapez le caractère lui-même dans UTF-8.
Recherchez tout le livre pour & suivi de lettres pour capturer les autres occurrences en une fois.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si l'entité est déclarée dans le DOCTYPE via un fichier externe, le message est HTM-003.

Termes utilisés ici

Qu'est-ce que XHTML dans EPUB ?

Autres messages HTM

HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-007 Empty or whitespace-only value of attribute ssml:ph.
HTM-004 Irregular DOCTYPE: found "…", expected "…".
HTM-003 External entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-001 Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….

Sources

EPUB 3.3, §3.9 XML conformance · lire 4 novembre 2026
EPUB 3.3, §6.1.2 XHTML requirements · 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-011 ?

Est-ce que HTM-011 une erreur ?

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