EPUBCheck · Document de paquet (OPF)

EPUBCheck OPF-003 : fichier manquant dans le manifeste

Mis à jour : 4 novembre 2026

EPUBCheck OPF-003 est un message d'utilisation : “Item "…" exists in the EPUB, but is not declared in the OPF manifest.” Un fichier est dans l'archive mais n'est pas déclaré dans le manifeste. Les applications de lecture fonctionnent à partir du manifeste, donc un fichier non déclaré peut être ignoré ; ceci est une note d'utilisation, affichée uniquement lorsque EPUBCheck s'exécute avec -u.

Le message officiel

Item "%1$s" exists in the EPUB, but is not declared in the OPF manifest.

Gravité par défaut: Utilisation. Informative uniquement et cachée par défaut : elle apparaît lorsque EPUBCheck s'exécute avec -u (--usage). Cela ne rend pas le EPUB invalide.
version EPUBCheck: 5.4.0

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

Causes typiques

Fichiers système résiduels tels que .DS_Store ou Thumbs.db zippés ensemble avec le livre.
Anciennes images, sauvegardes ou brouillons qui sont restés dans le dossier du livre après modification.
Un nouveau fichier ajouté au dossier sans mettre à jour le manifeste.

Comment le corriger

Vérifiez les noms de fichiers EPUBCheck et décidez si le livre les utilise.
Si le livre ne l'utilise pas, supprimez-le du dossier et reconstruisez l'archive.
Si le livre l'utilise, ajoutez un élément de manifeste avec un id unique, son chemin et son type de média, par exemple <item id="img2" href="images/map.png" media-type="image/png"/>.

Quand ce n'est pas ça

Si le fichier non déclaré est également référencé dans le contenu, EPUBCheck signale également RSC-008, qui est celui à corriger en premier.

Termes utilisés ici

Autres messages OPF

OPF-002 The OPF file "…" was not found in the EPUB.
OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.
OPF-001 There was an error when parsing the EPUB version: ….
OPF-005 Invalid prefix declaration: URI for prefix "…" doesn’t exist.
OPF-006 Invalid prefix declaration: URI "…" is not a valid URI.
OPF-007 Re-declaration of reserved prefix "…".

Sources

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 OPF-003 ?

Est-ce que OPF-003 est une erreur ?

OPF-003 est signalé comme utilisation par défaut. Informatif uniquement et masqué par défaut : il apparaît lorsque EPUBCheck s'exécute avec -u (--usage). Cela ne rend pas le EPUB invalide.