Ajout d'un marquage d'indexation
Pour créer un index, insérez des éléments d'indexation dans l'ensemble du document. Le contenu ajouté aux éléments d'indexation devient l'entrée d'index. Le texte entré dans les éléments indexterm s'affiche en couleur à l'écran, ce qui permet de le distinguer facilement du contenu du document.
Un élément indexterm doit toujours contenir un élément primary. Il peut également contenir les éléments secondary et tertiary. Le dernier de ces trois éléments figurant dans indexterm peut être suivi d'un seul élément see ou d'un ou de plusieurs éléments seealso.
|
|
Comme les éléments indexterm sont supprimés pendant la sortie, Arbortext Editor les associe à l'élément visible le plus proche disposant d'un identificateur (paragraphe ou en-tête de section, par exemple). Dans la sortie d'un document au format PDF ou HTML, si l'élément associé inclut un saut de page forcé, l'entrée d'index liée à l'élément indexterm supprimé passe à la page sur laquelle se trouve l'élément associé, plutôt qu'à la page sur laquelle se trouve l'élément indexterm.
Pour éviter ce problème, placez l'élément indexterm avant l'élément visible le plus proche ne comportant pas de saut de page forcé.
|
• Elément primary : requis. Le texte de cet élément représente l'entrée d'index de premier niveau. Voici la structure de référence d'une entrée primary :
<indexterm><primary>entrée d'index principale</primary></indexterm>
Dans l'index final, cette information pourrait se présenter au format suivant :
main index entry, page number
• Elément secondary : facultatif. Le texte d'un élément secondary s'affiche comme sous-entrée sous l'entrée principale. Voici la structure de référence d'une entrée secondary :
<indexterm><primary>entrée d'index principale</primary>
<secondary>entrée d'index secondaire</secondary></indexterm>
Dans l'index final, cette information pourrait se présenter au format suivant :
main index entry
secondary index entry, page number
• Elément tertiary : facultatif. Il doit être précédé d'un élément secondary. Le texte d'un élément tertiary s'affiche comme sous-entrée de second niveau. Voici la structure de référence d'une entrée tertiary :
<indexterm><primary>entrée d'index principale</primary>
<secondary>entrée d'index secondaire</secondary>
<tertiary>entrée d'index tertiaire</tertiary></indexterm>
Dans l'index final, cette information pourrait se présenter au format suivant :
main index entry
secondary index entry
tertiary index entry, page number
• Référence See : redirige l'utilisateur d'une entrée d'index ne contenant aucune information vers une entrée d'index où les références vers le document principal sont créées. Des références See peuvent être créées depuis l'élément de niveau le plus bas présent dans un élément indexterm uniquement. Voici la structure de marquage d'une référence see :
<indexterm><primary>entrée d'index principale</primary>
<see>entrée d'index principale alternative</see></indexterm>
Dans l'index final, cette information pourrait se présenter au format suivant :
main index entry, see alternate main index entry
• Référence See also : redirige l'utilisateur d'une entrée d'index vers une autre entrée pouvant contenir des informations supplémentaires. Voici la structure de marquage d'une référence see also :
<indexterm><primary>entrée d'index principale</primary>
<seealso>entrée d'index principale supplémentaire</seealso></indexterm>
Dans l'index final, cette information pourrait se présenter au format suivant :
main index entry, page number
see also additional main index entry
