- Penser \u00e0 l\u2019accessibilit\u00e9<\/li>
- Cr\u00e9er des alternatives de navigation<\/li>
- R\u00e9diger pour r\u00e9utiliser<\/li><\/ul>\n<\/div><\/div>\n\n\n\n
R\u00e9diger pour de nouveaux publics et de nouveaux modes de livraison<\/span><\/h2>\n\n\n\n
La plupart des r\u00e9dacteurs devront adopter de nouvelles habitudes \u00e0 mesure qu\u2019ils devront abandonner l\u2019id\u00e9e qu\u2019ils sont les responsables d\u2019un certain m\u00e9dia de livraison et qu\u2019ils ne ma\u00eetrisent pas n\u00e9cessairement la forme finale du contenu. \nLe plus souvent, les difficult\u00e9s proviennent des exigences des nouveaux m\u00e9dias : canaux web, applications sur t\u00e9l\u00e9phone, sites mobiles, ou m\u00eame middleware embarqu\u00e9.<\/p>\n\n\n\n
L’accessibilit\u00e9 – une opportunit\u00e9 pour tous<\/span><\/h3>\n\n\n\n
Les nouveaux m\u00e9dias de diffusion ont des exigences sp\u00e9cifiques sur les contenus et proposent de nouvelles opportunit\u00e9s de traitement. L\u2019accessibilit\u00e9 est l\u2019un des points les plus importants pour l\u2019am\u00e9lioration de l\u2019exp\u00e9rience utilisateurs et pas seulement pour ceux qui ont des difficult\u00e9s physiques ou cognitives. \nL\u2019accessibilit\u00e9 sur le web et les formats num\u00e9riques est non seulement essentielle, elle peut \u00eatre une obligation l\u00e9gale si vous travaillez pour les services publics ou pour un public large. <\/p>\n\n\n\n
Les principes d\u2019accessibilit\u00e9 pour le web (Web Accessibility Initiative, WAI) sont maintenus par un groupe du consortium W3C<\/a><\/span> : Web Content Accessibility Guidelines Working Group<\/em><\/span><\/a>. L\u2019impact pour les r\u00e9dacteurs DITA r\u00e9side notoirement dans les principes de balisage afin que les outils de publication puissent comprendre le contenu et le traiter de mani\u00e8re ad\u00e9quate et efficiente. Le r\u00e9sultat, c\u2019est un contenu que les lecteurs d\u2019\u00e9cran (et autres dispositifs technologiques d\u2019assistance) peuvent comprendre et parcourir afin de pr\u00e9senter l\u2019information efficacement.<\/p>\n\n\n\n
La derni\u00e8re version 2.1 offre des conseils pour les nouveaux outils d\u2019assistance et les nouveaux \u00e9crans et dispositifs de diffusion dont les mouvements, rotations, etc. <\/p>\n\n\n\n
Am\u00e9liorer l’accessibilit\u00e9 des images, listes, figures et tableaux<\/span><\/h3>\n\n\n\n
Images<\/p>\n\n\n\n
La r\u00e8gle est de r\u00e9diger des descriptions afin de donner la signification des images, graphes, sch\u00e9mas, etc. S\u2019il n\u2019y a rien \u00e0 dire sur l\u2019illustration, elle ne porte pas de message et peut \u00eatre supprim\u00e9e sans difficult\u00e9. Les images qui ne portent pas de messages sont non seulement redondantes, elles fatiguent le lecteur. Au final, elles ne sont souvent m\u00eame pas vues par les utilisateurs.\n<\/p>\n\n\n\n
L\u2019\u00e9l\u00e9ment figure<\/strong> <\/span>doit contenir :<\/p>\n\n\n\n
- Titre<\/li>
- Un pointeur hypertexte vers une image <\/li>
- Un texte alternatif <\/li>
- Un texte descriptif<\/li><\/ul>\n\n\n\n
Le texte alternatif doit pr\u00e9senter une explication pour les lecteurs d\u2019\u00e9cran. Les utilisateurs d\u00e9ficients visuels peuvent ainsi entendre la description de l\u2019image. Ainsi, s\u2019il n\u2019y a pas besoin de l\u2019image pour comprendre le contenu, cette image peut soit dispara\u00eetre, soit, au minimum, ne pas contenir d\u2019alternative textuelle.<\/p>\n\n\n\n
Lists<\/p>\n\n\n\n
Les r\u00e9dacteurs doivent \u00e9galement toujours utiliser les \u00e9l\u00e9ments de liste<\/span> <\/strong>et ne pas utiliser de caract\u00e8res typographiques pour marquer une liste tels les virgules ou point virgules.<\/p>\n\n\n\n
Tables<\/p>\n\n\n\n
Pour l\u2019accessibilit\u00e9 des tableaux, l\u2019\u00e9l\u00e9ment table<\/strong> <\/span>doit contenir :<\/p>\n\n\n\n
- Un texte descriptif<\/li>
- Une identification des en-t\u00eates de ligne et\/ou de colonnes1<\/sup><\/a><\/li><\/ul>\n\n\n\n
Ces points sont les plus importants pour que chaque r\u00e9dacteur fournisse un contenu DITA accessible. Chaque r\u00e9dacteur devrait prendre connaissance des recommandations de la WAI \u2013 celles-ci sont disponibles gratuitement en ligne. Vous noterez que les processus de publication de base du DITA OT prennent en compte un certain nombre de mesure d\u2019accessibilit\u00e9 web, notamment les niveaux de titres, le balisage des liens, etc. mais la lecture fournit n\u00e9anmoins de bons rappels et des points nouveaux. <\/p>\n\n\n\n
Cr\u00e9er des alternatives de navigation<\/span><\/h3>\n\n\n\n
Un chemin narratif est rarement pr\u00e9pond\u00e9rant dans un set de documentation technique. La norme DITA permet donc aux auteurs de proposer des alternatives de navigation en plus de la table des mati\u00e8res et de l\u2019indexation. \nL\u2019objectif est ici de permettre un lien direct entre informations connexes pour que les utilisateurs puissent directement naviguer vers d\u2019autres parties de l\u2019information en cliquant sur un simple lien. On peut ainsi ajouter un lien entre une proc\u00e9dure de maintenance et un plan de maintenance, ou encore indiquer un s\u00e9quencement logique entre plusieurs proc\u00e9dures.<\/p>\n\n\n\n
Mais o\u00f9 doit-on placer ces liens ? Si le r\u00e9dacteur les ajoute dans le corps du texte, les utilisateurs peuvent sortir de la rubrique avant d\u2019en avoir fini la lecture. Cela ajoute un risque car il est possible, voire probable, qu\u2019ils ne reviendront pas pour compl\u00e9ter la proc\u00e9dure ou pour lire la fin de l\u2019information conceptuelle. Nous savons d\u00e9j\u00e0 que pour am\u00e9liorer l\u2019accessibilit\u00e9, il faut placer les liens suppl\u00e9mentaires en fin de rubrique et cela peut se faire directement dans DITA. Toutefois, la norme offre une possibilit\u00e9 encore plus int\u00e9ressante pour la cr\u00e9ation automatique de ces liens : en positionnant ceux-ci au niveau de la carte, permettant ainsi de les supprimer enti\u00e8rement des rubriques elles-m\u00eames.<\/p>\n\n\n\n
En supprimant ces d\u00e9pendances entre rubriques, on supprime le besoin de lier syst\u00e9matiquement ces rubriques dans un document.<\/p>\n\n\n\n
Les r\u00e9dacteurs ne doivent jamais s\u2019imaginer connaitre le sens de lecture de l\u2019utilisateur et leur point d\u2019entr\u00e9e dans la documentation. \u00c9vitez d\u2019ajouter des mentions vers des informations externes, par exemple ci-apr\u00e8s<\/em>, comme nous le verrons ensuite<\/em>, ci-dessous<\/em>, etc.<\/p>\n\n\n\n
R\u00e9diger pour r\u00e9utiliser<\/span><\/h3>\n\n\n\n
L\u2019une des raisons d\u2019adopter DITA est bien de la possibilit\u00e9 pour les r\u00e9dacteurs de r\u00e9utiliser des contenus au lieu de r\u00e9\u00e9crire ou de copier\/coller ces contenus.\n<\/p>\n\n\n\n
L\u2019une des raisons d\u2019adopter DITA est bien de la possibilit\u00e9 pour les r\u00e9dacteurs de r\u00e9utiliser des contenus au lieu de r\u00e9\u00e9crire ou de copier\/coller ces contenus.\n\nLes bonnes pratiques2<\/sup><\/a> \u00e0 adopter sont d\u2019identifier et de s\u00e9parer d\u2019une part le contenu qui va \u00eatre publi\u00e9, et d\u2019autre part le contenu qui va \u00eatre purement r\u00e9utilis\u00e9.<\/p>\n\n\n\n
- R\u00e9utiliser des cartes (documents) ou un groupe de rubriques<\/li>
- R\u00e9utiliser des rubriques ind\u00e9pendantes<\/li>
- R\u00e9utiliser des blocs de texte, des segments, des images<\/li>
- R\u00e9utiliser des lettres de l\u2019alphabet (!). Le niveau maximum de r\u00e9utilisation est la lettre unique, comme on l\u2019entend souvent avec humour. <\/li><\/ul>\n\n\n\n
Le standard vous permet plusieurs m\u00e9thodes pour r\u00e9utiliser le contenu, par exemple :<\/p>\n\n\n\n
- R\u00e9utilisation directe (avec un lien hypertexte)<\/li>
- R\u00e9utilisation de contenu directe par conref<\/li>
- R\u00e9utilisation de contenu indirecte par cl\u00e9<\/li><\/ul>\n\n\n\n
Les cl\u00e9s sont de plus en plus utilis\u00e9es ; toutefois, on trouve la combinaison de cl\u00e9s et de conrefs. Cette alliance permet flexibilit\u00e9 et contr\u00f4le.<\/p>\n\n\n\n
Documenter ses choix dans un guide de style<\/span><\/h3>\n\n\n\n
Finalement, les points \u00e0 retenir pour les r\u00e9dacteurs sont bien de a) tester et b) documenter les choix d\u2019architecture, de balises, etc. que vous faites dans votre organisation. \nUn architecte d\u2019information vous aidera normalement \u00e0 concevoir un mod\u00e8le de contenu pour votre \u00e9quipe. Toutefois, si vous n\u2019avez pas de ressource interne, il est essentiel que vous puissiez embaucher quelqu\u2019un avec l\u2019exp\u00e9rience et la compr\u00e9hension n\u00e9cessaire pour aider votre \u00e9quipe.\n<\/p>\n\n\n\n
Les choix, lorsqu\u2019ils sont valid\u00e9s, doivent \u00eatre ajout\u00e9s \u00e0 votre guide de style. Vous pouvez vouloir \u00e9galement cr\u00e9er des mod\u00e8les de contenus pour guider vos r\u00e9dacteurs. De plus, certains logiciels permettent d\u2019int\u00e9grer vos guides dans votre \u00e9diteur directement.<\/p>\n\n\n\n
Bon \u00e0 savoir : Comtech Services a contribu\u00e9 \u00e0 la cr\u00e9ation d\u2019un mod\u00e8le de guide de style qui peut vous permettre de d\u00e9marrer votre propre guide de style3<\/sup><\/a>.<\/p>\n\n\n\n
—
Retrouvez la premi\u00e8re partie de ce blog ici<\/a><\/span>, et d\u00e9couvrez-en la troisi\u00e8me partie, ici<\/a><\/span>.<\/p>\n\n\n\n—
Ce blog a \u00e9t\u00e9 initialement publi\u00e9 dans la lettre d’information de CIDM, CIDM Matters<\/em><\/a><\/span>.<\/p>\n\n\n\nRessources<\/h3>\n\n\n\n
1<\/sup><\/a> Les listes de contr\u00f4le et les recommandations d\u2019accessibilit\u00e9 sur le web sont disponibles en ligne sur https:\/\/www.w3.org\/TR\/WCAG20\/#content-structure-separation<\/a><\/span><\/p>\n\n\n\n
2<\/sup><\/a> DITA Worst Practices,<\/em> pr\u00e9sentation de Keith Schengili-Roberts https:\/\/www.slideshare.net\/JackMolisani1\/keith-schengiliroberts-dita-worst-practices<\/a><\/span><\/p>\n\n\n\n
3<\/sup><\/a> Mod\u00e8le de guide de style pr\u00e9par\u00e9 par Comtech et disponible en ligne \u00e0 https:\/\/github.com\/oxygenxml\/dim\/tree\/master\/info-model<\/a><\/span><\/p>\n\n\n\n
<\/p>\n\n\n\n
Auteur du blog<\/h3>\n\n\n\n
![\"\"](\"https:\/\/www.ixiasoft.com\/wp-content\/uploads\/2021\/02\/Nolwenn.png\")
<\/figure>\n\n\n\nNolwenn Kerzreho\nTechnical Account Manager at IXIASOFT<\/em><\/span><\/p>\n\n\n\n
Avec plus d’une dizaine d’ann\u00e9es d’exp\u00e9rience dans l’industrie de la communication technique, Nolwenn Kerzreho est Responsable Technique de Compte pour IXIASOFT en Europe. Point de contact privil\u00e9gi\u00e9 de nos partenaires, Nolwenn est bas\u00e9e en France. Elle intervient r\u00e9guli\u00e8rement dans les conf\u00e9rences internationales, les colloques et les universit\u00e9s fran\u00e7aises o\u00f9 elle pr\u00e9sente DITA depuis 2009. Nolwenn a une exp\u00e9rience internationale dans les domaines de la chimie, Telecom, l’industrie langagi\u00e8re et le d\u00e9veloppement logiciel.<\/p>\n\n\n\n
Vous pouvez contacter Nolwenn sur Twitter \u00e0 @NolwennIXIASOFT<\/p>\n\n\n\n
\n\n\n\n