Rubriques de navigation

Plutôt que de créer manuellement un tableau et de créer des liens entre les rubriques parentes et enfants, utilisez les outils afin de générer automatiquement liens et descriptions des rubriques secondaires dans la hiérarchie. Une rubrique de navigation parente dans DITA peut devenir une rubrique d'introduction essentielle dans le document final.

Une rubrique de navigation est une courte rubrique qui contient très peu de contenu mais fournit plutôt des liens (de référence croisée) vers les informations concernées. Les rubriques de navigation servent de support de navigation pour les documents en ligne.

Les rubriques supports ne doivent pas contenir les descriptions des rubriques concernées ; au contraire, le processus de publication doit être utilisé pour insérer automatiquement les liens et les courtes descriptions de ces rubriques. Les rubriques de navigation sont généralement des rubriques parentes dans la hiérarchie d'une table des matières, dans laquelle les rubriques concernées sont enfants des rubriques de navigation parentes. Rédiger peu de contenu dans les rubriques support permet d'éviter d'avoir du contenu redondant (comme la rédaction d'une courte description à la fois dans la rubrique support et dans la rubrique enfant cible) et d'avoir des liens imbriqués qui empêchent la réutilisation de contenu (en effet, la rubrique de navigation agrémentée d'un lien imbriqué peut uniquement être utilisée si la rubrique liée est contenue dans la même collection).

Par exemple, la rubrique support suivante n'est pas correcte, car elle contient beaucoup de contenu et des liens imbriqués.

Figure 1: Exemple de rubrique support comportant des liens imbriqués et un tableau mis en forme

À la place, vous devriez utiliser une table des relations dans la carte DITA afin de générer automatiquement les liens dans les rubriques enfants et d'insérer automatiquement les courtes descriptions de ces rubriques enfants. Le résultat de cette méthode serait le suivant dans le document final.

Figure 2: Exemple de rubrique support avec des liens générés

Bien que le rendu esthétique soit différent de celui obtenu avec la rubrique support créée manuellement, les possibilités de réutilisation et d'efficacité sont des avantages bien supérieurs.