Les éléments index-see et index see-also

Les lecteurs peuvent être redirigés depuis un terme recherché dans l'index vers des termes connexes qui fournissent des références supplémentaires. Vous pouvez utiliser les éléments d'indexation index-see et index-see-also à cette fin.

L'élément index-see est utilisé pour rediriger le lecteur vers un terme d'index synonyme. L'élément index-see, qui contient le terme proposé comme synonyme aux lecteurs, est imbriqué dans l'élément standard indexterm, qui contient le terme apparaissant dans l'index. L'index-see doit être le seul élément enfant de l'élément parent indexterm.

Par exemple, le code

<indexterm>induction forcée
   <index-see>turbocompresseur</index-see>
</indexentry>

sera représenté ainsi dans le document de sortie :

induction forcée, Voir turbocompresseur

Lorsque cela est possible, les entrées index-see doivent être placées entre les balises topicmeta de la carte DITA, puisque, logiquement, elles s'appliquent au niveau de la publication plutôt qu'au niveau de la rubrique.

La structure de l'entrée index-see dans la carte DITA est illustrée dans l'exemple suivant :

<map id="lumberer_om_05">
  <title>Guide utilisateur du bûcheron XT</title>
  <topicmeta>
    <keywords>
      <indexterm>induction forcée
        <index-see>turbocompresseur</index-see>
      </indexterm>
    </keywords>
  </topicmeta>
  <topicref...>...</topicref>
  <topicref...>...</topicref>
  <topicref...>...</topicref>
		...
</map>

La fonction de l'élément index-see-also est similaire à celle de l’élément index-see, à la différence que le premier fournit également une référence de page vers le terme original.

Par exemple, le code

<indexterm>induction forcée
   <index-see-also>turbocompresseur</index-see-also>
</indexentry>

sera représenté ainsi dans le document de sortie :

induction forcée .................... 15
Voir également turbocompresseur

N'utilisez pas index-see-also au niveau supérieur de la balise topicmeta de l'élément map dans la carte DITA. Cependant, vous pouvez l'utiliser dans la balise topicmeta de l'élément topicref, contenu dans la carte DITA.

Dans un document hypertexte qui prend en charge les index, le même exemple pourrait être affiché comme suit :