EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM-004 : DOCTYPE inattendu trouvé

Mis à jour : 4 novembre 2026

EPUBCheck HTM-004 est un message d'erreur : “Irregular DOCTYPE: found "…", expected "…".” Un document a un DOCTYPE autre que celui attendu pour son type et la version de EPUB. EPUBCheck montre le DOCTYPE qu'il a trouvé et celui qu'il attendait, donc le correctif consiste généralement à copier celui attendu.

Le message officiel

Irregular DOCTYPE: found "%1$s", expected "%2$s".

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

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

Causes typiques

Un DOCTYPE XHTML 1.1 conservé d'un livre EPUB 2 à l'intérieur d'un paquet qui déclare maintenant EPUB 3.
Un modèle de chapitre copié à partir d'une page web avec un DOCTYPE HTML 4 ou XHTML 1.0 Transitional.
Un fichier NCX ou SVG avec un DOCTYPE ayant le mauvais identifiant public ou système.

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à.
Pour EPUB 3 XHTML chapitres, remplacez le DOCTYPE par <!DOCTYPE html>.
Pour d'autres fichiers, utilisez exactement le DOCTYPE EPUBCheck montré comme prévu, ou supprimez-le là où le format ne permet pas de DOCTYPE.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si EPUBCheck dit que le DOCTYPE est obsolète et peut être supprimé, c'est HTM-009 ; HTM-004 montre le DOCTYPE attendu.

Termes utilisés ici

Autres messages HTM

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: ….
HTM-007 Empty or whitespace-only value of attribute ssml:ph.
HTM-009 The DOCTYPE provided is obsolete or irregular and can be removed.
HTM-010 Namespace "…" is unusual for the prefix "epub".
HTM-011 Entity is undeclared.

Sources

EPUB 3.3, §B. Allowed external identifiers · lire 4 novembre 2026
EPUB 3.3, §3.9 XML conformance · 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-004 ?

Est-ce que HTM-004 une erreur ?

HTM-004 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.