À propos du Guide de Style DITA

La demande en rédacteurs techniques formés à DITA s’accroît à mesure qu'augmente le nombre d'entreprises utilisant DITA pour standardiser le développement de leur contenu technique. Le Guide de Style DITA fournit des explications pratiques et détaillées des éléments et des attributs DITA. Des exemples concrets et des conseils clairs vous aident à créer des contenus DITA cohérents et sémantiquement justes.

Le Guide de Style DITA : bonnes pratiques pour les rédacteurs est conçu pour aider les rédacteurs DITA à utiliser DITA de façon cohérente en leur offrant une référence faisant autorité (de la même manière que The Chicago Manual of Style est une référence en matière de langue, de rédaction et de style de présentation).

Vous pouvez être en désaccord avec certains conseils ou règles, qui sont en effet discutables. Cependant, le but du Guide de Style DITA est de choisir une option afin de pouvoir au moins adopter une approche cohérente.

Le Guide de Style DITA est rédigé pour le modèle de base DITA, et non pour les spécialisations. (La nature de la spécialisation rendrait impossible la rédaction de règles d'utilisation !)

L'ensemble des règles ou des conseils présentés dans le Guide de Style DITA n'est pas exhaustif. Il répond aux questions les plus fréquemment posées par les utilisateurs de DITA, sur la base d'une analyse de la liste de diffusion du Yahoo! DITA Users Group.

Le Guide de Style DITA n'est pas lié à un outil de rédaction. C'est pourquoi les exemples sont illustrés avec un code neutre plutôt que ce qui pourrait apparaître dans un éditeur WYSIOO, ou dans toute autre interface spécifique à un outil. Ce manuel contient de nombreux exemples pratiques, la plupart basés sur un manuel automobile fictif.

Les guides de style sont souvent organisés par ordre alphabétique, mais ce Guide de Style DITA est organisé en neuf chapitres couvrant différents aspects du balisage DITA. Il s'agit ici de proposer un document de référence et non pas un livre, et l'index est donc détaillé et complet.

Le Guide de Style DITA n'a pas pour objectif de vous apprendre DITA et est destiné à des personnes travaillant déjà dans un environnement DITA. Il suppose également un savoir-faire pratique des principes du XML, comme le fonctionnement des attributs et des éléments.

Le Guide de Style DITA a été rédigé spécialement pour être utilisé conjointement, ou en complément, de la Spécification DITA (DITA Language Reference), mais n'en est pas une alternative. La version en ligne du Guide de Style DITA contiendra des liens vers la Spécification DITA (DITA Language Reference).

À moyen terme, il est prévu que le Guide de Style DITA devienne une ressource communautaire libre, probablement sous la forme d'un Wiki basé sur DITA.

Le Guide de Style DITA a été rédigé avec la version DITA 1.1, et a appliqué ses propres recommandations la plupart du temps ! Cependant, il est presque certain que des erreurs sont restées malgré tous nos efforts pour les corriger. Pour les changements et errata, veuillez visitez la page suivante : http://www.ditastyle.com/.