EPUBCheck · Documents de contenu XHTML

EPUBCheck HTM-001 : version XML incorrecte 1.0

Mis à jour : 4 novembre 2026

EPUBCheck HTM-001 est un message d'erreur : “Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: ….” Un fichier XML dans le EPUB déclare une version XML autre que 1.0. EPUB exige que chaque ressource basée sur XML (XHTML chapitres, le document package, le NCX, images SVG) soit un document XML 1.0 valide, et EPUBCheck nomme la version qu'il a trouvée.

Le message officiel

Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: %1$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

Une déclaration XML qui dit version="1.1", écrite par un éditeur ou un outil d'exportation qui par défaut à cela.
Un modèle copié d'un autre projet XML et réutilisé pour chaque chapitre.

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à.
Modifiez la première ligne en <?xml version="1.0" encoding="UTF-8"?>, ou supprimez la déclaration XML : sans celle-ci, le XML 1.0 et UTF-8 sont supposés.
Si l'outil qui a créé le livre écrit 1.1 dans chaque fichier, corrigez son modèle afin que la prochaine exportation soit correcte.
Reconstruire le EPUB et exécuter EPUBCheck à nouveau pour confirmer que le message a disparu.

Quand ce n'est pas ça

Si la déclaration dit 1.0 mais que le fichier est enregistré en UTF-16, c'est HTM_058, pas HTM-001.

Termes utilisés ici

Qu'est-ce que XHTML dans EPUB ?

Autres messages HTM

HTM-003 External entities are not allowed in EPUB v3 documents. External entity declaration found: ….
HTM-004 Irregular DOCTYPE: found "…", expected "…".
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, §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-001 ?

Est-ce que HTM-001 est une erreur ?

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