Possibilité de travailler en adressage "direct" (conref) ou en
"indirect" (conrefkey).
L'adressage est de la forme xxx.dita#topic-id/element-id (ou
xxx/element-id si on utilise les keys).
Exercice
Procédure :
Réutiliser un contenu dans une recette
Ouvrir le topic faire_un_roux.dita.
Ajouter l'id "faire_un_roux" au step parlant du sujet.
Enregistrez.
Créer un topic de type task nommé "soupe_a_oignon.dita",
renseignez le titre.
Là où apparaît le premier step, cliquez sur le bouton d'insertion de
référence de contenu ().
Validez et acceptez l'insertion à un endroit valide.
Insérez un lien vers faire_un_roux.dita dans la map
tutoriel_map.ditamap de type ressource
(processing-role=“resource-only”).
Insérer bien sûr aussi la recette de la soupe à l'oignon.
Publiez et constatez.
Modifier une recette sans toucher à son contenu.
Créer un nouveau topic de type task (faire_un_roux_sucre.dita).
C'est ce topic qui porte la surcharge.
Créez la structure suivante
Avec, d'abord,
le texte original et, ensuite, le texte à ajouter.
Référencez (topicref) le nouveau topic dans la map
tutoriel_map.ditamap, mais en marquant le topicref
comme n'ayant qu'un rôle de ressource (<topicref
href="faire_un_roux_sucre.dita" processing-role="resource-only"/>)
Rouvrez le topic faire_un_roux.dita et ajoutez un id à
steps (par exemple, toutes_etapes). C'est l'ensemble
de cette procédure que l'on va réutiliser telle quelle, avec son step ajouté
via faire_un_roux_sucre.dita.
Rouvrez soupe_a_oignon.dita et, cette fois-ci, mettez le
conref au niveau de steps pour appeler toute la
procédure contenue dans faire_un_roux.dita.
Publiez et constatez.
On peut faire la même chose avec pushbefore ou
pushreplace.