Exclure des rubriques de la table des matières de sortie

Lors de la génération d'un fichier de sortie comprenant une table des matières, il est possible que vous souhaitiez générer une rubrique à partir de votre carte DITA, sans qu'elle apparaisse dans la table des matières. Il est possible de le faire grâce aux attributs toc et linking de l'élément topicref.

Par défaut, chaque rubrique référencée dans la carte DITA apparaîtra dans le fichier de sortie, qu'elle soit référencée dans la section hiérarchie ou dans la section reltable de la carte.

Dans certains cas, une rubrique de votre collection ne devra pas apparaître dans la table des matières. En effet, si vous avez une rubrique contenant un exemple, référencée depuis une rubrique de type concept, il vous est possible de modifier la hiérachie de la rubrique de façon à ce que la rubrique d'exemple soit un enfant de la rubrique de type concept. Vous souhaitez qu'un lien soit généré automatiquement depuis la rubrique parente vers l'enfant, en se basant sur la hiérachie, mais vous ne voulez pas que la rubrique exemple apparaisse comme l'unique enfant de la rubrique concept dans la table des matières.

Pour exclure une rubrique de la table des matières, vous devez définir l'attribut toc de l'élément topicref correspondant sur no.

Voici un exemple de balisage :
<topicref
  format="dita"
  href="Reference/FeatureComparisonTable.dita"
  navtitle="Les caractéristiques des différentes versions de World Time Pro"
  scope="local"
  type="reference"
  linking="yes"
  toc="no" />

Si vous ne souhaitez pas générer automatiquement le lien parent-enfant (soit parce que vous souhaitez les relier manuellement, soit parce que vous souhaitez utiliser une relation reltable), vous devez fixer l'attribut linking de l'élément topicref sur none.

Remarque : Si vous souhaitez exclure de la table des matières la totalité d'une rubrique comprise dans la carte DITA, vous devez supprimer de la carte tous les éléments topicref faisant référence à cette rubrique, y compris ceux de la table des relations. Si vous utilisez une publication conditionnelle, vous pouvez définir les attributs de métadonnée de filtrage (comme <topicref audience="administrator"... />) sur tous les éléments topicref qui font référence à la rubrique à filtrer pendant la procédure de publication.