Lire un rapport EPUBCheck permet de hiérarchiser les messages. Corriger le fichier demande une étape supplémentaire : comprendre la relation entre la ressource signalée, le manifeste, le document qui l'appelle et l'ordre de lecture.

Une mauvaise correction peut déplacer le problème. Renommer une image supprime un avertissement sur son nom, mais casse tous les chapitres qui la référencent. Ajouter un fichier au manifeste résout RSC-008, mais pas RSC-007 si le fichier n'existe pas réellement.

Méthode sûre

Travaillez sur une copie, corrigez une famille de problèmes à la fois, relancez EPUBCheck après chaque série et ouvrez le livre. Le code indique la catégorie ; le message, le fichier et la ligne indiquent la cause concrète.

Avant toute correction : comprendre les quatre couches

Un EPUB est une archive structurée. Les problèmes les plus fréquents concernent :

  1. le paquet : fichiers ZIP, mimetype, noms et chemins ;
  2. le manifeste : liste des ressources dans content.opf ;
  3. l'ordre de lecture : éléments du spine ;
  4. les références : liens, images, feuilles de style et ancres dans les contenus.

Le même fichier peut être présent dans l'archive mais absent du manifeste, ou déclaré dans le manifeste mais absent de l'archive. Ces deux situations produisent des messages différents.

RSC-007 : ressource référencée introuvable

EPUBCheck a rencontré un lien vers une ressource qu'il ne trouve pas dans le paquet.

Exemple :

<img src="../images/portrait.jpg" alt="Portrait de l'autrice" />

mais le fichier réel s'appelle Portrait.jpg, se trouve dans un autre dossier ou n'a pas été inclus dans l'export.

Comment corriger

  1. Lisez le fichier et la ligne indiqués par EPUBCheck.
  2. Relevez le chemin exact de la référence.
  3. Vérifiez l'existence du fichier dans l'EPUB, avec la même casse.
  4. Si la ressource est nécessaire, ajoutez-la au bon emplacement et au manifeste.
  5. Si elle ne l'est plus, retirez la référence.
  6. Contrôlez les chemins relatifs depuis le document concerné.

Ne créez pas un fichier vide uniquement pour faire disparaître l'erreur : la publication resterait incomplète.

RSC-008 : ressource utilisée mais non déclarée dans le manifeste

Le fichier existe et un document l'utilise, mais content.opf ne le déclare pas dans le manifest.

Exemple :

<item id="portrait"
      href="images/portrait.jpg"
      media-type="image/jpeg" />

Comment corriger

Ajoutez un item avec :

  • un id unique ;
  • le chemin correct ;
  • le véritable type MIME ;
  • les propriétés requises, s'il s'agit d'une ressource particulière comme la navigation ou la couverture.

Si votre outil de création gère normalement le manifeste, mieux vaut corriger la source et réexporter. Une modification manuelle peut être perdue au prochain export.

OPF-085 : valeur marquée comme UUID, mais UUID invalide

Ce message ne signifie pas que l'ISBN est faux. Il signifie qu'un dc:identifier est présenté comme un UUID alors que sa valeur n'en respecte pas la syntaxe.

Exemple incohérent :

<dc:identifier id="pub-id">urn:uuid:12345</dc:identifier>

Un UUID valide suit une forme structurée, par exemple :

<dc:identifier id="pub-id">
  urn:uuid:550e8400-e29b-41d4-a716-446655440000
</dc:identifier>

Comment corriger

  • si l'identifiant doit être un UUID, régénérez un UUID valide dans l'outil de production ;
  • si la valeur est en réalité un autre type d'identifiant, retirez l'étiquette UUID et décrivez correctement sa nature ;
  • vérifiez que unique-identifier pointe vers l'élément voulu ;
  • ne remplacez pas un identifiant publié sans mesurer l'effet sur le suivi de version.

PKG-010 : espaces dans un nom de fichier

EPUBCheck classe ce point comme avertissement. Les espaces peuvent créer des problèmes d'interopérabilité avec d'anciens systèmes de lecture ou être encodés de manière incohérente dans les liens.

Avant :

images/Photo auteur.jpg

Après :

images/photo-auteur.jpg

Renommer proprement

Le changement doit être répercuté dans :

  • le manifeste OPF ;
  • tous les fichiers XHTML ;
  • les feuilles CSS ;
  • le document de navigation ;
  • les éventuels scripts ou métadonnées qui utilisent le chemin.

Une recherche globale sensible à la casse est plus fiable qu'une correction fichier par fichier.

PKG-012 : caractères non ASCII dans un nom de fichier

Ce message de niveau USAGE signale un risque d'interopérabilité avec des systèmes anciens. Il ne dit pas que le nom est interdit par la spécification.

Exemple :

images/château-été.jpg

Forme plus conservatrice :

images/chateau-ete.jpg

Ne présentez donc pas PKG-012 comme une erreur bloquante. Décidez en fonction des canaux visés et de votre politique de compatibilité. Si vous renommez, mettez à jour toutes les références comme pour PKG-010.

Deux codes proches qui exigent des réponses différentes

RSC-007 et RSC-008

  • RSC-007 : la cible n'est pas trouvée dans le paquet ;
  • RSC-008 : la cible est utilisée mais absente du manifeste.

Ajouter une déclaration ne crée pas le fichier. Ajouter le fichier ne crée pas sa déclaration. Vérifiez les deux côtés.

PKG-010 et PKG-012

  • PKG-010 concerne les espaces et est un avertissement ;
  • PKG-012 concerne les caractères non ASCII et est un message d'usage.

Leur sévérité et leur formulation ne doivent pas être confondues.

Ordre de correction recommandé

  1. Traitez les erreurs fatales et les fichiers illisibles.
  2. Corrigez les ressources réellement absentes.
  3. Réparez le manifeste.
  4. Corrigez les liens et ancres.
  5. Vérifiez les identifiants.
  6. Traitez les avertissements de nommage en mettant à jour toutes les références.
  7. Relancez EPUBCheck.
  8. Ouvrez la publication et parcourez navigation, images, notes et liens.

Quand repartir de la source

Réexporter est souvent préférable lorsque :

  • les mêmes erreurs apparaissent dans de nombreux chapitres ;
  • le manifeste est largement incomplet ;
  • le fichier a été retouché par plusieurs outils ;
  • les corrections manuelles seraient écrasées au prochain export ;
  • vous ne savez plus quelle version du document fait foi.

À l'inverse, une correction ciblée dans Sigil ou un autre éditeur EPUB peut être raisonnable pour un petit nombre de liens, à condition de conserver la source et de refaire tous les contrôles.

Ne pas s'arrêter à « zéro erreur »

Un rapport EPUBCheck propre confirme la conformité aux règles qu'il sait tester. Il ne valide ni l'exactitude éditoriale des métadonnées, ni l'accessibilité réelle, ni le rendu sur chaque plateforme.

Sources officielles

Pour aller plus loin

Commencez par Lire un rapport EPUBCheck : par où commencer si vous devez encore hiérarchiser les messages. Pour une vue plus large, consultez aussi ce qu'EPUBCheck vérifie et ce qu'il ne peut pas vérifier.