Comprendre les concepts de la mise en relation.
Présentation sous forme de transparents.
Liens internes : référence croisée dans le corps d’un topic
Liens vers une autre partie d’un même topic
Quelle granularité ?
Liens vers un autre topic
Lien vers un contenu d’un autre topic
Lien vers une ressource non-DITA
Citations : Référence à une ressource non accessible directement via un lien
Liens en relation :
liens de cohérence entre fragments d’information
documenter un même sujet selon différentes facettes
Les destinations d’un lien peuvent être multiples
Les concepts liés à une tâche
Identifier les destinations
Problématique d’adressage (xpointer)
Plus pragmatiquement, problématique de marquage (id)
Souvent la relation est indiquée de manière unidirectionnelle (<xref>)
La destination « source » se confond avec le lien
Pratiquement, nécessite un processus de qualité pour garantir que les liens sont toujours valides
Dans DITA, la destination est une URI
Dans la pratique, c’est souvent une URL
Adressage absolu (si structure web)
Adressage relatif (si système de fichier)
URI : souvent si CMS
Destination = un topic
http://www.tireme.fr/formation_dita/exemple.dita#id_de_exemple
Destination = le contenu d’un topic
http://www.tireme.fr/formation_dita/exemple.dita#id_de_exemple/para_1
Destination = n’importe quel contenu
http ://www.powershow.com/view1/5aee1-ZDc1Z/Linking_and_Relationship_Tables_powerpoint_ppt_presentation
On devra souvent préciser quelle est la nature du contenu
Exemple de lien entre deux destinations :
<p><xref href ="http://www.tireme.fr/formation_dita/exemple.dita#id_de_exemple">Voir aussi le topic d’exemple</xref>.</p>
Ou plus précisément
<p><xref id="blabla" href ="http://www.tireme.fr/formation_dita/exemple.dita#id_de_exemple">Voir aussi le topic d’exemple</xref>.</p>
Le lien met en relation la destination "blabla" avec la destination "http://… "
< xref > : lien directement dans le texte
Le principe de la navigation sur internet
Souvent déstabilisant pour la lecture
< related -links> : formalisé par DITA, pour mettre en avant des relations entre topics ou autres informations
A ne pas confondre avec liens issus de la structure
Références avec attribut @href ou @keyref , @description et @scope de la cible, @format, @type, comme un lien dans un topic
Pas d’attribut de rôle, le rôle étant lié à la position dans la structure
Eléments de caractérisation :
<navtitle>, <searchtitle>, <linktext>, <shortdesc>
Métadonnées : attributs et éléments
Réutilisation :
@id et @conref
