Les thèmes de tâche répondent aux questions « Comment est-ce que… ? » et ont une structure bien définie qui décrit comment suivre une procédure pour accomplir un objectif spécifique. Utilisez le thème de tâche pour décrire les étapes d'une tâche particulière ou pour fournir un aperçu d'une tâche de niveau supérieur. Le thème de tâche comprend des sections pour décrire le contexte, les conditions préalables, les étapes réelles et les prochaines étapes d'une tâche. Pour plus de détails sur l'utilisation de l'élément <task> et des autres types d'information, veuillez consulter la spécification architecturale DITA.
task> est l'élément de niveau supérieur d'un thème de tâche. Les éléments <task> sont les blocs de construction principaux pour l'assistance aux utilisateurs orientée tâche. Ils fournissent en général des instructions pas-à-pas qui permettront à l'utilisateur de réaliser une tâche. Une tâche répond aux questions « Comment… ? » en indiquant précisément à l'utilisateur quoi faire et dans quel ordre. Les tâches ont la même structure de niveau supérieur que les autres thèmes, avec un titre, une description courte et un corps.taskbody> est le principal élément de niveau corps dans un thème de tâche. Un corps de tâche a une structure très spécifique, avec les éléments suivants dans cet ordre : <prereq>, <context>, <steps>, <result>, <example> et <postreq>. Chacune des sections de corps est optionnelle.prereq>) d'une tâche devrait documenter les choses que l'utilisateur doit connaître ou faire avant de commencer la tâche courante. Les liens de conditions préalables se placeront dans une liste après la section <related-links> ; en sortie, les liens <prereq> de la section <related-links> s'ajouteront à la section <prereq>.context> d'une tâche fournit l'information de base de la tâche. Cette information aide l'utilisateur à comprendre le but de la tâche et ce qu'il gagnera à l'accomplir. Cette section devrait être brève et elle ne remplace pas ni recrée un thème de concept sur le même sujet, bien que la section de contexte puisse inclure des informations conceptuelles.steps> d'une tâche fournit le contenu principal du thème de tâche. La tâche est décrite comme une série d'étapes que l'utilisateur doit observer pour accomplir la tâche. Un ou plusieurs éléments <step> sont obligatoires dans la section <steps>.steps>, la section <steps-unordered> d'une tâche fournit le contenu principal du thème de tâche mais particulièrement pour les cas où l'ordre des étapes peut varier d'une situation à l'autre. Une ou plusieurs étapes sont obligatoires dans la section <steps-unordered>.step> représente une action à suivre par l'utilisateur pour accomplir une tâche. Chaque étape dans une tâche doit contenir un élément <cmd> qui décrit l'action particulière que doit effectuer l'utilisateur pour accomplir la tâche globale. L'élément <step> peut également contenir des informations (<info>), des sous-étapes (<substeps>), des tutoriels (<tutorialinfo>), un exemple d'étape (<stepxmp>), des choix (<choices>) ou un résultat d'étape (<stepresult>), qui sont optionnels.cmd>) est obligatoire comme premier élément dans un <step>. Il fournit à l'utilisateur l'instruction effective pour réaliser l'étape et ne devrait pas faire plus d'une phrase. Si l'étape nécessite d'autres explications, celles-ci peuvent suivre l'élément <cmd> dans un élément <info>.info>) apparaît dans un élément <step> pour apporter d'autres informations à propos de l'étape.substeps> permet de découper une étape en une série d'actions séparées, et ne devrait être utilisé que si nécessaire. Essayez de décrire les étapes d'une tâche à un seul niveau d'étapes. Si vous devez employer plus d'un niveau d'imbrication de sous-étapes, vous devriez probablement récrire la tâche pour la simplifier.substep> a la même structure que <step>, sauf qu'il n'admet pas de listes de choix ou de sous-étapes en son sein, afin d'empêcher l'imbrication illimitée des étapes.stepxmp>) sert à illustrer l'étape d'une tâche. L'exemple peut prendre la forme de quelques mots ou d'un paragraphe entier.choicetable> contient une série de choix optionnels disponibles dans l'étape d'une tâche.chhead> est un conteneur dans l'élément <choicetable> qui fournit un texte de rubrique spécifique pour remplacer les rubriques par défaut « Options » et « Description ». L'élément <chhead> contient un couple d'éléments <choptionhd> et <chdeschd>.choptionhd> fournit un intitulé spécifique pour la liste des options que l'utilisateur choisit pour accomplir une étape. L'intitulé par défaut des options est « Option ».chdeschd> fournit un intitulé spécifique pour la liste des descriptions d'option que l'utilisateur doit choisir pour accomplir l'étape d'une tâche. L'élément <chdeschd> remplace l'intitulé par défaut « Description ».chrow> est un conteneur dans l'élément <choicetable>. L'élément <chrow> contient un couple d'éléments <choption> et <chdesc>.choption> décrit une option utilisable par l'utilisateur pour accomplir une étape d'une tâche. Dans une interface utilisateur, par exemple, cela pourrait être le nom d'un bouton radio.chdesc> est une description d'une option que l'utilisateur choisit en réalisant une étape pour accomplir une tâche. Il explique pourquoi l'utilisateur devrait utiliser cette option et pourrait expliquer le résultat du choix si celui-ci n'est pas immédiatement évident.choices> contient une liste d'éléments <choice>. On l'utilise quand l'utilisateur aura à choisir l'une parmi plusieurs actions en réalisant les étapes d'une tâche.choice> décrit une façon dont l'utilisateur pourrait réaliser l'étape courante.stepresult> fournit des informations à propos du résultat prévu d'une étape. Si on documentait une interface utilisateur, le résultat pourrait décrire une boîte de dialogue qui s'ouvre, ou l'aspect d'un indicateur de progression. Les résultats d'étape sont utiles pour indique à un utilisateur qu'il est sur la bonne voie, mais ne devraient pas être employés pour toutes les étapes, car cela deviendrait rapidement fastidieux.tutorialinfo>) contient d'autres informations utiles lorsque la tâche fait partie d'un tutoriel.result> décrit le résultat prévu de la tâche dans sa globalité.postreq> décrit les étapes ou les tâches que l'utilisateur devrait effectuer après l'achèvement réussie de la tâche courante. Cela se manifeste souvent par des liens vers la tâche ou les tâches suivantes dans la section <related-links>.OASIS DITA Version 1.1 Language Specification — OASIS Standard, 1 August 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.