Vous venez de passer votre EPUB dans EPUBCheck et le rapport affiche des dizaines de lignes en anglais, avec des codes comme RSC-005 ou PKG-006. Par où commencer ? Quelles lignes bloquent vraiment la diffusion, lesquelles peuvent attendre ? Cet article explique comment lire un rapport et dans quel ordre le traiter.

Il complète un autre article qui répond à la question inverse : ce qu'EPUBCheck vérifie, et ce qu'il ne peut pas vérifier.

En bref

Commencez par les messages FATAL, puis corrigez les ERROR avant de traiter les WARNING. Ne vous arrêtez pas au code comme RSC-005 : lisez surtout le fichier, la ligne et le texte qui suivent, car c'est là que se trouve la cause réelle du problème.

Que signifient FATAL, ERROR et WARNING dans EPUBCheck ?

Chaque message d'EPUBCheck est associé à un niveau. Les cinq niveaux sont, du plus grave au moins grave :

  • FATAL : le fichier est si endommagé que la vérification ne peut pas se poursuivre normalement. Rien d'autre n'est fiable tant que ce problème n'est pas réglé.
  • ERROR : une règle de la spécification EPUB n'est pas respectée. C'est le niveau à traiter en priorité : un fichier avec des erreurs peut être refusé par un distributeur ou mal affiché selon l'application de lecture.
  • WARNING : un point suspect qui n'est pas forcément une violation de la spécification. À examiner, sans présumer de sa gravité.
  • USAGE : une suggestion de bonne pratique.
  • INFO : une information, sans action requise.

Selon l'outil utilisé pour lancer EPUBCheck, certains messages peuvent être masqués. En ligne de commande, les messages USAGE ne sont pas affichés par défaut ; les messages INFO peuvent en revanche apparaître dans le rapport. Un rapport sans erreur peut donc encore contenir des avertissements ou des informations : il faut aussi les examiner.

Comment lire une erreur dans un rapport EPUBCheck

Un message suit presque toujours le même schéma : le niveau, un code, le fichier concerné avec le numéro de ligne et de colonne, puis un texte explicatif en anglais. Par exemple, un message fictif :

ERROR(RSC-005): EPUB/chapitre-03.xhtml(41,12): Error while parsing file: …

Le code (ici RSC-005) identifie le type de règle. Le fichier et la position indiquent où regarder. Le texte, en général, nomme précisément l'élément fautif : c'est la partie la plus utile, et celle qu'on a tendance à sauter.

Erreurs EPUBCheck fréquentes : RSC-005, RSC-007, RSC-012 et PKG-006

Voici quatre codes qui reviennent souvent. Cette liste n'est pas exhaustive.

  • PKG-006 : le fichier mimetype, qui doit se trouver en premier dans l'archive EPUB, est absent ou mal placé. Cela vient souvent de la façon dont l'archive a été reconstruite : un simple zip d'un dossier ne suffit pas.
  • RSC-005 : une erreur de validation dans un document, par exemple un élément ou un attribut qui n'est pas autorisé à cet endroit. C'est le message le plus courant et le plus varié : la fin du texte précise le problème.
  • RSC-007 : le livre fait référence à une ressource (image, feuille de style, autre document) introuvable dans le fichier.
  • RSC-012 : un lien pointe vers une ancre qui n'existe pas dans le document visé, par exemple une entrée de table des matières dont la destination a disparu.

Dans quel ordre corriger

Un seul problème peut produire des dizaines de messages. Mieux vaut donc procéder par étapes :

  • Étape 1. Traiter d'abord les messages FATAL, puis ceux qui concernent l'archive et le fichier de description du livre (les codes commençant par PKG et OPF). Tant que la structure de base est défaillante, le reste du rapport est peu fiable.
  • Étape 2. Corriger ensuite les ressources manquantes et les liens cassés (RSC-007, RSC-012).
  • Étape 3. Passer aux erreurs de contenu dans les documents (RSC-005 et les erreurs sur les documents XHTML), en commençant par le type d'erreur qui revient le plus souvent.
  • Étape 4. Examiner enfin les avertissements, un par un.

Relancer EPUBCheck après chaque série de corrections : une correction fait souvent disparaître plusieurs messages d'un coup, et peut parfois en révéler d'autres qui étaient masqués.

Quand le rapport est propre

Un rapport sans erreur signifie que le fichier respecte les règles que l'outil sait contrôler. Cela ne garantit pas pour autant la qualité globale du fichier : EPUBCheck ne suffit pas à vérifier l'accessibilité réelle du livre, l'exactitude éditoriale ou commerciale de ses métadonnées, ni la qualité du rendu dans les différentes applications de lecture. Un EPUB sans erreur n'est pas forcément accessible.

Par où commencer ?

Notre analyse gratuite Nommera Prism lance EPUBCheck et Ace sur votre fichier et classe les résultats. Si vous voulez voir où se situent les anomalies détectables et par où commencer, voyez Nommera Prism, notre analyse automatique gratuite ; si vous savez déjà qu'il faut corriger le fichier, la Correction EPUB.