Les rubriques Task

Objectifs
  • Comprendre l’objectif du type de tâche DITA
  • Identifier les composants clés d’une tâche
  • Créer une tâche DITA

Une rubrique tâche répond à la question « Comment fais-je ? ». Cela inclut des instructions pas-à-pas pour compléter une procédure. DITA autorise aussi des résultats d’étapes, des graphiques, des notes et un niveau de sous-étapes.

Le contenu technique contient souvent énormément de tâches.

DITA fourni deux types de tâches :

  • La tâche stricte
  • La tâche générale

La tâche stricte exige que tous les éléments apparaissent dans un ordre spécifique, autorise seulement un élément <example>, et comporte deux éléments très formels pour les étapes (<steps> ou <steps-unordered>). La « tâche générale », également appelée « tâche laxiste » permet plus de flexibilité dans l’ordre des éléments, autorise plusieurs éléments <example> et autorise un élément <steps-informal> pour les étapes, qui peuvent contenir du contenu bien plus varié. Les tâches strictes sont appropriés pour des points qui exigent des instructions détaillées ; les tâches générales sont utiles pour les aperçus de processus.

Les éléments courants utilisés dans une rubrique tâche stricte comprennent :

  • <taskbody> (le corps de la rubrique tâche)
  • <steps> (la séquence d’actions)
  • <step> (chaque action individuelle)
    • <cmd> (l’action à faire ; c’est un élément requis dans un <step>)
    • <info> (information additionelle à propos de l’étape)
    • <stepresult> (ce qui arrive après avoir réalisé l’action)
    • <stepxmp> (un exemple de comment réaliser l’étape)
  • <example> (un exemple de comment réaliser la tâche entière)

Vidéo : Aperçu du code d’une rubrique tâche DITA

Contributeurs