5.7. step

L'élément <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.

Exemple

<task id="sqlj">
<title>Creating an SQLJ file</title>
<taskbody>
<context>Once you have set up SQLJ, you need to create a new SQLJ file.
</context>
<steps>
 <step>
  <cmd>Select 
   <menucascade>
    <uicontrol>File</uicontrol>
    <uicontrol>New</uicontrol>
   </menucascade>.</cmd>
  <info>New files are created with default values based on a standard template.</info>
 </step>
</steps>
</taskbody>
</task>

Contient :

Doctype Modèle de contenu
ditabase, task ( cmd puis ( info ou substeps ou tutorialinfo ou stepxmp ou choicetable ou choices) (un nombre quelconque) puis ( stepresult) (optionnel) )

Contenu par :

Doctype Parents
ditabase, task steps, steps-unordered

Héritage :

- topic/li task/step

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
importance Décrit si l'étape ou la sous-étape courantes sont optionnelles ("optional") ou obligatoires ("required"). Les processeurs de sortie peuvent (sans obligation) mettre en exergue les étapes qui sont optionnelles ou obligatoires. optional | required | -dita-use-conref-target #IMPLIED non
props L'attribut racine à partir duquel on peut spécialiser de nouveaux attributs de métadonnée. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage ou du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié sur un ancêtre dans une carte ou dans la section <related-links>, la valeur sera héritée de l'ancêtre le plus proche. L'attribut prend un ensemble de valeurs délimitées par des espaces. Par contre, agissant comme conteneur pour des attributs généralisés, le modèle de contenu sera plus complexe ; ce modèle est décrit à la section Généralisation des attributs de la spécification architecturale DITA. CDATA #IMPLIED non
base Un attribut générique sans utilisation spécifique mais destiné à servir de base pour les attributs spécialisés qui ont une syntaxe de valeur simple comme les attributs de traitement conditionnel (une ou plusieurs valeurs alphanumériques séparées par des blancs). L'attribut prend un ensemble de valeurs délimitées par des espaces. Par contre, lorsqu'il sert de conteneur pour des attributs généralisés, le modèle de contenu sera plus complexe ; ce modèle est documenté à la section Généralisation des attributs de la spécification architecturale DITA. CDATA #IMPLIED non
platform Indique le système d'exploitation et le matériel. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage et du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié sur un ancêtre dans une carte ou dans la section <related-links>, la valeur sera héritée de l'ancêtre le plus proche. L'attribut prend un ensemble de valeurs séparées par des espaces. CDATA #IMPLIED non
product Contient le nom du produit auquel le thème s'applique. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage ou du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié sur un ancêtre dans une carte ou dans la section <related-links>, la valeur sera héritée de l'ancêtre le plus proche. L'attribut prend un ensemble de valeurs séparées par des espaces. CDATA #IMPLIED non
audience Indique le public visé pour l'élément. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage ou du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié sur un ancêtre dans une carte ou dans la section <related-links>, la valeur sera héritée de l'ancêtre le plus proche. L'attribut prend un ensemble de valeurs séparées par des espaces. CDATA #IMPLIED non
otherprops Cet attribut est utilisable pour toutes les autres propriétés qui seraient nécessaires pour décrire un public ou pour fournir des critères de sélection pour l'élément. C'est un attribut de propriété qui soutient un traitement conditionnel du filtrage ou du marquage. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié sur un ancêtre dans une carte ou dans la section <related-links>, la valeur sera héritée de l'ancêtre le plus proche. L'attribut prend un ensemble de valeurs séparées par des espaces. CDATA #IMPLIED non
rev Indique le niveau de révision d'un élément. Il est utile pour marquer les sorties fondées sur une révision. Si aucune valeur n'est spécifiée, mais que l'attribut est spécifié sur un ancêtre dans une carte ou dans la section <related-links>, la valeur sera héritée de l'ancêtre le plus proche. CDATA #IMPLIED non
status Le statut de l'élément courant. new | changed | deleted | unchanged | -dita-use-conref-target #IMPLIED non
%id-atts; (id, conref) Un ensemble d'attributs liés, décrit à la section 25.3. %id-atts; entité paramètre sans objet pour une entité paramètre sans objet
%localization-atts; (translate, xml:lang, dir) Un ensemble d'attributs liés, décrit à la section 25.6. %localization-atts;. entité paramètre sans objet pour une entité paramètre sans objet
%global-atts; (xtrf, xtrc) Un ensemble d'attributs liés, décrit à la section 25.2. %global-atts; entité paramètre sans objet pour une entité paramètre sans objet
class, outputclass Attributs communs, décrit à la section 25.9. Autres attributs DITA communs      

Section parente 5. Éléments de tâche

Section précédente 5.6. steps-unordered

Section suivante 5.8. cmd

Retour au sommaire.

OASIS DITA Version 1.1 Language Specification — OASIS Standard, 1 August 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.