Exposé : introduction DITA

Histoire de DITA/XML chez IBM

Mars 2004, IBM fait don de DITA à OASIS
- DITA est gérée par un comité officiel et indépendant
OASIS
- Consortium à but non lucratif
- Promouvoir des normes ouvertes
  - Connu notamment pour tableaux CALS et travaux sur XML Catalog
- Pour tout ce qui touche à la rédaction, la production, la publication et la gestion d’informations
- Objectif : standardiser outils et inter-échanges
Une forte communauté
- http://dita.xml.org est le site officiel comme lieu de rencontre et d’information pour toute la communauté intéressée par le standard OASIS DITA
- Beaucoup d’acteurs (étatsuniens surtout)
- DITA-OT : une implémentation de référence reconnue et maintenue
Version actuelle de DITA 1.2
- 1.3 en cours de finalisation

Darwin
- Utilise les principes de l’héritage objet (specialization??Spécialisation??)
Information Typing
- une méthode de rédaction de l’information technique basée sur des fragments autonomes types (Concept, Tâche , Glossaire , Référence , etc.)
Architecture
- Un modèle permettant d’étendre :
  - les structures de données
  - le processing des structures

Ne s’intéresse qu’à l’information rédactionnelle
- Peut s’intégrer comme composant d’un PLM, mais ne le remplace pas
- Permet le codage de structures sémantiques sans l’interpréter
Orienté Topic
- Un ensemble d’informations concourent à couvrir tous les aspects d’un sujet
- Les topics sont autosuffisants
  - Même idée dans 1000D et J2008
- Granularité fine
Documentation par assemblage de topics
- -> Réutilisation
Reconnaissance de l’importance des structures de données pour le texte
- DTDs et Schemas déterminent la cohérence et l’ergonomie des données de même nature
Spécialisation
- Adaptabilité aux besoins d’un projet documentaire
- Ne pas pénaliser le projet en terme de temps et/ou de complexité
- Un appareil technologique de base partagé
  - Typographique : garantir que toute spécialisation a une représentation par défaut
Un maître mot : réutilisation

Un même ensemble de contenus peut être réutilisé pour produire différentes “sorties”
- HTML, epub , PDF, Eclipse Help, etc.
Les contenus peuvent être assemblés de façon différente pour différents besoins
Les contenus peuvent être adaptés aux besoins d’une publication particulière
- Ex. documentation Microsoft VB versus documentation C#
Condition nécessaire : topics autosuffisants

Assembler les topics sous forme de hiérarchies et de séquences
- Différentes organisations pour différentes publications
- Différentes vues des mêmes topics : par produit, par tâche, etc.
Appliquer des contextes et des propriétés aux topics
- Contexte de l’utilisateur
  - Ex. programmeur Java
- Contexte de lecture
  - Modification titre d’un topic lors de son insertion dans une publication

Les types génériques sont rarement suffisants
- Besoins spécifiques à l’entreprise ou au secteur
F aire correspondre les nouveaux besoins à de nouveaux éléments
- Un nouvel élément spécialise un élément existant (liste vs liste d’outils)
- Un nouveau contenu est dérivé d’un contenu existant
Ajout seulement du « delta » – conservation de la base
La modélisation est modulaire

Principe de base de la personnalisation de contenu DITA
Adaptation du modèle de base DITA pour intégrer des éléments de vocabulaire supplémentaire
Concept, Task et Reference sont des spécialisations de Topic
La spécialisation est accessible à tous les niveaux
- Topics
- Domaines
- Maps

Les domaines
- des vocabulaires transversaux
- utilisables dans l’ensemble des topics d’un projet documentaire
Ils permettent de couvrir des aspects spécifiques de l’information
- Mises?? en évidence
- Vocabulaires spécifiques à la documentation de logiciel
Spécialisation
- Créer ses propres domaines
- Personnaliser des domaines existants

Un nouveau topic peut être rapidement réalisé
- Le vocabulaire et les structures de base sont réutilisables
  - Montée en charge des rédacteurs facilitée
- Le nouveau topic profite de toutes les évolutions
  - Du vocabulaire de base
  - Des méthodes de gestion des publications (assemblage, filtrage, etc.)
La notion de topics/ map de base garantit :
- L’ inter-opérabilité minimale
- La cohérence de présentation des contenus
Consistance
- Avec le standard, mais surtout dans le projet documentaire
- Nécessite de respecter les règles DITA lors de l’adaptation

Un éditeur spécialisé
Un outil de validation de la cohérence
Des processus de publication
- Fournis par DITA OT mais aussi d’autres éditeurs logiciels
Un CMS … rapidement
- Gestion des granules
- Assemblage de granules
- Validation et cohérence des liens
Une équipe technique pour adapter les outils
- « Local gourou » : au départ
- Informatique éditoriale : rapidement après

Approche modulaire basée sur des contenus isolés dans les topics
Une source unique pour différentes publications
Une même publication dans différents formats
Avec une reconnaissance de la notion d’extension pour « coller aux besoins projet »
Avec une implémentation minimaliste de la notion de configuration