Aller au contenu principal

Comment valider votre EPUB avant publication

·17 min read·
Validation EPUBEPUBCheckAccessibilité

La validation permet de détecter les erreurs que vos lecteurs et les distributeurs trouveront si vous ne le faites pas. Une seule entrée de métadonnée mal formée peut entraîner le rejet de votre téléchargement par Apple Books. Un document de navigation manquant peut vous coûter 40 points sur le score de risque de suppression d'Amazon. Une image sans alt text viole la loi européenne sur l'accessibilité. Tous ces problèmes peuvent être détectés et corrigés avant la publication, si vous utilisez les bons outils de validation.

Ce guide vous explique un flux de validation en trois étapes : EPUBCheck pour la correction structurelle, DAISY Ace pour la conformité à l'accessibilité et Rahatt pour le risque de suppression commerciale. Ensemble, ils détectent pratiquement tous les problèmes qui pourraient nuire à la distribution ou à la visibilité de votre livre.

Le flux de validation en trois couches

CoucheOutilCe qu'il vérifieTemps requis
1. StructureEPUBCheckFormat EPUB valide, HTML correct, métadonnées appropriées, intégrité des fichiers1 à 2 minutes
2. AccessibilitéDAISY AceConformité WCAG 2.1, alt text, hiérarchie des titres, contraste, navigation2 à 5 minutes
3. Risque commercialRahattDéclencheurs de suppression Amazon, score de risque, problèmes auto-correctiblesMoins d'une minute

