EPUBCheck · Document de paquet (OPF)

EPUBCheck OPF-017 : full-path de rootfile vide

Mis à jour : 4 novembre 2026

EPUBCheck OPF-017 est un message d'erreur : “The attribute "full-path" on element "rootfile" must not be empty.” Un élément rootfile dans META-INF/container.xml a un attribut full-path vide. L'attribut doit contenir le chemin vers le document du package ; une valeur vide laisse les applications de lecture sans rien à ouvrir.

Le message officiel

The attribute "full-path" on element "rootfile" must not be empty.

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

Causes typiques

Un modèle container.xml dont le chemin n'a jamais été renseigné.
Un script de construction qui écrit le chemin à partir d'une variable qui s'est avérée vide.
Un chemin supprimé par erreur lors de l'édition du fichier.

Comment le corriger

Ouvrez META-INF/container.xml.
Écrivez le chemin du document du package depuis la racine de l'archive, par exemple full-path="OEBPS/content.opf".
Vérifiez le chemin lettre par lettre par rapport au vrai fichier, puis reconstruisez le EPUB.

Quand ce n'est pas ça

Si l'attribut est complètement manquant, c'est OPF-016.

Termes utilisés ici

Autres messages OPF

OPF-016 The element "rootfile" is missing its required attribute "full-path".
OPF-018 The "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found.
OPF-018b The "remote-resources" property was declared in the Package Document, but no reference to remote resources has been found; please check scripted content to make sure the property is legit.
OPF-015 The property "…" should not be declared in the OPF file.
OPF-014 The property "…" should be declared in the OPF file.
OPF-013 Resource "…" is declared with MIME type "…" in content, but has MIME type "…" in the package document.

Sources

EPUB 3.3, §4.2.6.3.1.3 The rootfile 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-017 ?

Est-ce que OPF-017 est une erreur ?

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