Créer une rubrique d'accueil par défaut

Les outils de publication DITA peuvent parfois traiter la hiérarchie d'une carte DITA différemment selon les formats de sorties. Un contournement peut être utilisé pour obtenir une plus grande cohérence entre les différentes sorties afin d'éviter de troubler les lecteurs.

Lorsqu'un fichier carte DITA est traité dans un format d'aide, la première rubrique de la hiérarchie de la carte DITA devient la première rubrique (ou rubrique par défaut) qui s'affiche. Dans certaines sorties d'aide, elle devient également la rubrique qui s'affiche lorsque le bouton Accueil du panneau de navigation à trois volets est sélectionné.

Certains formats d'aide permettent de désigner une autre rubrique comme la première rubrique par défaut (page d'accueil). Aujourd'hui, DITA n'est pas outillé pour enregistrer une rubrique d'accueil de remplament dans la carte DITA.

Dans les sorties au format d'aide Eclipse, la table des matières générée à partir de la carte DITA prend l'élément map comme nœud supérieur. Cela peut troubler l'utilisateur, dans la mesure où le titre mis en valeur dans la table des matières n'est pas le même que celui de la rubrique affichée.

Dans le premier exemple ci-après, un système d'aide Eclipse affiche un groupe d'informations par le biais de l'adresse d'accueil du répertoire. La table des matières met en valeur le titre de l'élément mapde la carte DITA, alors que la rubrique associée au premier topicref de la carte est affichée. Le deuxième exemple montre le même document, ouvert à la même adresse d'accueil, au format Microsoft. Dans ce type de sortie, l'élément map de la carte DITA n'est pas pris en compte lors de la génération de la table des matières.

Capture d'écran illustrant un nœud non lié dans la partie supérieure de la table des matières dans la sortie au format d'aide Eclipse — Figure 1: Exemple d'un titre de carte (sans rubrique associée) qui s'affiche dans la table des matières de l'aide Eclipse

Capture d'écran illustrant un nœud lié dans la partie supérieure de la table des matières de la sortie Microsoft HTML Help — Figure 2: Exemple du titre de la première rubrique qui s'affiche dans la table des matières de Microsoft HTML Help

Il existe un contournement qui consiste à structurer la carte DITA de sorte que le premier nœud soit un élément topicrefsans enfant dont les attributs de la table des matières sont définis sur non et à veiller à ce que le titre de l'élément map soit identique à celui de la première rubrique. Ainsi, la première rubrique n'apparaît pas dans la table des matières et le nœud supérieur semble être lié à la rubrique. Le balisage de la carte suivrait donc le modèle ci-dessous :

<map title="Introduction to World Time Pro">
  <topicref href="c_WorldTimePro.dita" toc="no"/>
  <topicref href="c_CalculatingTime.dita">
    <topicref .... />
    <topicref .... />
    ....
  </topicref>
  <topicref href="c_FractionConverter.dita" />
  ....
</map>

Même si ce contournement produit un bon résultat, veillez à ce que la concentration sur le format de sortie (la forme) ne compromette pas la conception de l'information (le contenu). C'est pourquoi la séparation entre contenu et forme est privilégiée.