2.11. related-links

Les liens d'informations apparentées d'un thème (<related-links>) sont stockés dans une section spéciale à la suite du corps du thème. Après le traitement d'un thème vers sa forme de sortie finale, les liens apparentés sont affichés habituellement à la fin du thème, quoique certains systèmes d'aide fondés sur le Web puissent les afficher dans un cadre de navigation séparé.

Notes pour le traitement :

  1. 1. Les liens préalables sont une exception (à savoir ceux où l'attribut importance="required" et l'attribut role est compatible — pas les valeurs "ancestor", "parent", "child", "descendant" ou "next"). Les mises en œuvre peuvent (sans obligation) les trier après l'élément <shordesc> (tous les thèmes) ou après la section <prereq> (pour les tâches) ;
  2. 2. Une sortie PDF ignore typiquement les liens hiérarchiques, par exemple, ancestor/parent/child/descendant/next/previous/sibling, bien qu'elle puisse inclure des sous-liens (child links) afin de produire des résumés au début des chapitres ;
  3. 3. Les liens non dans un élément <linklist> seront triés en sortie selon les attributs type, role et importance ;
  4. 4. La valeur de l'attribut format est de "dita" par défaut, sauf si l'attribut scope="external", lorsque le format est supposé non-DITA.

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept, glossary ( link ou linklist ou linkpool) (un ou plus)

Contenu par :

Doctype Parents
ditabase topic, concept, task, reference, glossentry
topic topic
task topic, task
concept topic, concept
reference topic, reference
glossary topic, concept, glossentry

Héritage :

- topic/related-links

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
type Décrit la cible d'une référence croisée. Cf. la section 25.10.2. L'attribut type pour des informations détaillées sur les valeurs gérées et les implications de traitement. CDATA #IMPLIED (traité comme si la cible était de type "topic", ou hérité d'un ancêtre) non
role L'attribut role définit le rôle joué par le thème cible dans la relation avec le thème courant. Par exemple, dans une relation parent/enfant, le rôle serait "parent" si la cible était le parent du thème courant, et "child" si la cible était l'enfant du thème courant. On pourrait utiliser cette structure pour trier et classer les liens lors de l'affichage. Cf. la section 25.10.4. L'attribut role pour des informations sur les valeurs gérées. (parent | child | sibling | friend | next | previous | cousin | ancestor | descendant | sample (à éviter) | external (à éviter) | other | -dita-use-conref-target) #IMPLIED non
otherrole Indique un autre rôle. Cette valeur est utilisée lorsque l'attribut role="other". CDATA #IMPLIED non
format L'attribut format identifie le format de la ressource référencée. Cf. la section 25.10.3. L'attribut format pour des détails sur les valeurs gérées. CDATA #IMPLIED non
scope L'attribut scope identife l'étroitesse de la relation entre le document courant et la ressource cible.
  • Mettez scope="local" si la ressource fait partie de l'ensemble de contenu courant ;
  • Mettez scope="peer" si la ressource fait partie de l'ensemble de contenu courant mais n'est pas accessible lors de la construction ;
  • Mettez scope="external" si la ressource ne fait pas partie de l'ensemble d'information courant et devrait s'ouvrir dans une nouvelle fenêtre de navigateur ;
  • Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations sur la valeur "-dita-use-conref-target".
La valeur de traitement par défaut est "local". Si aucune valeur n'est spécifiée, mais que l'attribut est défini sur un ancêtre dans une carte ou dans la section <related-links>, la valeur sera héritée de l'ancêtre le plus proche.		 (local | peer | external | -dita-use-conref-target) #IMPLIED non
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;) Un ensemble d'attributs liés, décrit à la section 25.7. %univ-atts; entité paramètre sans objet pour une entité paramètre sans objet
%global-atts; (xtrf, xtrc) Un ensemble d'attributs liés, décrit à la section 25.2. %global-atts; entité paramètre sans objet pour une entité paramètre sans objet
class, outputclass Attributs communs, décrit à la section 25.9. Autres attributs DITA communs      

Section parente 2. Éléments de thème

Section précédente 2.10. example

Retour au sommaire.

OASIS DITA Version 1.1 Language Specification — OASIS Standard, 1 August 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.