Figures et images

Les images sont insérées dans le contenu d'une rubrique grâce à l'élément image. Cet élément peut être autonome ou contenu dans un élément figure (fig).

Même si des images peuvent être insérées dans une rubrique DITA avec l'élément image sans passer par l'élément figure pour les englober, les éléments figure sont généralement le meilleur moyen de structurer les graphiques et autres illustrations. En revanche, pour de simples images en ligne (c'est-à-dire des images qui font partie intégrante du texte), un élément image indépendant est nécessaire.

En règle générale, les images sont stockées dans des fichiers séparés, externes à DITA, mais il est possible d'incorporer des images dont le format est basé sur le langage XML, tel le SVG, au sein du langage XLM de la rubrique DITA.

Dans DITA, les éléments figure sont des éléments conteneurs, habituellement composés d'un élément titre, d'un élément image et d'un élément desc.

L'exemple suivant présente le code DITA d'une figure basique :
<fig>
 <title>Charles Darwin</title>
 <desc>
  <cite>Photographie : Bibliothèque du Congrès, Division Impressions & Photographies,
  [numéro de reproduction, LC-USZ61-104]</cite>
 </desc>
 <image placement="inline" align="right" width="208px" height="320px"
  href="../images/darwin_bibliotheque_du_congres.jpg">
  <alt>Photographie de Charles Darwin : Bibliothèque du Congrès, Division Impressions et
  Photographies, [numéro de reproduction, LC-USZ61-104]</alt>
 <image>
</fig>

L'élément titre contient un court titre décrivant la figure. Les attributs de l'élément image incluent l'emplacement, les dimensions et le placement du fichier image. Un élément enfant alt contient une description textuelle alternative de l'image (pour des appareils de lecture qui n'affichent pas les images ou des lecteurs qui ne voient pas les images). L'élément desc contient des informations supplémentaires sur l'image, comme des crédits photo ou des citations.

Même si l'élément titre apparaît avant l'élément image dans le balisage DITA, l'ordre peut être changé dans le document de sortie en modifiant le processus de publication. En revanche, il est fortement déconseillé de rompre la sémantique par des contournements (tels que le déplacement de l'élément titre dans l'élément figgroup après la balise image) dans le but de mettre en forme le document de sortie.

Le code DITA de l'exemple précédent pourrait ressembler à ceci lorsqu'il est transformé au format XHTML :
Figure 1: Exemple d'une figure au format XHTML

Exemple d'une figure au format XHTML