Chaque couche détecte des problèmes différents. EPUBCheck validera un livre qui n'a pas de alt text (il ne vérifie pas l'accessibilité). DAISY Ace validera un livre avec un lien interne brisé (il ne vérifie pas l'intégrité structurelle). Rahatt met en relation les conclusions d'accessibilité avec l'impact commercial (ce qui vous coûtera réellement des ventes). L'exécution des trois outils prend moins de 10 minutes et peut vous faire gagner des semaines de visibilité perdue.

Couche 1 : EPUBCheck, validation structurelle

EPUBCheck est l'outil de validation officiel du W3C pour les fichiers EPUB. Il vérifie que votre EPUB est conforme à la spécification EPUB, à la structure de fichier correcte, au HTML valide, aux métadonnées appropriées et aux références internes cohérentes.

Comment exécuter EPUBCheck

Option 1 : Interface web, allez sur epubcheck.org et téléchargez votre fichier. Les résultats apparaissent dans votre navigateur. Idéal pour une utilisation occasionnelle.

Option 2 : Ligne de commande, Téléchargez EPUBCheck depuis le dépôt GitHub du W3C et exécutez-le localement :

java -jar epubcheck.jar votre-livre.epub

Cela nécessite que Java soit installé sur votre système. La version en ligne de commande est plus rapide et fonctionne avec les flux de travail automatisés.

Option 3 : Intégré, Sigil inclut EPUBCheck en tant que fonctionnalité intégrée (Outils > Valider EPUB). Calibre exécute une validation légère pendant la conversion.

Les 10 erreurs EPUBCheck les plus courantes

D'après les données agrégées du validateur public d'EPUBCheck (qui a traité plus de 2 millions de contrôles en 2025), voici les erreurs les plus fréquentes rencontrées par les auteurs indépendants :

RangErreurFréquenceGravitéCorrection
1dc:language manquant23 %ErreurAjouter le code de langue aux métadonnées OPF
2dc:identifier manquant/mal formé19 %ErreurAjouter l'ISBN ou l'UUID à l'OPF
3Liens internes brisés17 %ErreurCorriger les chemins href dans les fichiers XHTML
4HTML invalide dans les fichiers de contenu15 %ErreurCorriger les balises non fermées, les attributs invalides
5Document de navigation manquant12 %ErreurAjouter nav.xhtml ou toc.ncx
6Éléments du manifeste non déclarés11 %ErreurAjouter tous les fichiers au manifeste OPF
7Fichier mimetype incorrect8 %ErreurS'assurer que mimetype est le premier fichier, non compressé
8dc:title manquant7 %ErreurAjouter un titre aux métadonnées OPF
9Constructions EPUB 2 obsolètes6 %AvertissementMettre à jour la syntaxe EPUB 3
10Fichier image non présent dans le manifeste5 %ErreurAjouter l'image au manifeste OPF

Comment corriger les erreurs EPUBCheck courantes

dc:language manquant : Ouvrez votre fichier OPF et ajoutez l'élément de langue à l'intérieur de <metadata> :

<dc:language>fr</dc:language>

Liens internes brisés : EPUBCheck vous indique exactement quel fichier et quel numéro de ligne contiennent le lien brisé. Ouvrez ce fichier XHTML et corrigez l'attribut href. Causes courantes : fichiers de chapitre renommés, contenu supprimé, incompatibilités de casse (Chapitre01.xhtml vs chapitre01.xhtml).

Éléments de manifeste non déclarés : Chaque fichier de votre EPUB doit être répertorié dans le manifeste OPF avec le type de média correct. Si vous avez ajouté une image ou une feuille de style sans mettre à jour le manifeste, EPUBCheck le détecte :

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

Fichier mimetype incorrect : Le fichier mimetype doit être le premier fichier de l'archive ZIP, ne doit pas être compressé et doit contenir exactement le texte application/epub+zip sans saut de ligne à la fin. La plupart des outils de formatage gèrent cela correctement, mais les opérations ZIP manuelles peuvent le casser.

Pour une compréhension plus large de la structure EPUB et de la manière dont ces composants s'articulent, consultez notre guide complet du formatage d'ebooks.

Couche 2 : DAISY Ace, validation de l'accessibilité

DAISY Ace est le vérificateur d'accessibilité pour EPUB, maintenu par le DAISY Consortium. Il évalue votre ebook par rapport à WCAG 2.1 (Web Content Accessibility Guidelines) et aux meilleures pratiques d'accessibilité EPUB.

Ce que Ace vérifie et qu'EPUBCheck ne vérifie pas

EPUBCheck valide la conformité au format. Ace valide la conformité à l'accessibilité. Ce sont des préoccupations différentes :

VérificationEPUBCheckDAISY Ace
Structure HTML valideOuiNon
Présence d'alt text pour les imagesNonOui
Hiérarchie des titres correcteNonOui
Contraste des couleurs suffisantNonOui
Document de navigation fonctionnelOui (existe)Oui (accessible)
Attribut de langue définiOuiOui
Métadonnées d'accessibilité présentesPartielOui
Structure du tableau accessibleNonOui
Attributs ARIA validesNonOui
Ordre de lecture logiqueNonOui

Comment exécuter DAISY Ace

Ace nécessite Node.js 18 ou une version ultérieure. Installez-le globalement :

npm install -g @daisy/ace

Ensuite, exécutez-le sur votre EPUB :

ace votre-livre.epub -o ace-report

Cela génère un rapport HTML dans le répertoire ace-report. Ouvrez report.html dans votre navigateur pour voir une analyse détaillée de chaque problème d'accessibilité trouvé, organisé par gravité (violation, avertissement, suggestion).

Pour des instructions d'installation complètes et des conseils pour interpréter les résultats de Ace, consultez notre guide DAISY Ace.

Les violations les plus courantes de Ace

Selon le rapport annuel 2025 du DAISY Consortium, 73 % des EPUB publiés indépendamment échouent à au moins une vérification Ace. Les violations les plus courantes :

1. alt text manquant (68 % des livres scannés)

Chaque élément <img> doit avoir un attribut alt. Les images décoratives doivent avoir alt="". Les images véhiculant des informations ont besoin d'un alt text descriptif. Il s'agit de la violation la plus fréquente, car la plupart des outils de formatage n'invitent pas les auteurs à ajouter un alt text.

Correction : Ajoutez des attributs alt dans Sigil, ou utilisez la fonctionnalité d'alt text IA de Rahatt pour générer et injecter automatiquement des descriptions. Pour connaître les meilleures pratiques de rédaction d'alt text, consultez notre guide sur l'alt text.

2. Hiérarchie des titres incorrecte (41 %)

Les titres ne doivent pas sauter de niveaux. Un <h1> suivi d'un <h3> (sautant <h2>) est une violation. Les lecteurs d'écran utilisent la hiérarchie des titres pour construire un plan navigable du livre, les niveaux sautés créent des lacunes déroutantes.

Correction : Passez en revue les niveaux de titre dans chaque fichier XHTML et corrigez les lacunes. La fonction de correction automatique de Rahatt corrige automatiquement la hiérarchie des titres en abaissant les titres incorrectement nivelés.

3. Contraste insuffisant des liens (35 %)

Les liens doivent être visuellement distinguables du texte environnant avec un rapport de contraste d'au moins 4,5:1 par rapport à l'arrière-plan. De nombreux ebooks stylisent les liens avec des couleurs qui semblent différentes sur un écran d'ordinateur mais échouent au test mathématique du rapport de contraste.

Correction : Définissez la couleur du lien sur #0066CC ou plus foncé, avec text-decoration: underline. La fonction de correction automatique de Rahatt injecte des styles de liens conformes à WCAG dans votre CSS.

4. Métadonnées d'accessibilité manquantes (31 %)

EPUB 3 prend en charge les métadonnées d'accessibilité schema.org (accessibilityFeature, accessibilityHazard, accessibilitySummary). L'absence de ces propriétés est une violation en vertu de la loi européenne sur l'accessibilité et un facteur de risque de suppression sur Amazon.

Correction : Ajoutez les métadonnées appropriées à votre fichier OPF. Consultez notre guide des métadonnées pour les modèles de copier-coller, ou utilisez la correction automatique de Rahatt pour injecter automatiquement les métadonnées.

5. Attribut de langue manquant (18 %)

L'attribut xml:lang doit être défini sur l'élément <html> racine de chaque fichier XHTML. Les lecteurs d'écran l'utilisent pour sélectionner le moteur de prononciation correct.

Correction : Ajoutez xml:lang="fr" (ou le code de langue approprié) à l'élément <html> dans chaque fichier de contenu.

Couche 3 : Rahatt, évaluation du risque de suppression

EPUBCheck et Ace vous indiquent ce qui ne va pas techniquement avec votre EPUB. Rahatt vous indique ce qui est commercialement dangereux, quels problèmes affecteront réellement la visibilité de votre livre sur Amazon et d'autres détaillants.

Comment fonctionne le score Rahatt

Rahatt met en relation les violations d'accessibilité avec les déclencheurs de suppression connus d'Amazon et calcule un score de risque de 0 à 100 :

ProblèmePoints de risquePlafond
alt text manquant-10 par image-40 total
Navigation manquante/brisée-40-40
Métadonnées d'accessibilité manquantes-20-20

Niveaux de risque :

  • 0-19 (Faible) : Votre ebook est en bon état. Aucune action n'est nécessaire.
  • 20-49 (Moyen) : Problèmes présents qui peuvent réduire la visibilité. Correction recommandée.
  • 50-79 (Élevé) : Risque de suppression important. Corrigez avant de publier.
  • 80-100 (Critique) : Suppression de classement quasi certaine. Corrections immédiates requises.

Exécution d'un scan Rahatt

  1. Allez sur rahatt.co
  2. Déposez votre fichier EPUB dans la zone de téléchargement (ou cliquez pour parcourir)
  3. Le scan s'exécute automatiquement et renvoie les résultats en moins de 30 secondes
  4. Examinez votre score de risque, les problèmes identifiés et les recommandations

Correction automatique Rahatt

Pour les problèmes ayant un score moyen ou supérieur, Rahatt peut corriger automatiquement de nombreux problèmes courants :

  • Injection de métadonnées d'accessibilité, Ajoute les propriétés schema:accessibilityFeature, schema:accessibilityHazard et schema:accessibilitySummary manquantes
  • Correction de la hiérarchie des titres, Abaisse automatiquement les titres incorrectement nivelés (par exemple, h4 → h3 lorsque h2 est le parent)
  • Injection de contraste de lien, Ajoute un CSS conforme WCAG 2.1 AA pour le style des liens
  • Génération d'alt text, Utilise l'IA pour générer des suggestions d'alt text contextuelles, que vous examinez et approuvez avant l'injection

Une session de correction automatique typique fait passer un ebook d'un score de risque moyen (40/100) à un risque faible (0/100) en moins de 5 minutes. Consultez notre guide sur la correction des problèmes d'accessibilité des EPUB pour des présentations détaillées.

La liste de contrôle complète de la validation

Suivez ces étapes avant chaque téléchargement d'ebook :

Pré-validation (avant d'exécuter les outils)

  • Tous les fichiers de chapitre sont présents et dans l'ordre de lecture correct
  • Toutes les images sont optimisées et respectent le budget de taille
  • Chaque image a un attribut alt (descriptif ou vide pour décoratif)
  • L'image de couverture répond aux spécifications du détaillant
  • La table des matières correspond à la structure réelle des chapitres

EPUBCheck

  • Exécutez EPUBCheck, zéro erreur
  • Passez en revue les avertissements, corrigez ceux qui indiquent de réels problèmes
  • Tous les fichiers sont déclarés dans le manifeste
  • dc:language, dc:title, dc:identifier sont présents
  • Le document de navigation existe et est déclaré correctement

DAISY Ace

  • Exécutez Ace, passez en revue toutes les violations
  • alt text présent sur toutes les images significatives
  • La hiérarchie des titres suit l'ordre correct (pas de niveaux sautés)
  • Le contraste des liens répond au ratio 4,5:1
  • Les métadonnées d'accessibilité sont présentes et exactes
  • L'attribut de langue est défini sur tous les fichiers de contenu

Rahatt

  • Le score de risque est faible (0-19)
  • Il ne reste plus de conclusions critiques
  • Si des problèmes sont détectés, appliquez la correction automatique et relancez l'analyse pour vérifier

Aperçu de la plateforme

  • Kindle Previewer 3, la navigation fonctionne, les images s'affichent, le formatage est correct
  • Apple Books (si disponible), ouvrez et lisez les sections clés
  • Calibre Viewer ou Thorium, vérifiez ponctuellement le formatage

Validation tout au long du cycle de vie de la publication

La validation n'est pas un événement ponctuel. Exécutez le flux de validation complet à ces points :

ÉvénementCe qu'il faut validerOutils prioritaires
Après le formatage initialValidation complète (les trois couches)EPUBCheck + Ace + Rahatt
Après les modifications de contenuEPUBCheck + RahattStructurel + risque
Après le changement de couvertureEPUBCheckManifeste + référence de couverture
Après les mises à jour des métadonnéesEPUBCheck + RahattMétadonnées + risque
Avant chaque téléchargement chez un détaillantValidation complèteLes trois
Examen annuel du fondsRahattVérification du score de risque
Après la mise à jour des normes d'accessibilitéAce + RahattConformité + risque

L'examen annuel du fonds est particulièrement important. Les algorithmes de suppression d'Amazon évoluent, et un livre qui a réussi l'évaluation des risques en 2025 peut accumuler des risques à mesure que les normes se durcissent. Un scan Rahatt rapide (moins d'une minute par livre) identifie tous les titres de fonds qui nécessitent une attention particulière.

Interprétation des résultats de la validation

Quand vous pouvez ignorer les avertissements

Tous les avertissements ne nécessitent pas d'action. Voici des avertissements courants que vous pouvez ignorer en toute sécurité sans correction :

  • "Ressource référencée OPF non dans la spine", Ceci est normal pour les images, les feuilles de style et autres fichiers non-contenu. Ils doivent être dans le manifeste mais pas nécessairement dans la spine.
  • "Contraste insuffisant pour le texte décoratif", Si le texte à faible contraste est purement décoratif (par exemple, un élément d'arrière-plan de style filigrane), ceci est acceptable.
  • "Navigation de liste de pages manquante", Uniquement requis si votre ebook correspond à une numérotation de pages d'une édition imprimée spécifique.

Quand les avertissements sont en fait critiques

Certains avertissements doivent être traités comme des erreurs :

  • "Le document de navigation n'a pas d'entrées", Un document de navigation sans aucune entrée est pire qu'aucun document du tout. Les lecteurs électroniques peuvent afficher un menu vide.
  • "Image référencée mais non trouvée", Cela signifie que les lecteurs verront une icône d'image brisée. Corrigez toujours.
  • "Plusieurs éléments dc:identifier", Peut dérouter les systèmes d'ingestion des détaillants. Conservez un identifiant principal.

Automatisation de la validation

Si vous publiez fréquemment (plus de 5 livres par an), envisagez d'automatiser votre flux de validation :

Flux de travail en ligne de commande

# Valider la structure
java -jar epubcheck.jar livre.epub 2> epubcheck-erreurs.txt

# Vérifier l'accessibilité
ace livre.epub -o ace-report

# Résumé rapide des erreurs
grep "ERROR" epubcheck-erreurs.txt | wc -l
grep "violation" ace-report/report.json | wc -l

Intégration CI/CD

Les auteurs utilisant le contrôle de version pour leurs livres (oui, certains le font) peuvent ajouter EPUBCheck et Ace à leur pipeline de construction. Les deux outils se terminent par des codes d'état non nuls en cas d'erreur, ce qui les rend compatibles avec les systèmes CI/CD.

Ce niveau d'automatisation est excessif pour la plupart des auteurs indépendants, mais les sociétés d'édition et les éditeurs en série produisant plus de 20 titres par an le trouvent utile.

Questions fréquemment posées

À quelle fréquence dois-je valider mes ebooks ?

Au minimum, validez chaque ebook avant son premier téléchargement et après toute modification de contenu significative. Pour les titres de fonds, effectuez un scan Rahatt annuel pour vérifier le risque de suppression, les normes d'Amazon évoluent, et un livre qui était correct en 2024 peut nécessiter des mises à jour. Le scan prend moins d'une minute par livre et ne coûte rien.

Mon EPUB réussit EPUBCheck mais échoue DAISY Ace. Est-ce normal ?

Oui, c'est très courant. EPUBCheck valide la conformité au format (est-ce un EPUB valide ?), tandis que Ace valide la conformité à l'accessibilité (est-ce un EPUB accessible ?). Un EPUB structurellement parfait peut toujours avoir un alt text manquant, une hiérarchie de titres brisée et un contraste insuffisant. Ce sont des préoccupations différentes abordées par des outils différents. Vous devez réussir les deux.

Puis-je sauter la validation si j'ai utilisé un outil de formatage professionnel comme Vellum ?

Non. Vellum produit des EPUB bien structurés, mais il n'ajoute pas d'alt text aux images, n'inclut pas de métadonnées d'accessibilité complètes et peut produire des hiérarchies de titres qui dépendent de votre structure d'entrée. Un scan Rahatt d'un livre formaté avec Vellum avec des images renvoie généralement un score de risque moyen (20-40) en raison de l'alt text manquant et des métadonnées d'accessibilité incomplètes. Même la sortie de Vellum bénéficie du flux de validation et de correction automatique.

Que faire si je ne peux pas corriger tous les problèmes avant ma date limite ?

Donnez la priorité par impact commercial. Corrigez d'abord les problèmes de navigation (valant jusqu'à 40 points de risque), puis les métadonnées d'accessibilité (20 points), puis l'alt text (10 par image, jusqu'à 40). Ces trois catégories représentent à elles seules 100 % du score de risque de suppression Amazon. La hiérarchie des titres et les problèmes de contraste affectent la conformité à Ace mais ont un impact direct plus faible sur le classement Amazon. Si le temps est extrêmement limité, un seul passage de correction automatique Rahatt aborde les métadonnées, les titres et le contraste en moins d'une minute.

Existe-t-il des outils de validation spécifiques au format KF8 d'Amazon ?

Kindle Previewer 3 gratuit d'Amazon est l'équivalent le plus proche. Il convertit votre EPUB en KF8 en interne et signale les problèmes de qualité pendant la conversion. Cependant, il ne vérifie pas l'accessibilité aussi minutieusement qu'Ace ou Rahatt. L'approche recommandée est : validez l'EPUB minutieusement (EPUBCheck + Ace + Rahatt), puis prévisualisez dans Kindle Previewer comme une dernière vérification de la mise en page avant de télécharger sur KDP. Pour plus d'informations sur le processus complet de formatage et de validation, consultez notre guide de formatage d'ebooks et notre comparaison des outils de formatage.

Prêt à vérifier votre EPUB ?

Analyser votre EPUB gratuitement