EPUBCheck · Paquet et conteneur ZIP

EPUBCheck PKG-022 : incompatibilité d'extension d'image

Mis à jour : 4 novembre 2026

EPUBCheck PKG-022 est un message d'avertissement : “Wrong file extension for image. The image is a "…" file but has the file extension "…".” L'extension d'une image ne correspond pas à son véritable format, par exemple, un fichier PNG nommé .jpg. La plupart des applications de lecture l'affichent toujours, mais les outils qui font confiance à l'extension ou au type de média du manifeste peuvent échouer.

Le message officiel

Wrong file extension for image. The image is a "%1$s" file but has the file extension "%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

Images renommées au lieu d'être converties.
Outils qui enregistrent dans un format mais conservent l'ancienne extension.

Comment le corriger

Renommez le fichier avec la bonne extension ou convertissez-le au format que son nom indique.
Assurez-vous que le type de média du manifeste correspond également au format réel (image/png, image/jpeg…).
Après avoir renommé, mettez à jour chaque référence au fichier : le manifeste dans le document de package, les liens et sources d'images dans le XHTML, et les références url() dans le CSS.

Quand ce n'est pas ça

Si l'image ne peut pas être décodée du tout, le message est PKG-021.

Termes utilisés ici

Autres messages PKG

PKG-021 Corrupted image file encountered.
PKG-023 Validating the EPUB against version 2.0, default validation profile will be used.
PKG-020 OPF file "…" could not be found.
PKG-025 Publication resource must not be located in the META-INF directory
PKG-018 The EPUB file could not be found.
PKG-026 Obfuscated resource must be a Font Core Media Type (was declared as "…" in "…").

Sources

EPUB 3.3, §3.2 Core media types · lire 4 novembre 2026
EPUB 3.3, §5.6.2 The item element · 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-022 ?

Est-ce que PKG-022 est une erreur ?

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