EPUBCheck · Paquet et conteneur ZIP

EPUBCheck PKG-010 : espace dans un nom de fichier

Mis à jour : 4 novembre 2026

EPUBCheck PKG-010 est un message d'avertissement : «The file name "…" contains spaces, which may create interoperability issues with older reading systems. » Un nom de fichier à l'intérieur du EPUB contient des espaces. Cela est autorisé, mais cela peut perturber les anciens systèmes de lecture, et chaque URL pointant vers le fichier doit ensuite encoder l'espace correctement.

Le message officiel

The file name "%1$s" contains spaces, which may create interoperability issues with older reading systems.

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 ou chapitres nommés d'après leurs titres originaux, comme "Chapter 1.xhtml".
Fichiers exportés d'un traitement de texte ou d'un outil de mise en page qui conserve les noms de documents.

Comment le corriger

Renommez le fichier avec des tirets ou des soulignements au lieu des espaces.
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.
Si vous conservez l'espace, chaque URL pointant vers le fichier doit l'encoder sous forme de %20.

Quand ce n'est pas ça

Si le nom contient des caractères tels que : ou ?, l'erreur est PKG-009 ; une URL mal encodée est RSC-020.

Termes utilisés ici

Qu'est-ce que le conteneur EPUB (OCF) ?

Autres messages PKG

PKG-009 The file name "…" contains characters that are not allowed in OCF file names: ….
PKG-011 The file name "…" is not allowed to end with ".".
PKG-008 Unable to read file "…".
PKG-012 The file name "…" contains non-ASCII characters, which might create interoperability issues with older reading systems.
PKG-007 The content of the mimetype file must be the string "application/epub+zip"…
PKG-006 Mimetype file entry is missing or is not the first file in the archive.

Sources

EPUB 3.3, §4.2.3 File paths and file names · 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-010 ?

Est-ce que PKG-010 est une erreur ?

PKG-010 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.