Corriger les erreurs EpubCheck

epubcheck

Vérifier son fichier ePub avec EpubCheck est une étape nécessaire dans le cycle de production d’un ebook. En effet, en cas d’erreur généré par le logiciel EpubCheck il sera refusé à la vente par les librairies en ligne ou par votre distributeur numérique. Cette phase de vérification est complémentaire avec la vérification de la mise en page de votre ePub sur les principaux logiciels de lecture.

Que signifie une erreur epubcheck

Le format ePub s’accompagne de spécifications qui doivent être respectées. Les spécifications sont issues de groupes de travail au sein du W3C. Elles sont disponibles en ligne et peuvent être très utiles lorsque vous rencontrez certaines erreurs EpubCheck.

EpubCheck va donc générer une erreur lorsqu’il voit que votre fichier ne respecte pas les spécifications du format. Votre fichier peut donc avoir une apparence tout à fait correcte et générer une erreur qui va bloquer sa distribution.

Les spécifications établies pour le format ePub visent à assurer une certaine qualité pour les fichiers et une homogénéité dans la manière dont ils sont codés.

Comment vérifier son fichier

Pour vérifier son fichier, vous devez donc disposer d’EpubCheck. La version officielle d’EpubCheck se trouve sur Github. Elle s’utilise en ligne de commande.

Pour plus de facilité, vous pouvez utiliser des outils tels qu’EpubCheck Pagina, qui fonctionne en « drag and drop ». Notre tuto vidéo ci-dessous :

Il faut toujours veiller à bien utiliser la dernière version du logiciel, les spécifications évoluent dans le temps.

EpubCheck indique le fichier où est l’erreur ainsi que sa ligne. Pour pouvoir exploiter cette donnée, il faut ouvrir le fichier avec un éditeur d’ePub (Sigil par exemple) et trouver le fichier en question.

Erreurs communes

L’ePub utilise le format xhtml. Les erreurs vont donc généralement provenir de balises non compatibles avec le format, d’erreur de syntaxe ou d’erreurs liées au xml (généralement signalées dans le fichier content.opf).

Avec Indesign

Pour éviter les erreurs EpubCheck, il est conseillé d’utiliser une version récente d’Indesign. Certaines versions plus anciennes peuvent générer des erreurs.

Indesign lors de la conversion opère un certain nombre d’opération pour ne pas générer d’erreurs EpubCheck. Il transforme par exemple le nom de vos fichiers images.

Une erreur qui peut arriver facilement est si vous remplissez le champs date au format français dans les options d’exportation d’Indesign. Vous aurez alors l’erreur : Date value '27/09/2018' does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:[For input string: "27/09/2018"] is not an integer.

Vous devez mettre alors la date au format anglais : YYYY-MM-DD

Avec Calibre

Avec certaines versions récentes de Calibre, lorsqu’on convertit son fichier .docx au format ePub 3, on peut avoir ce message d’erreur :

XHTML Conctent Documents file name index_000.html should have the extension .xhtml

Cela signifie que l’extension de vos pages n’est pas bonne. Pour corriger cela, vous devez éditer votre ePub et renommer vos pages (dans notre exemple la page devrait se nommer index_000.xhtml).

Avec les images

Vous pouvez avoir des erreurs EpubCheck avec des images, notamment dans les cas suivants :

– Si la balise src ou alt est absente dans le code <img> de l’image. src correspond au lien vers le fichier image, alt correspond au texte alternatif décrivant l’image.

– Si le nom du fichier de l’image contient un espace blanc ou des caractères non compatibles. Indesign retraite le nom du fichier. Sinon évitez les accents et les espaces dans le nom des fichiers images.

– L’absence de couverture. Une couverture est obligatoire. Si vous avez une image en début de livre mais que vous avez une erreur liée à la couverture, vérifiez bien que vous avez marqué le fichier image comme étant une couverture (dans Sigil : clic droit sur le fichier et définir comme image de couverture)

