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. On vous indique ci-dessous la manière de corriger les erreurs et si besoin on propose un micro service de correction (à partir de 10 euros).
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.
ePub refusé sur KDP, Kobo ou votre distributeur numérique
Très souvent, si votre ePub est refusé sur les librairies en ligne ou sur les plate formes d’auto édition (KDP, Kobo, Bookel etc.), c’est parcequ’il contient une erreur de type EpubCheck. Suivez les étapes ci-dessous pour vérifier que votre ebook ne contient pas d’erreurs ou pour voir comment les corriger. Un ePub peut également être refusé car son poids est trop élevé ou en raison de caractères spéciaux dans le nom du fichier.
Comment vérifier son fichier ePub avec EpubCheck
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 ». Le W3C propose une liste d’outils pour valider son ePub (en drag and drop, dans Sigil, dans Calibre). Ci-dessous la manière de vérifier votre ePub avec EpubCheck Pagina :
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 EpubCheck 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
Erreur ePub 2
Une erreur peut advenir quand on exporte au format ePub 2 :
Error while parsing file: attribute « class » not allowed here; expected attribute « dir », « lang », « version » or « xml:lang »
Dans ce cas, vous devez votre ePub et en début de chaque page, vous aurez un code de ce type :
<html xmlns="http://www.w3.org/1999/xhtml" class="calibre">Enlevez :
class="calibre"Votre code final devrait ressembler à cela :
<html xmlns="http://www.w3.org/1999/xhtml">Et vérifiez à nouveau dans EpubCheck. On peut vous aider à corriger l’erreur pour 10 euros.
Erreur ePub 3
Lorsqu’on convertit son fichier .docx au format ePub 3, on peut avoir ce message d’erreur :
XHTML Content Documents file name index_000.html should have the extension .xhtmlCela 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). Si besoin, on peut corriger l’erreur à votre place pour 10 euros.
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 (accents, ponctuations…). Indesign retraite le nom du fichier. Sinon évitez les accents, les ponctuations 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 ComeUp un micro service de correction, accompagné si besoin d’une formation d’une heure ou d’un guide en pdf présentant les étapes pour la correction de votre document.
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). Cours sur la manière d’éditer son ePub ou tutoriel pour Sigil. On liste également différents ouvrages autour de la création d’ebook et de leur commercialisation.
À propos de l’auteur
Laurent Hentz est fondateur et co-fondateur de plusieurs sociétés dans le domaine de la culture et de la communication web. Il est consultant, formateur et professeur dans plusieurs écoles. Ses domaines d’expertise sont l’édition numérique, les NFTs, la création et la maintenance de sites WordPress et leur optimisation pour les moteurs de recherche (SEO, SEA). Il est le fondateur de Numipage et propose également des services sur lhentz.com.
