EPUBCheck · Paquet et conteneur ZIP

EPUBCheck PKG-001 : décalage de version EPUB

Mis à jour : 4 novembre 2026

EPUBCheck PKG-001 est un message d'avertissement : « Validating the EPUB against version … but detected version …. » EPUBCheck a été invité à valider une version EPUB mais le document du package déclare une autre. La version provient de l'attribut version de l'élément package, et EPUBCheck signale le décalage comme un avertissement avant d'appliquer les règles de la version que vous avez demandée.

Le message officiel

Validating the EPUB against version %1$s but detected version %2$s.

Gravité par défaut: Avertissement. Le EPUB est toujours valide, mais quelque chose risque de causer des problèmes dans certaines applications de lecture. EPUBCheck sort avec 0 sauf si vous passez --failonwarnings.
version EPUBCheck: 5.4.0

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

Causes typiques

EPUBCheck a été exécuté avec -v 2.0 ou -v 3.0 et l'élément de package du fichier a un attribut de version différent.
Un script de construction ou un service de validation qui passe toujours la même option -v, quel que soit le livre.
Un livre à moitié converti de EPUB 2 à EPUB 3 dont l'attribut version n'a pas été mis à jour.

Comment le corriger

Exécutez EPUBCheck sans -v sur un fichier .epub empaqueté : il lit la version à partir du document de package.
Si l'attribut de version est incorrect, définissez-le sur la version que le contenu suit réellement : version="3.0" pour EPUB 3.
Validez à nouveau et corrigez les messages pour la bonne version.

Quand ce n'est pas ça

Si EPUBCheck dit qu'il valide par rapport à 2.0 avec le profil par défaut, c'est l'informatif PKG-023, pas un désaccord.

Termes utilisés ici

Autres messages PKG

PKG-003 Unable to read EPUB file header. This is likely a corrupted EPUB file.
PKG-004 Corrupted EPUB ZIP header.
PKG-005 The mimetype file has an extra field of length …. The use of the extra field feature of the ZIP format is not permitted for the mimetype file.
PKG-006 Mimetype file entry is missing or is not the first file in the archive.
PKG-007 The content of the mimetype file must be the string "application/epub+zip"…
PKG-008 Unable to read file "…".

Sources

EPUB 3.3, §5.4 The package element · lire 4 novembre 2026
EPUBCheck wiki: Running EPUBCheck (command-line options) · 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 PKG-001 ?

Est-ce que PKG-001 est une erreur ?

PKG-001 est signalé comme un avertissement par défaut. Le EPUB est toujours valide, mais quelque chose est susceptible de causer des problèmes dans certaines applications de lecture. EPUBCheck sort avec 0 à moins que vous ne passiez --failonwarnings.