– Si vous avez supprimé une image mais qu’elle est encore présente dans le code. Dans ce cas là, EpubCheck va générer une erreur, notamment car votre image sera encore listée dans le fichier content.opf. Vous devez donc supprimer toutes les mentions de l’image dans le fichier xhtml et dans le fichier content.opf.

– Le format de votre image doit être compatible : png, gif, jpg et svg sont acceptés. Pas les .tiff par exemple.

Avec les liens

Les erreurs avec les liens sont également communes.

Elle peuvent advenir si vous éditez votre ePub et que vous créez une nouvelle page. Selon votre éditeur d’ePub, cela peut briser les liens internes, notamment pour les notes de bas de pages. Dans ce cas là, vous devez éditer l’ePub et corriger les liens des notes (a href=).

Vous pouvez aussi avoir l’erreur http: //www.monsite.com is not a valid URI. Dans notre cas, on a cette erreur car l’url contient une erreur (espace après le:). Si vous avez un message d’erreur c’est du au fait qu’il y une erreur dans l’url. Un site qui n’est plus en ligne ne génère pas d’erreur dans EpubCheck.

Content.opf

Il est courant d’avoir des erreurs mentionnant le fichier content.opf. Il s’agit d’un fichier très sensible. Les erreurs citant le content.opf peuvent notamment être liées à des problèmes avec les métadonnées, au format des fichiers ou à des liens cassés.

Lors de votre analyse de la ligne de l’erreur, si au début de la ligne vous voyez <dc:, il s’agit alors d’une erreur liée aux métadonnées. dc est la contraction de Dublin Core. Dublin Core est un standard international pour les métadonnées dans l’édition.

Vous pouvez avoir des erreurs liées au format de la date, si vous avez mal rempli votre ISBN. Ne modifiez pas ce champ <dc:identifier id="bookid">, il ne doit pas être remplacé par l’ISBN. Pour l’ISBN le code est <dc:identifier>urn:isbn:ISBN ici</dc:identifier>. Si dans votre fichier xhtml vous déclarez une langue, celle-ci doit aussi être renseignée dans les métadonnées (ex : <dc:language>fr-FR</dc:language>).

Si lors de votre analyse, la ligne commence par <item id, alors votre erreur peut être relative à un format de fichier non compatible, à un problème de couverture (absence de couverture selon EpubCheck) ou un fichier est listé mais n’existe pas.

Table des matières

Vous pouvez aussi avoir des erreurs en rapport à votre table des matières. Dans ce cas là, EpubCheck fera référence au fichier toc.xhtml et/ou à toc.ncx. Il peut aussi faire référence au fichier content.opf pour les éléments commençant par <itemref idref=.

Ces erreurs peuvent être assez complexes à corriger. Généralement c’est parce que dans la table des matières vous faites référence à une page ou un sous titre dont le lien ne fonctionne plus. Vérifiez bien votre table des matières puis tentez de la corriger avec Sigil (dans le menu : Outils => Table des Matières => éditer la table des matières).

Correction de votre erreur

Si le tuto n’a pas été suffisant pour corriger votre erreur EpubCheck, nous proposons sur 5euros un micro service de correction, accompagné si besoin d’une formation d’une heure pour apprendre à éditer son ePub et à corriger les erreurs EpubCheck.

Plus de ressources

Certaines erreurs EpubCheck peuvent provenir de la manière dont en amont vous préparez vos documents. On propose des articles et des formations pour faciliter les différentes étapes de création : formation indesign pour la création d’ebook, formation vidéo, article sur la création d’un ebook avec Indesign et avec Libre Office (ou Word). On liste également différents ouvrages autour de la création d’ebook et de leur commercialisation.

Conseils et tutos

Conseils et tutos

Recevez chaque mois des ressources autour de la création d'ebook et de l'édition numérique.

Inscription réussie