L'attribut linking
L'attribut linking des éléments topicref et relcell est utilisé dans la ditamap pour définir la manière dont les liens seront générés lors de la publication.
L'élément topicref (dans la section hiérarchique de la ditamap) et les éléments relcolspec et relcell (dans la section table des relations de la ditamap) ont un attribut linking. Cet attribut vous permet d'ajuster la création des liens automatiques dans la publication.
- targetonly
- Une rubrique peut être référencée, mais ne peut pas renvoyer vers d'autres rubriques.
- sourceonly
- Une rubrique ne peut pas être référencée mais peut renvoyer vers d'autres rubriques.
- normal
- Une rubrique peut être référencée et renvoyer vers d'autres rubriques. L'utilisation de cette valeur neutralise la valeur de l'attribut linking d'une rubrique parente.
- none
- Une rubrique ne peut être référencée, ni renvoyer vers d'autres rubriques.
Exemple de syntaxe :
<topicref href="abc.dita" linking="sourceonly" />
L'utilisation de l'attribut linking peut être utile dans le cas où, par exemple, vous ne souhaitez pas que les liens vers la rubrique parente apparaissent dans chaque rubrique enfant. En définissant l'attribut linking sur sourceonly, le document de sortie affichera les liens des rubriques parentes vers les rubriques enfants, et non l'inverse.
De même, si vous souhaitez qu'aucun lien ne soit généré dans une certaine branche hiérarchique de la ditamap, il vous est possible de définir l'attribut linking du topicref parent sur none.