Darwin Information Typing Architecture

DITA exploite le contenu sous forme de rubriques autonomes pouvant être exploitées dans plusieurs formats (Web, imprimable, mobile et applications embarquées), sur l'ensemble d'une gamme de produits, dans plusieurs types de document (guides, spécifications, formations, fiches produits...)

Chaque rubrique doit être suffisamment longue pour répondre aux besoins des publics cibles tout en étant suffisamment courte pour être facilement lue et réutilisée. Elle doit inclure suffisamment de contexte pour être comprise dans différents documents.

La norme DITA inclut un nombre limité de rubriques « type » répondant à des objectifs spécifiques :

• Rubrique procédurale (task) : comprend la procédure à mener pour accomplir une tâche. La structure de la rubrique contient par exemple des prérequis, une série d'étapes que l'utilisateur doit suivre pour parvenir à son objectif. La rubrique doit répondre à la question de l'utilisateur "comment faire... ?".

• Rubrique concept (concept) : décrit un objet, un concept. La structure de la rubrique contient par exemple une description, une définition, des règles et des guides. La rubrique doit répondre à la question de l'utilisateur "qu'est-ce que c'est... ?".

• Rubrique référence (reference) : permet de rassembler des informations structurées et redondantes, non critiques pour les procédures. Par exemple, elle est utilisée pour lister des lignes de commandes, une liste de pièces détachées, une liste d'ingrédients, et tous types de matériau détaillé et factuel.

D'autres types de rubriques ont été ajoutés à ces trois types de base, notamment : reprise sur erreur (troubleshooting) et entrée de glossaire (glossentry), procédure machine (machinery task). Les informations de reprise sur erreur peuvent également être incluses dans les procédures.

DITA encourage donc la rédaction du contenu sous forme de petites rubriques (topic) d'information, indépendantes (non contextualisées) et typées, à l'opposé des longs fichiers orientés livre/ouvrage.

Les rubriques elles-mêmes peuvent être réutilisées autant de fois que nécessaire dans une carte par le biais de liens (topic references). Les fragments d'information plus petits que les rubriques (un terme, un nom de marque, un avertissement de sécurité...) peuvent être également réutilisés dans l'ensemble d'une documentation (content references).

Il est également possible de créer des variables par le biais de référence indirectes nommées clés. Ceci permet de résoudre des valeurs en fonction du contexte. En effet les valeurs sont fournies par les cartes. Ainsi, une même rubriques peut présenter une valeur différente selon la carte qui l'utilise.

Le texte conditionnel autorise la publication conditionnelle, c'est-à-dire le filtrage des informations dans les rubriques en fonction d'attributs types tels que : le public (expert, novice...), la plate-forme (Linux, Windows...), le produit, etc.

Les métadonnées étendues et personnalisables facilitent la recherche de sujets, leur catégorisation et le suivi des projets (états, mention de copyright, ligne de produit, etc.)

DITA peut être étendue et contrainte - ainsi il est possible d'ajouter de nouveaux éléments, à travers la spécialisation des éléments de base (c'est son côté Darwinien). Par le biais de la spécialisation, les architectes d'information ou les rédacteurs peuvent donc moduler et combiner de nouveaux module types et éléments types, selon les besoins des compagnies et industries. Le mécanisme inverse de la spécialisation est appelé la généralisation.

DITA inclut certaines spécialisations officielles dont DITA Learning and Training[5] pour la création de contenus pédagogiques. Les rubriques et cartes sont notamment enrichies de métadonnées liées à la création de modules de cours, programmes et curriculum. Par exemple : connaissances requises, durée du module, etc. Certaines rubriques sont disponibles pour les contrôles de connaissance et l'introduction aux modules.

La norme contient également ces types de rubriques:

