Architecture de production documentaire Darwin

La Darwin Information Typing Architecture (acronyme : DITA, littéralement Architecture de production documentaire Darwin) est une architecture XML dédiée à la rédaction, la production et la distribution de la documentation technique.

Le nom de ce système s'explique comme il suit :

• Darwin : il se base sur les principes de spécialisation et d'héritage,
• Information typing : la sémantique des types de sujets traités (concepts, tâches, références) et de leur contenu est liée (phrase, message, tableau),
• Architecture : la DITA est suffisamment flexible et évolutive pour développer différents types de contenus documentaires (architecture modulaire).

DITA permet de scinder le contenu en petits sujets autonomes pouvant être exploités dans plusieurs formats. L'extensibilité de DITA permet aux organisations de définir des structures d'information spécifiques tout en continuant à utiliser leurs outils standards de façon à interagir avec. La capacité à définir des architectures documentaires spécifiques orientées entreprise ou même orientées groupe permet à DITA de réutiliser le contenu et de réduire les informations redondantes.

DITA détermine un certain nombre de sujets types, tels que Tâche, Concept et Référence. Pour DITA, un sujet Tâche comprend la procédure à mener pour accomplir une tâche. Il liste une série d'étapes que l'utilisateur doit suivre pour parvenir au résultat attendu. Un sujet de type Concept est plus objectif. Il contient des définitions, des règles et des guides. Un sujet Référence permet de décrire des lignes de commandes, de la syntaxe, des instructions ou codes, de compiler une terminologie sous forme de glossaire ou de créer tout autre type de matériau de référence détaillé et factuel. A l'origine, l'architecture DITA, sa DTD et son schéma XML ont été développés par IBM. Elle se base sur DocBook dont elle semble être un fork.

Depuis le 1^er juin 2005, DITA fait partie des standards OASIS^[1].

Sommaire 1 Fonctionnalités 2 Création du contenu 3 Publication du contenu 4 Articles connexes 5 Liens externes 6 Notes et références

Fonctionnalités

DITA encourage la rédaction du contenu sous forme de sujets modulaires, à l'opposé des longs fichiers orientés livre/ouvrage (par exemple DocBook). Les fragments de contenu liés aux sujets (ou, moins couramment, les sujets eux-mêmes) peuvent être réutilisés par le biais des références contenu (content references). Le texte conditionnel autorise le filtrage ou le contenu nominal selon des attributs types tels que : le public, la plate-forme, le produit, etc. Les métadonnées étendues facilitent la recherche de sujets.

Les éléments types et la structure des sujets DITA sont identiques aux langages de programmation populaires tels que HTML. Par exemple, une liste numérotée ou à puces peut être directement importée du HTML vers la DITA. DITA permet l'ajout des nouveaux éléments, à travers la spécialisation des éléments de base. Par le biais de la spécialisation, la DITA peut moduler et combiner de nouveaux sujets types et éléments types, selon les besoins des compagnies et industries.

Création du contenu

Créer du contenu avec la DITA consiste à écrire des sujets et des cartes (topics et maps). Une carte contient des liens vers des sujets, organisés sous forme de séquences qui apparaîtront sur les documents finaux. Un carte DITA définit la table des matières des distributions (PDF, HTML, Java Help, etc.) et peuvent spécifier quels sujets sont liés entre eux. Les fichiers DITA (cartes et sujets) sont des fichiers XML. Chaque image, fichier vidéo, et tout autre fichier devant apparaître en sortie sont intégrés via Référence. N'importe quel éditeur XML peut être utilisé pour écrire du contenu DITA, excepté les éditeurs qui ne supportent qu'un éventail limité de schémas XML (par exemple certains éditeurs XHTML).

Publication du contenu

DITA gère de bout en bout la production du contenu documentaire. En plus de préciser quels éléments, attributs et règles font partie du langage DITA, la spécification DITA inclut les règles d'impression du contenu, de génération HTML, d'aide en ligne, et d'exports vers d'autres formats. Par exemple, la spécification indique que si l'attribut conref de l'élément A contient une cible menant à l'élément B, le contenu de l'élément B sera affiché au sein de l'élément A. Les solutions de publications conformes à la DITA, connus sous le nom de processeur DITA, supportent l'attribut conref et se comportent avec tel que détaillé plus haut. Des règles existent également pour intégrer des contenus riches tels que le texte conditionnel, les marqueurs d'index, les liens sujet à sujet.

Lorsque la DITA est devenue un standard XML public en 2001, IBM a également conçu le premier processeur conforme DITA : le DITA Open Toolkit. Cette boîte à outils permet d'exporter le contenu produit avec la DITA en différents formats tels que PDF, HTML, et HTML compilé (CHM, MCH, HLP). Des extensions permettent à la DITA Open Toolkit de personnaliser les formats des exports. Les types de fichiers valides supportés sont :

• le PDF, par le biais de XSL-FO,
• le XHTML,
• le Microsoft Compressed HTML,
• l'aide ECLIPSE,
• l'aide JAVA,
• l'aide Oracle,
• le Rich Text Format.

La plupart des utilisateurs de la DITA utilisent en l'état l'Open Toolkit et ses outils de publication et de gestion de contenu de la DITA sont intégrés au processus de documentation de nombreuses entreprises.
Le DITA Open Toolkit est un projet open-source très actif soutenu par plusieurs grandes sociétés qui contribuent directement à son développement (IBM, Adobe Systems, Astoria, OASIS, COMTech, etc.).

Articles connexes

• DocBook

Liens externes

• Introduction à la DITA de IBM (en)
• Une autre introduction (en français)
• DITA Architectural Specification
• DITA Language Specification
• DITA et TIM (Task-oriented Information Modelling)

Notes et références

• (en) Cet article est partiellement ou en totalité issu d’une traduction de l’article de Wikipédia en anglais intitulé « Darwin Information Typing Architecture ».

• (es) Cet article est partiellement ou en totalité issu d’une traduction de l’article de Wikipédia en espagnol intitulé « DITA ».

• Portail de l’informatique
• Portail de l’écriture