Le message d'erreur que vous montre une boutique est en général vague. Parfois il ne dit rien de plus que « il y a un problème avec votre fichier ».
La première chose à faire est donc de le passer dans un validateur nommé EPUBCheck. C'est l'outil officiel distribué par le W3C, et il est gratuit. Il existe aussi des services qui l'exécutent en ligne.
L'outil vous dit exactement quel fichier, quelle ligne, et ce qui ne va pas. Cela vous mène à la cause bien plus vite que le message d'erreur d'une boutique.
Si EPUBCheck est propre et que la boutique refuse toujours le fichier, ce n'est probablement pas une affaire de spécification EPUB mais une exigence propre à cette boutique. Voyez la section plus bas.
Si vous fabriquez des EPUB par vous-même, les erreurs que vous croisez sont assez prévisibles.
À l'intérieur d'un EPUB se trouve un petit fichier nommé mimetype , et la règle veut qu'il soit stocké en premier dans le ZIP, sans compression.
Compresser un dossier avec un outil de compression ordinaire ne remplit pas cette condition. C'est le problème le plus fréquent quand un EPUB a été assemblé à la main.
Tous les fichiers d'un EPUB doivent être déclarés dans le <manifest> de content.opf .
Vous avez ajouté une image et oublié de la déclarer, ou un fichier déclaré n'existe plus : l'une ou l'autre incohérence produit une erreur.
EPUB 3 exige ce qui suit.
•dc:title (le titre)
•dc:language (langue ; fr pour le français)
•dc:identifier (identifiant)
•dcterms:modified (dernière modification)
Un lien de la table des matières (nav.xhtml) pointe vers un fichier absent. Cela arrive quand vous supprimez un chapitre et oubliez de mettre la table à jour.
Le corps d'un EPUB est écrit en XHTML, qui est plus strict que le HTML ordinaire. Une balise non fermée, ou écrire <br> (il faut <br />), produit une erreur.
Cela arrive surtout quand des balises HTML ont été tapées directement dans le manuscrit.
Si EPUBCheck signale zéro erreur et que la boutique refuse toujours le fichier, c'est une exigence de la boutique plutôt que de la spécification.
Les exigences de dépôt de chaque boutique sont mises à jour de temps à autre. Confirmez toujours les exigences actuelles dans les pages d'aide de cette boutique.
Les synthèses de tiers, cet article compris, peuvent être périmées. Chercher dans l'aide de la boutique le texte exact du message d'erreur est la voie la plus fiable.
Amazon convertit dans son propre format l'EPUB qu'elle reçoit. Des problèmes peuvent apparaître à cette étape de conversion, donc vérifier dans Kindle Previewer avant de déposer resserre la cause plus vite.
Si Previewer l'ouvre mais que le dépôt est refusé, le problème vient plus probablement de vos informations d'enregistrement ou de l'examen que du fichier lui-même.
EPUBCheck écrit en anglais, mais une fois la forme connue ce n'est pas difficile.
| Étiquette | Signification |
|---|---|
| FATAL | Fatal. Le fichier ne tient pas debout du tout |
| ERROR | Enfreint la spécification. Doit être corrigé |
| WARNING | Avertissement. Fonctionne, mais déconseillé |
| INFO | Information. N'appelle en général rien |
Regardez d'abord FATAL et ERROR. Les WARNING peuvent en général être publiés tels quels.
Quarante erreurs d'affilée semblent désespérantes, mais elles viennent en général toutes d'une seule cause.
Une mauvaise ligne dans le manifest, par exemple, fait échouer tous les fichiers qui y sont référencés.Corrigez seulement la première en partant du haut, puis revalidez — le compte s'effondre souvent d'un coup.
Si vous avez modifié à la main un EPUB généré par un outil et l'avez cassé, reconstruire à partir du manuscrit d'origine est en général plus rapide. Corriger le manuscrit et reconvertir est plus fiable que d'écraser les erreurs une par une.
EPUB FACTORY passe chaque fichier qu'il génère par une validation conforme à la norme et vous en montre le résultat. Sans compte, sans installation.
Essayer EPUB FACTORYNotre diagnostic EPUB signale les endroits valides sur le papier mais qui cassent pour de vrais lecteurs, dans votre propre langue. Il fonctionne entièrement dans le navigateur : votre fichier n'est envoyé nulle part. Gratuit, sans inscription.