DAISY Ace : l'outil de référence pour vérifier l'accessibilité des EPUB

Si vous vous êtes intéressé à l'accessibilité des EPUB, vous avez probablement vu des références à « Ace » ou « DAISY Ace ». C'est l'outil le plus utilisé pour vérifier l'accessibilité des ebooks, auquel font confiance des éditeurs comme Hachette, HarperCollins et Penguin Random House. Voici ce qu'il fait, comment il fonctionne et comment interpréter ses résultats.

Qu'est-ce que DAISY Ace ?

Ace (Accessibility Checker for EPUB) est un outil open source développé par le DAISY Consortium, l'organisation internationale responsable des normes de publication accessible. Il évalue les fichiers EPUB par rapport à la norme WCAG 2.1 AA et à la spécification EPUB Accessibility 1.1.

Ace est l'implémentation de référence. Lorsque les éditeurs, les détaillants ou les organismes de normalisation parlent de conformité de l'accessibilité des EPUB, Ace est généralement l'outil qu'ils utilisent pour la vérifier. On pense que les contrôles de qualité internes d'Amazon exécutent des évaluations similaires, et les livres qui échouent peuvent subir une suppression discrète dans les résultats de recherche.

Ce que Ace vérifie

Ace évalue votre EPUB dans plusieurs catégories :

Contrôles structurels

Hiérarchie des titres, les titres sont-ils utilisés dans l'ordre approprié (h1 → h2 → h3) ?
Repères, le contenu inclut-il des repères ARIA pour la navigation ?
Ordre de lecture, l'ordre DOM est-il logique et séquentiel ?
Langue, la langue du document est-elle déclarée ?

Contrôles du contenu

Texte alternatif des images, tous les éléments <img> ont-ils des attributs alt significatifs ?
Balisage des tableaux, les tableaux de données sont-ils correctement structurés avec des en-têtes ?
Texte des liens, les liens sont-ils descriptifs (pas seulement « cliquez ici ») ?
Contraste des couleurs, les couleurs du texte et de l'arrière-plan respectent-elles le rapport de 4.5:1 ?

Contrôles des métadonnées

Métadonnées d'accessibilité, accessibilitySummary, accessibilityHazard et accessibilityFeature sont-ils déclarés dans l'OPF ?
Métadonnées de découverte, la technologie d'assistance peut-elle déterminer les caractéristiques d'accessibilité du livre ?
Conformité, l'EPUB revendique-t-il la conformité à une norme d'accessibilité ?

Table des matières, l'EPUB inclut-il un élément <nav> avec le rôle toc approprié ?
Liste des pages, l'EPUB fournit-il une navigation par page (particulièrement important pour les manuels) ?
Ordre de la spine, l'ordre de lecture dans la spine OPF correspond-il à l'ordre du contenu ?

Comment Ace rapporte les résultats

Ace produit un rapport JSON détaillé avec chaque violation qu'il trouve. Chaque violation comprend :

ID de règle, une référence au critère de succès WCAG spécifique
Gravité, critique, grave, modérée ou mineure
Emplacement, le fichier et l'élément où la violation se produit
Description, ce qui ne va pas et pourquoi c'est important

Par exemple, une violation de texte alternatif manquant peut ressembler à ceci :

{
  "rule": "image-alt",
  "impact": "critical",
  "description": "Images must have alternate text",
  "html": "<img src=\"images/cover.jpg\">",
  "file": "OEBPS/chapter01.xhtml"
}

Ace génère également un rapport HTML avec les mêmes informations dans un format plus lisible, y compris des captures d'écran des éléments signalés.

Exécuter Ace vous-même

Ace est un outil en ligne de commande qui nécessite Node.js 18 ou une version ultérieure. Voici comment l'installer et l'exécuter :

# Install globally
npm install -g @daisy/ace

# Check a single EPUB
ace mybook.epub -o report-output/

# View the report
open report-output/report.html

L'indicateur -o spécifie où enregistrer la sortie. Ace crée à la fois report.json (lisible par machine) et report.html (lisible par l'homme) dans ce répertoire.

Problèmes courants lors de l'exécution de Ace

Erreurs de sandbox Electron. Ace utilise Electron en interne, ce qui peut entraîner des problèmes d'autorisation de sandbox sur certains systèmes. Définir ELECTRON_DISABLE_SANDBOX=1 résout généralement ce problème.

Bibliothèques système manquantes. Sous Linux, Ace a besoin de plusieurs bibliothèques graphiques (libgbm, libnss3, etc.) pour son moteur de rendu. Les conteneurs Docker doivent les installer explicitement.

Fichiers volumineux. Les EPUB de plus de 100 Mo peuvent entraîner des problèmes de mémoire. Ace charge l'intégralité du fichier en mémoire pour l'analyse.

Interprétation des résultats de Ace

Toutes les violations n'ont pas le même poids. Voici comment établir les priorités :

Critique, à corriger en premier

Texte alternatif d'image manquant, la violation la plus courante et celle qui est la plus susceptible de déclencher des drapeaux de détaillant. Consultez notre guide pour écrire du texte alternatif pour les ebooks pour connaître les meilleures pratiques.
Métadonnées d'accessibilité manquantes, sans métadonnées, les systèmes automatisés supposent la non-conformité
Hiérarchie de titres rompue, affecte la navigation du lecteur d'écran

Grave, à corriger ensuite

Contraste de lien insuffisant, une exigence WCAG AA que de nombreux EPUB ne respectent pas
Déclaration de langue manquante, affecte la prononciation du lecteur d'écran
En-têtes de tableau manquants, important pour les livres riches en données

Modérée, bien à corriger

Repères manquants, améliore la navigation mais peut ne pas déclencher de suppression
Liste de pages manquante, principalement pertinente pour les manuels et les titres universitaires

Mineure, faible priorité

Problèmes de contraste mineurs, rapports proches du seuil
Suggestions de bonnes pratiques, pas de violations standard

Ace par rapport aux autres outils

Il existe d'autres vérificateurs EPUB disponibles, mais Ace est unique à plusieurs égards :

EPUBCheck valide la structure et le schéma EPUB (le ZIP est-il valide ? L'OPF est-il bien formé ?) mais ne vérifie pas l'accessibilité. Considérez EPUBCheck comme un vérificateur de syntaxe et Ace comme un vérificateur d'accessibilité, ils sont complémentaires.

axe-core (par Deque) est le moteur d'accessibilité sous-jacent qu'Ace utilise pour l'évaluation WCAG. Si vous connaissez axe pour les tests web, Ace applique les mêmes règles au contenu EPUB.

Outils spécifiques aux détaillants. Amazon et Apple ont des outils internes, mais ils n'en partagent pas les détails publiquement. Ace est le proxy le plus proche de ce que ces outils évaluent.

Utilisation des résultats de Ace pour corriger votre EPUB

Le flux de travail le plus efficace est :

Exécutez Ace et enregistrez le rapport
Triez les violations par gravité (critique → mineure)
Corrigez d'abord les problèmes critiques, métadonnées, texte alternatif, titres
Réexécutez Ace après chaque série de corrections pour vérifier
Ciblez un rapport propre, zéro violation critique et grave

Pour une procédure pas à pas détaillée de chaque correctif, consultez notre guide sur comment corriger les problèmes d'accessibilité EPUB étape par étape. Si l'exécution de Ace localement vous semble trop compliquée à configurer, les outils en ligne comme Rahatt intègrent Ace dans une interface de navigateur et traduisent le rapport brut en un score de risque avec des recommandations exploitables.