Gérer les fichiers image

Les fichiers image doivent être enregistrés séparément des fichiers de rubriques. Les images peuvent être réutilisées via le référencement du nom de fichier, ou via l'inclusion de contenu (conref) d'un élément image ou d'un élément fig.

Bien qu'aucune raison technique ne justifie cette approche, vous devez conserver vos fichiers image dans un dossier indépendant de celui des rubriques afin de faciliter l'organisation et la gestion des fichiers. Choisissez un nom de dossier cohérent, généralement /images.

Vous devez pouvoir réutiliser les fichiers image comme vous le souhaitez dans les différentes rubriques de votre répertoire de contenu. Pour faire simple et afin de réutiliser un fichier image, il est possible de référencer le fichier image lui-même. Voici un exemple de ce type de réutilisation :

<concept>
...
<img href="../images/ej25.png" width="480px" height="360px" />
...
</concept>

<task>
...
<img href="../images/ej25.png"  width="480px" height="360px" />
...
</task>

Tout comme les autres éléments DITA, les éléments image peuvent être réutilisés via une transclusion conref. Afin de réutiliser des fichiers image, il existe une alternative plus simple qui consiste à réutiliser les éléments image via un attribut conref, comme dans l'exemple suivant :

<concept id="concept_engines">
...
<img id="img_ej25_engine" href="../images/ej25.png"
 width="480px" height="360px" />
...
</concept>

<task>
...
<img conref="#concept_engines/img_ej25_engine" href="-dita-use-conref-target" />
...
</task>

L'attribut href de l'élément image étant obligatoire, vous devez définir la valeur de cet attribut de l'image référencée sur -dita-use-conref-target.

Cette méthode de conref a l'avantage de permettre également la réutilisation des attributs, ce qui réduit certaines tâches répétitives. Cependant, si vous souhaitez que les attributs soient différents pour chaque utilisation d'une image, vous pouvez simplement utiliser la méthode de réutilisation de fichier.

Si vous utilisez les structures de l'élément figure (fig) plutôt que des images simples, vous pouvez référencer soit l'élément image, soit l'élément fig. Afin de choisir la méthode de réutilisation, vous devez déterminer si vous désirez conserver les attributs et les éléments de l'élément figure ou non.

Dans la version DITA 1.2, vous pouvez utiliser la fonction keyref comme alternative au conref pour référencer indirectement une image ou une figure.