Novembre 2021
Dernière version publiée : https://www.w3.org/publishing/a11y/UX-Guide-metadata/techniques/onix-metadata/
Dernière version de l’éditeur : https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/techniques/onix-metadata/
Rédacteurs : - Gregorio Pellegrino (Fondazione LIA)
Participez : - GitHub w3c/publ-a11y
Copyright © 2021 les contributeurs de la spécification 1.0 des techniques d’affichage des métadonnées d’accessibilité ONIX, publiée par le Publishing Community Group dans le cadre du W3C Community Final Specification Agreement (FSA).
Traduction Française par EDRLab.
Note
D'autres techniques de mise en œuvre des métadonnées d'accessibilité EPUB sont disponibles : Techniques d'affichage des métadonnées d'accessibilité
Note
Ce document fournit des techniques permettant de respecter les directives du User Experience Guide for Displaying Accessibility Metadata. Il fournit des exemples pratiques pour extraire des informations des métadonnées ONIX afin de les montrer aux utilisateurs finaux.
Note
Les messages ONIX décrivent des produits destinés à la chaîne d'approvisionnement mondiale du livre et seront envoyés par l'éditeur ou le créateur des livres électroniques ou numériques avec audio intégral à ceux qui rendront les produits disponibles pour la vente, le prêt ou l'abonnement. Il se peut que ces plateformes ne disposent pas encore des fichiers réels, car ils ne sont peut-être pas encore prêts, ou qu'elles ne choisissent de les mettre en vente que s'ils présentent certaines caractéristiques d'accessibilité. De plus, ONIX ne fait que décrire un produit, il ne peut pas décrire les caractéristiques des systèmes de lecture sur lesquels un produit peut être consulté. Il est important d'utiliser les métadonnées ONIX en complément des données d'accessibilité intégrées dans la publication elle-même, si l'on décrit des livres accessibles, des livres avec audio intégral et des produits connexes pour la chaîne d'approvisionnement mondiale du livre. Un fichier ONIX peut être utilisé pour afficher des informations sur l'accessibilité avant la publication ou lorsque vous n'avez pas accès aux métadonnées du fichier numérique lui-même. Certaines informations sur l'accessibilité peuvent n'être disponibles que lorsque vous avez accès au fichier lui-même. Si vous n'êtes pas familier avec ONIX, vous trouverez plus de documentation sur EDItEUR.org.
Note
ONIX n'a pas de correspondance 1:1 avec les métadonnées d'accessibilité EPUB. Comme certaines assertions d'accessibilité sont formulées différemment entre les deux mécanismes, une correspondance directe entre les deux n'est pas toujours possible. Le tableau de concordance entre EPUB et ONIX souligne le degré élevé de chevauchement actuel des métadonnées et sera mis à jour au fur et à mesure de l'évolution de ces deux spécifications. Il est important de noter qu'ONIX 3.0 comprend un certain nombre de nouveaux codes de métadonnées d'accessibilité, dont certains peuvent ne pas être exprimés dans les versions antérieures d'ONIX.Voici un exemple de notice ONIX (version 3.0), qui sera utilisé comme point de référence pour les exemples suivants sur les métadonnées d’accessibilité des EPUB : les résultats des XPath indiqués sont basés sur cet exemple. (à reproduire)
Exemple 1
<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage xmlns="http://ns.editeur.org/onix/3.0/reference" release="3.0">
<Header>...</Header>
<Product>
<RecordReference>123456789</RecordReference>
<NotificationType>01</NotificationType>
<ProductIdentifier>
<ProductIDType>03</ProductIDType>
<IDValue>9780000000000</IDValue>
</ProductIdentifier>
<ProductIdentifier>
<ProductIDType>15</ProductIDType>
<IDValue>9780000000000</IDValue>
</ProductIdentifier>
<DescriptiveDetail>
<ProductComposition>00</ProductComposition>
<ProductForm>ED</ProductForm>
<ProductFormDetail>E101</ProductFormDetail>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>00</ProductFormFeatureValue>
<ProductFormFeatureDescription>
Cette publication comprend un balisage permettant l'accessibilité et la compatibilité avec les technologies d'assistance. Les images, le son et la vidéo de la publication sont bien décrits, conformément aux WCAG 2.0 A.
</ProductFormFeatureDescription>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>03</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>10</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>11</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>13</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>14</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>20</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>22</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>12</ProductFormFeatureType>
<ProductFormFeatureValue>14</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>12</ProductFormFeatureType>
<ProductFormFeatureValue>16</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>12</ProductFormFeatureType>
<ProductFormFeatureValue>18</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>12</ProductFormFeatureType>
<ProductFormFeatureValue>20</ProductFormFeatureValue>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>94</ProductFormFeatureValue>
<ProductFormFeatureDescription>http://www.certifier.com/</ProductFormFeatureDescription>
</ProductFormFeature>
<ProductFormFeature>
<ProductFormFeatureType>09</ProductFormFeatureType>
<ProductFormFeatureValue>94</ProductFormFeatureValue>
<ProductFormFeatureDescription>http://www.example.com/a11y/report/9780000000001</ProductFormFeatureDescription>
</ProductFormFeature>
<PrimaryContentType>10</PrimaryContentType>
<EpubTechnicalProtection>03</EpubTechnicalProtection>
<EpubUsageConstraint>
<EpubUsageType>04</EpubUsageType>
<EpubUsageStatus>02</EpubUsageStatus>
</EpubUsageConstraint>
<TitleDetail>...</TitleDetail>
<Contributor>...</Contributor>
<Extent>...</Extent>
<Subject>...</Subject>
</DescriptiveDetail>
<CollateralDetail>...</CollateralDetail>
<PublishingDetail>...</PublishingDetail>
<RelatedMaterial>...</RelatedMaterial>
<ProductSupply>...</ProductSupply>
</Product>
</ONIXMessage>Voici un exemple de notice ONIX (version 3.0) décrivant un livre audio, qui servira de point de référence pour certains des exemples suivants sur les métadonnées d’accessibilité EPUB : les résultats des XPath présentés sont basés sur cet exemple.
Exemple 2
<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage xmlns="http://ns.editeur.org/onix/3.0/reference" release="3.0">
<Header>...</Header>
<Product>
<RecordReference>123456789</RecordReference>
<NotificationType>01</NotificationType>
<ProductIdentifier>
<ProductIDType>03</ProductIDType>
<IDValue>0000000000000</IDValue>
</ProductIdentifier>
<DescriptiveDetail>
<ProductComposition>00</ProductComposition>
<ProductForm>AO</ProductForm>
<PrimaryContentType>01</PrimaryContentType>
...
<TitleDetail>...</TitleDetail>
<Contributor>...</Contributor>
<Extent>...</Extent>
<Subject>...</Subject>
</DescriptiveDetail>
<CollateralDetail>...</CollateralDetail>
<PublishingDetail>...</PublishingDetail>
<RelatedMaterial>...</RelatedMaterial>
<ProductSupply>...</ProductSupply>
</Product>
</ONIXMessage>Valeur : “Oui”, “Non” ou “Inconnu”
Cette technique concerne le principe de l’adaptation aux lecteurs d’écran.
Cette information peut être extraite de la liste ONIX 81 ; Code : 10 combiné à la liste de codes 196 ; Code : 10 signifie que tout le texte est du texte réel.
Note
La liste 81 ; Code : 10 seule (sans la liste 196 ; Code : 10) admet la possibilité que le "texte" soit inaccessible parce qu'il s'agit d'une image de texte.Ce champ est vrai si les deux éléments XPath existent :
Exemple 3
//Product/DescriptiveDetail/PrimaryContentType [text()="10"] et
//Product/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="09" and ProductFormFeatureValue="10"]Pour cet exemple, ce XPath a été évalué sur la fiche ONIX présentée dans l’EXEMPLE 1.
Compatible avec les lecteurs d’écran : Oui
Valeurs : “Oui” (si non - Omettre cette section)
Cette technique est liée au principe du Full Audio.
Si la publication est basée sur du texte avec de l’audio synchronisé, cette information peut être récupérée dans la liste de codes ONIX : 196 ; Code : 20 : Audio préenregistré synchronisé.
Si la publication est uniquement sonore (par exemple, un livre audio), cette information peut être extraite de la liste de codes ONIX 81 ; Code : 01 : Audiobook.
2.2.1.1 XPath
Si le XPath suivant renvoie au moins un résultat :
Exemple 4
//Produit/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="09" et ProductFormFeatureValue="20"]Pour cet exemple, ce XPath a été évalué sur la fiche ONIX présentée dans l’EXEMPLE 1.
audio intégral : Oui
Ce champ est vrai si le XPath renvoie un élément pour : Exemple 5
//Produit/DescriptiveDetail/PrimaryContentType[text()=“01”]
Pour cet exemple, ce XPath a été évalué sur la fiche ONIX présentée dans l’EXEMPLE 2.
audio intégral : Oui
Valeur : Données textuelles provenant des métadonnées
Cette technique concerne le principe du résumé d’accessibilité.
Cette information peut être extraite de la liste de codes ONIX : 196 ; Code : 00 : Résumé d’accessibilité.
2.3.1.1 XPath
La valeur peut être récupérée en utilisant XPath :
Exemple 6
//Produit/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="09" et ProductFormFeatureValue="00"]/ProductFormFeatureDescription/text()Pour cet exemple, ce XPath a été évalué sur l’enregistrement ONIX présenté dans l’EXEMPLE 1.
Résumé de l’accessibilité :
Cette publication comprend un balisage permettant l’accessibilité et la compatibilité avec les technologies d’assistance. Les images, le son et la vidéo de la publication sont bien décrits, conformément aux WCAG 2.0 A.
Valeur : Lien textuel basé sur les métadonnées
Cette technique est liée au principe de conformité de l’accessibilité.
Pour l'accessibilité d'EPUB, WCAG-A : Liste : 196 ; Code : 02 : Spécification d'accessibilité EPUB 1.0 A.
Pour l'accessibilité d'EPUB, WCAG-AA : Liste : 196 ; Code : 03 : Spécification d'accessibilité EPUB 1.0 AA
Pour l'accessibilité EPUB, WCAG-AAA : Non disponible dans ONIX.Si le XPath suivant renvoie au moins un résultat :
Exemple 7
//Produit/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="09" et ProductFormFeatureValue="02"]Pour cet exemple, ce XPath a été évalué sur la fiche ONIX présentée dans l’EXEMPLE 1.
Conformité en matière d’accessibilité : Accessibilité EPUB, WCAG-A
Si le XPath suivant renvoie au moins un résultat :
Exemple 8
//Produit/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="09" et ProductFormFeatureValue="03"] renvoie au moins un résultat.Pour cet exemple, ce XPath a été évalué sur la fiche ONIX présentée dans l’EXEMPLE 1.
Conformité en matière d’accessibilité : Accessibilité EPUB, WCAG-AA 2.5 Certifié par
Valeur : Données textuelles à partir de métadonnées
Cette technique se rapporte au principe Certified By.
Liste : 196 ; Code : 93 : Certification de conformité par
La valeur peut être récupérée en utilisant XPath :
Exemple 9
//Produit/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="09" et ProductFormFeatureValue="93"]/ProductFormFeatureDescription/text()Pour cet exemple, ce XPath a été évalué sur l’enregistrement ONIX présenté dans l’EXEMPLE 1.
Certifié par : http://www.certifier.com/
Note
(URI cliquable vers une page web appartenant à l'organisation responsable des tests de conformité et de la certification du produit)Valeur : Données textuelles potentiellement liées provenant de métadonnées
Cette technique est liée au principe du Certifier Credential.
Non disponible dans ONIX
Valeur : Données textuelles potentiellement liées provenant de métadonnées
Cette technique est liée au principe du rapport de certification.
Liste : 196 ; Code : 94 : Page web de conformité pour des informations détaillées sur l’accessibilité
Ou
S’il est certifié par un intermédiaire de confiance, Liste : 196 ; Code : 95 : Page web de l’intermédiaire de confiance pour des informations détaillées sur l’accessibilité
Ou
Si un éditeur s’auto-certifie, Liste : 196 ; Code : 96 : Page web de l’éditeur pour des informations détaillées sur l’accessibilité
La valeur peut être récupérée en utilisant XPath :
Exemple 10
//Produit/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="09" et ProductFormFeatureValue="94"]/ProductFormFeatureDescription/text()
Exemple 11
//Product/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="09" and ProductFormFeatureValue="95"]/ProductFormFeatureDescription/text()
Exemple 12
//Produit/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="09" and ProductFormFeatureValue="96"]/ProductFormFeatureDescription/text()Pour cet exemple, ce XPath a été évalué sur l’enregistrement ONIX présenté dans l’EXEMPLE 1.
Rapport du certificateur : Page web du rapport
Exemple 13
(Image cliquable vers l'URI du rapport à partir des métadonnées)
alt-text Page web du rapport
(L'image de la coche et du presse-papiers est donnée à titre indicatif, vous pouvez choisir votre propre image).Ou
Exemple 14
Rapport du certificateur : Rapport sur l'accessibilité
(Lien cliquable vers l'URI du rapport à partir des métadonnées)Valeurs : clignotement, simulation de mouvement, son, pas de clignotement, pas de simulation de mouvement, pas de son, aucun, ou Inconnu.
Cette technique est liée au principe de Hazards.
ONIX utilise un composite pour indiquer les différents dangers.
Pour énumérer la présence ou l’absence de dangers risques, on utilise l’élément ProductFormFeature, avec ProductFormFeatureType égal à 12 (“US CPSIA or other international hazard warning”, de la liste de codes 79) et ProductFormFeatureValue de la liste de codes 143.
La valeur peut être récupérée en utilisant XPath :
Exemple 15
//Produit/DescriptiveDetail/ProductFormFeature[ProductFormFeatureType="12"]/ProductFormFeatureValuePour cet exemple, ce XPath a été évalué sur la fiche ONIX présentée dans l’EXEMPLE 1.
Risques : pas de clignotement, pas de son, pas de simulation de mouvement
(parce que ProductFormFeature avec ProductFormFeatureType égal à 12 et ProductFormFeatureValues égal à : 14, 16, 18)
Valeur : Lien vers la liste complète de tous les champs de métadonnées
Cette technique est liée au principe des métadonnées d’accessibilité.
Pour une liste complète des métadonnées d’accessibilité ONIX, se référer à la passerelle.
Accessibilité EPUB : Toutes les métadonnées d'accessibilité https://www.w3.org/community/a11y-discov-vocab/ (draft)
ONIX : Toutes les métadonnées d'accessibilité For a complete list of ONIX accessibility metadata refer to the crosswalk. http://www.a11ymetadata.org/the-specification/metadata-crosswalk/ (no longer maintained)