• Troubleshooting pour l'identification et la reprise sur erreur
• Machinery Task pour les interventions sur machines nécessitant des éléments sémantiques additionnels de type sécurité, liste des outils, temps estimé, etc.
• Glossentry et glossgroup pour la création des glossaires

  <?xml version="1.0" encoding="utf-8"?>
  <!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA BookMap//EN" "../dtd/bookmap/dtd/bookmap.dtd">
  <bookmap id="taskbook">
    <booktitle>
      <mainbooktitle>Exemple de structure de table des matières</mainbooktitle>
    </booktitle>
    <chapter href="topics/introduction.dita">
      <topicref href="tasks/procedure.dita"/>
    </chapter>
  </bookmap>

  
    <?xml version="1.0" encoding="utf-8"?>
    <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA 1.2 Topic//EN" "../../dtd/technicalContent/dtd/topic.dtd">
    <topic id="exemple-topic" xml:lang="fr-fr">
      <title>Exemple de section topic</title>
      <body>
        <hazardstatement>
          <!-- la valeur audience permet de créer du texte conditionnel ; plusieurs versions différentes peuvent être publiées via l'utilisation d'un fichier .ditaval -->
          <messagepanel audience="electriciens">
            <typeofhazard>
              Danger électrique
            </typeofhazard>
            <consequence>
              Risque d'électrocution
            </consequence>
            <howtoavoid>
              Ne touchez pas les fils électriques.
            </howtoavoid>
          </messagepanel>
          <messagepanel audience="plombiers">
            <typeofhazard>
              Dégâts des eaux
            </typeofhazard>
            <consequence>
              Risque de noyade
            </consequence>
            <howtoavoid>
              Ne plongez pas dans la piscine.
            </howtoavoid>
          </messagepanel>
        </hazardstatement>        
        <p>
          Paragraphe.
        </p>
        <example>
          <title>
            Exemple
          </title>      
          <p>
            Un exemple.
          </p>
          <note type="important">
            Remarque importante.
          </note>
          <fig>
            <title>Illustration</title>        
            <image href="../images/schemas/illustration.png" placement="break"
                   align="center"><alt>Texte descriptif de l'image</alt></image>
          </fig>
        </example>
      </body>
    </topic>

  
    <?xml version="1.0" encoding="utf-8"?>
    <!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "../../dtd/technicalContent/dtd/task.dtd">
    <task id="sample" xml:lang="fr-fr">
      <title>Exemple de procédure pas à pas</title>
      <shortdesc>Ceci est un exemple de procédure pas à pas.</shortdesc>
      <!-- Ceci est un commentaire -->
      <taskbody>
        <context>
          <p>
            Cette partie indique le contexte dans lequel se déroule la procédure.
          </p>
        </context>
        <steps>
          <stepsection>Pour effectuer la procédure :</stepsection>
          <step>
            <cmd>
              Cliquez sur <uicontrol>l'option 1</uicontrol>.
            </cmd>
            <stepxmp>
              Exemple pour cette étape.
            </stepxmp>
          </step>
          <step>
            <cmd>
              Cliquez sur <uicontrol>l'option 2</uicontrol>.
            </cmd>
            <info>
              Toute information supplémentaire.
            </info>
            <substeps>
              <substep>
                <cmd>
                  Effectuez cette étape secondaire.
                </cmd>
              </substep>
              <substep>
                <cmd>
                  Effectuez cette étape secondaire.
                </cmd>
              </substep>
            </substeps>
            <choices>
              <choice>
                Choix 1
              </choice>
              <choice>
                Choix 2
              </choice>
            </choices>
          </step>
          <step>
            <cmd>
              Cliquez sur <uicontrol>l'option 3</uicontrol>.
            </cmd>
            <stepresult>
              Voici le résultat de la procédure.
            </stepresult>
          </step>
        </steps>
      </taskbody>
      <!-- section "Voir aussi" -->
      <related-links>
        <link href="../concepts/introduction.dita" format="dita" type="concept"></link>
      </related-links>
    </task>

  
    <?xml version="1.0" encoding="UTF-8"?> 
    <!DOCTYPE val PUBLIC "-//OASIS//DTD DITA DITAVAL//EN" "ditaval.dtd">
    <val>
      <prop att="audience" val="electriciens" action="exclude"/>
      <prop att="audience" val="plombiers" action="include"/>
    </val>