18.2. index-see-also

Un élément <index-see-also> dans un élément <indexterm> redirige le lecteur vers une autre entrée d'index que celui-ci devrait citer en plus de l'entrée courante.

Les éléments <index-see> et <index-see-also> permettent une forme de redirection vers une autre entrée d'index dans l'index généré. L'élément <index-see> se rapporte à une entrée d'index que le lecteur devrait utiliser au lieu de l'entrée courante, tandis que l'élément <index-see-also> se rapporte à une entrée d'index que le lecteur devrait utiliser en plus de l'entrée courante.

Les éléments <index-see> et <index-see-also> sont ignorés si leur élément <indexterm> parent contient des sous-éléments <indexterm>.

Outre sa redirection « see also », un élément <index-see-also> fonctionne comme un élément <indexterm> ponctuel, générant de fait une référence de page en même temps que l'indication « see also ».

Ce n'est pas une condition d'erreur s'il y a plusieurs éléments <index-see-also> pour une seule entrée d'index.

L'exemple suivant illustre l'emploi d'un élément de redirection <index-see-also> dans un élément <indexterm> :

<indexterm>Carp
   <index-see-also>Goldfish</index-see-also>
</indexterm>

Cela générera typiquement une référence de page pour « Carp » et une redirection :

L'exemple suivant illustre l'emploi d'un élément de redirection <index-see-also> vers un élément <indexterm> plus complexe (à plusieurs niveaux) :

<indexterm>Feeding
   <index-see-also>Goldfish <indexterm>feeding</indexterm></index-see-also>
</indexterm>

Cette partie du balisage d'indexation générerait des entrées d'index telles que :

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept ( données textuelles ou keyword ou option ou parmname ou apiname ou cmdname ou msgnum ou varname ou wintitle ou term ou data ou data-about ou foreign ou unknown ou indexterm) (un nombre quelconque)
map, bookmap ( données textuelles ou keyword ou term ou data ou data-about ou foreign ou unknown ou indexterm) (un nombre quelconque)

Contenu par :

Doctype Parents
bookmap, map, ditabase, topic, task, concept, reference, glossary indexterm

Héritage :

+ topic/index-base indexing-d/index-see-also

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;) Un ensemble d'attributs liés, décrit à la section 25.7. %univ-atts; entité paramètre sans objet pour une entité paramètre sans objet
%global-atts; (xtrf, xtrc) Un ensemble d'attributs liés, décrit à la section 25.2. %global-atts; entité paramètre sans objet pour une entité paramètre sans objet
class, keyref Attributs communs, décrit à la section 25.9. Autres attributs DITA communs