Éviter d'insérer dans le texte des références croisées vers des rubriques

Vous devez stocker les références croisées vers d'autres rubriques dans la table des relations de la carte DITA, externe à la rubrique, et non directement dans le texte de la rubrique.

L'objectif de la carte DITA ne se limite pas à la spécification du contenu d'une collection. Des liens automatiques inter-rubriques sont également générés à partir de la hiérarchie des rubriques de la carte DITA. La table des relations insérée dans la carte DITA permet d'approfondir davantage ce raccordement automatique.

Lorsque la même rubrique apparaît dans une carte DITA différente, ses liens sont déterminés par la hiérarchie et la table des relations de cette autre carte DITA. En d'autres termes, les liens entre les rubriques ne sont pas contenus dans les rubriques, mais centralisés dans la carte DITA. La gestion des fichiers devient alors beaucoup plus efficace.

Insérer les références croisées vers d'autres rubriques au sein des paragraphes d'une rubrique peut être problématique si la cible de la référence croisée n'est pas distribuée avec la rubrique source. Cela peut mener à des liens brisés ou à des incompréhensions concernant les liens définis.

Vous devez donc définir les références entre les rubriques dans la carte DITA en utilisant la table des relations (reltable).

La pratique montre qu'il est plus efficace de placer les liens à l'extérieur des paragraphes.

J'ai remarqué que les liens sont plus efficaces lorsqu'ils sont séparés du texte. Introduire les liens dans les phrases réduit la lisibilité et la cliquabilité.

Gerry McGovern