10.1. link

L'élément <link> définit une relation vers un autre thème. Les liens représentent les types et les rôles des thèmes dans un réseau d'information, et représentent donc des liens de navigation dans ce réseau. Les liens sont typiquement triés en sortie selon leurs attributs. Les éléments conteneurs optionnels des liens (<linkpool> et <linklist>) permettent aux auteurs de définir des groupes avec des attributs communs, ou de conserver la séquence créée des liens en sortie. Les liens placés dans un élément <linkpool> peuvent être réarrangés pour les besoins de l'affichage (combinés à d'autres liens locaux ou liens de carte) ; les liens dans un élément <linklist> devrait être affichés dans l'ordre où ils sont définis. Cf. ces éléments pour des explications supplémentaires.

Exemple

<related-links>
<linkpool type="concept">
<link href="czover.htm#sqljsupp" />
<link href="czesqlj.htm#sqljemb" />
</linkpool>
<related-links>

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept, glossary ( ( linktext) (optionnel) puis ( desc) (optionnel) )

Contenu par :

Doctype Parents
ditabase, topic, task, concept, reference, glossary related-links, linklist, linkpool

Héritage :

- topic/link

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
href Un hyperlien vers une page web externe (adresse URL) ou une autre ressource non-DITA, ou vers un autre thème DITA dans le même fichier ou dans un autre fichier. L'attribut format identifie le format de la cible. Les cibles non-DITA utilisent une syntaxe URL standard. Les thèmes DITA sont ciblés comme suit.

Cible ailleurs dans le même fichier :

  href="#topicid"

Premier thème dans un fichier différent :

  href="filename.dita"

Thème spécifique dans un fichier différent :

  href="filename.dita#topicid"

Si l'adresse URL contient un caractère ESPERLUETTE « & », on devrait utiliser son symbole (&amp;) pour indiquer ce caractère

 CDATA #IMPLIED non
query Cet attribut est déconseillé. Il sera peut-être supprimé dans le futur. CDATA #IMPLIED non
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, keyref Attributs communs, décrit à la section 25.9. Autres attributs DITA communs      

Section parente 10. Éléments de liens apparentés

Section suivante 10.2. linklist

Retour au sommaire.

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