EPUBCheck · Document de paquet (OPF)

EPUBCheck OPF-001 : version EPUB illisible

Mis à jour : 4 novembre 2026

EPUBCheck OPF-001 est un message d'erreur : « There was an error when parsing the EPUB version: …. » EPUBCheck n'a pas pu lire la version EPUB du document de paquet. L'attribut version sur l'élément paquet informe les validateurs et les applications de lecture de quel ensemble de règles le livre suit, donc sans une valeur lisible, le reste de la vérification est peu fiable.

Le message officiel

There was an error when parsing the EPUB version: %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

Un élément de paquet manquant ou vide.
Une valeur mal formée, comme version="3" ou version="EPUB 3", au lieu d'un nombre comme 3.0.
Un élément de package écrit à la main ou par un script qui a omis l'attribut.

Comment le corriger

Ouvrez le document du paquet (le fichier .opf) et trouvez l'élément paquet en haut.
Définissez version="3.0" pour EPUB 3 (les livres EPUB 3.3 déclarent toujours 3.0) ou version="2.0" pour EPUB 2.
Exécutez EPUBCheck à nouveau : les erreurs qui dépendaient de la version devraient maintenant être signalées correctement.

Quand ce n'est pas ça

Si EPUBCheck lit la version mais que vous en avez demandé une différente avec -v, c'est PKG-001, pas OPF-001.

Termes utilisés ici

Autres messages OPF

OPF-002 The OPF file "…" was not found in the EPUB.
OPF-003 Item "…" exists in the EPUB, but is not declared in the OPF manifest.
OPF-004 Invalid prefix declaration: leading or trailing whitespace is not allowed.
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.4 The package 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-001 ?

Est-ce que OPF-001 est une erreur ?

OPF-001 est signalé comme erreur par défaut. Le EPUB enfreint une règle de la spécification et est invalide. Les magasins et l'envoi à Kindle peuvent le rejeter, et EPUBCheck se termine avec le statut 1.