Tutoriel : réutilisation de contenus

Mise en oeuvre de conref.

Durée : 20 mn 
Contenus :

Exercice

Procédure :

    Réutiliser un contenu dans une recette

  1. Ouvrir le topic faire_un_roux.dita.
  2. Ajouter l'id "faire_un_roux" au step parlant du sujet. Enregistrez.
  3. Créer un topic de type task nommé "soupe_a_oignon.dita", renseignez le titre.
  4. Là où apparaît le premier step, cliquez sur le bouton d'insertion de référence de contenu ().
  5. Validez et acceptez l'insertion à un endroit valide.
  6. Insérez un lien vers faire_un_roux.dita dans la map tutoriel_map.ditamap de type ressource (processing-role=“resource-only”).
  7. Insérer bien sûr aussi la recette de la soupe à l'oignon.
  8. Publiez et constatez.
  9. Modifier une recette sans toucher à son contenu.

  10. Créer un nouveau topic de type task (faire_un_roux_sucre.dita). C'est ce topic qui porte la surcharge.
  11. Créez la structure suivante

    Avec, d'abord, le texte original et, ensuite, le texte à ajouter.
  12. 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"/>)
  13. 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.
  14. 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.
  15. Publiez et constatez.
    On peut faire la même chose avec pushbefore ou pushreplace.