Légendes et incrustation de texte

Il est conseillé d'utiliser des légendes avec des identifiants plutôt qu'avec des libellés lors de l'identification des éléments d'une illustration.

Les diagrammes sont souvent expliqués à l'aide de légendes, c'est-à-dire des libellés et des lignes de repère ou des flèches dirigées vers des éléments de l'illustration. Les légendes peuvent donc être textuelles ou être indiquées par des identifiants.

En ce qui concerne les légendes textuelles, les libellés sont directement superposés à l'image. Concernant les légendes par identifiant, il s'agit d'identifiants numériques ou alphabétiques superposés à l'image, dont le texte explicatif est affiché en dehors de celle-ci.

Les photos suivantes présentent les deux façons d'aborder les légendes : avec du texte ou avec des identifiants.

Figure 1: Exemple de légende textuelle sur une illustration

Exemple de légende textuelle sur une illustration

Figure 2: Exemple de légende par identifiant sur une illustration

Exemple de légende par identifiant sur une illustration

A
refroidisseur intermédiaire
B
vase d'expansion

Privilégiez la méthode par identifiant, dont le texte explicatif est stocké dans une liste de définitions (dl) ou une structure de tableau simple (simpletable), au sein de l'élément figure (fig). Ainsi, les légendes sont gérées et localisées plus facilement, puisque les explications sont stockées sous forme de texte plutôt qu'incrustées dans le fichier image.

Remarque : L'élément fig peut contenir une image, une liste ordonnée, un paragraphe et un tableau, qui permettent ainsi de créer un ensemble de libellés, des légendes ou de multiples captures.
Voici un exemple de liste de définitions au sein de l'élément figure :
<fig>
  <title>Exemple de légende par identifiant sur une illustration</title>
  <image href="../images/callout_key_ej25_turbo.jpg" width="393px" height="322px">
    <alt>Exemple de légende par identifiant sur une illustration</alt>
  </image> 
		<dl> 
		  <dlentry> 
			   <dt>A</dt> 
			   <dd>refroidisseur intermédiaire</dd> 
		  </dlentry> 
		  <dlentry> 
			   <dt>B</dt> 
			   <dd>vase d'expansion</dd> 
		  </dlentry> 
		</dl>
</fig>

Il est préférable que les identifiants de légende soient des caractères alphabétiques plutôt que numériques, à moins que l'ordre soit important.