EpubCCEPUBCheck RSC-005 : erreur de schéma dans un fichier
Mis à jour :
EPUBCheck RSC-005 est un message d'erreur : “Error while parsing file: ….” Un fichier ne suit pas le schéma que EPUB exige pour lui. Un élément, un attribut ou une valeur n'est pas autorisé à cet endroit, ou quelque chose de requis est manquant ; le texte après "Error while parsing file:" indique lequel. C'est l'erreur EPUBCheck la plus courante, et une erreur structurelle peut provoquer plusieurs messages.
Le message officiel
Error while parsing file: %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
- "element X not allowed here" ou "attribute X not allowed here" : éléments imbriqués là où le schéma les interdit (une div dans un p), ou attributs que HTML ou EPUB ne définissent pas, souvent copiés depuis des pages web ou des traitements de texte.
- "Duplicate ID" : la même valeur d'identifiant utilisée deux fois dans un document, souvent provenant de notes de bas de page ou de titres copiés.
- Métadonnées requises manquantes, comme la date dcterms:modified d'un document de paquet EPUB 3, ou un élément requis manquant tel que le titre dans l'en-tête de XHTML.
- "value of attribute X is invalid" : une valeur du mauvais type, comme une date dans un format incorrect ou un identifiant qui commence par un chiffre.
Comment le corriger
- Lisez le texte après les deux-points : EPUBCheck indique le fichier, la ligne et la colonne, ainsi que la description du problème par le parseur.
- Corrigez l'élément ou l'attribut qu'il nomme : déplacez ou supprimez l'élément, supprimez l'attribut inconnu, ou rendez l'id dupliqué unique et mettez à jour les liens qui y pointaient.
- Dans les documents de package, ajoutez les métadonnées manquantes, par exemple
<meta property="dcterms:modified">2026-11-03T00:00:00Z</meta>(exactement une, dans ce format). - Corrigez d'abord les premières erreurs et validez à nouveau : une erreur structurelle peut en causer plusieurs autres par la suite.
Quand ce n'est pas ça
Si le fichier n'est même pas un XML bien formé (un & non échappé ou une balise non fermée), EPUBCheck signale le RSC-016 fatal à la place.
Termes utilisés ici
Autres messages RSC
RSC-004File "…" is encrypted, its content will not be checked.RSC-006Remote resource reference is not allowed in this context; resource "…" must be located in the EPUB container.RSC-006bResource "…" is located outside the EPUB Container; please check the resource is retrieved in scripted content.RSC-003No rootfile tag with media type "application/oebps-package+xml" was found in the container.RSC-007Referenced resource "…" could not be found in the EPUB.RSC-002Required META-INF/container.xml resource could not be found.
Sources
Texte et gravité du message de EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explication par EpubCC.