Détailler encore plus

Lors de la création d’un ensemble d’étapes, vous pourriez avoir besoin de fournir un peu plus de détails sur la manière de réaliser une action. Dans ce cas, vous pouvez ajouter un élément <substeps> à un <step>.

L’élément <substeps> contient un ou plusieurs éléments <substep>, qui contiennent un contenu similaire à l’élément <step>. L’élément <substep> doit contenir un élément <cmd>.

DITA autorise seulement deux niveaux d’étapes. Le premier niveau utilise l’élément <steps> ; le second niveau utilise l’élément <substeps>. Vous ne pouvez pas ajouter un troisième niveau. Si vous pensez avoir besoin d’un troisième niveau d’étapes, vous devez reconsidérer le niveau d’information de votre procédure. L’information pourrait être mieux présentée par une série de tâches séparées. C’est la même chose si vous pensez fournir énormément de détails au niveau des sous-étapes.

Vidéo : Ajouter des sous-étapes à une tâche DITA

Pratique
  1. Continuez de travailler sur le fichier l_tache_debut.dita.
  2. Après le dernier élément <step>, créez un nouveau élément <step> contenant un élément <cmd> et le texte présenté ici.
    <step><cmd>Allez observer des oiseaux.</cmd>
    </step>

  3. Après la balise de fermeture de l’élément <cmd>, ajoutez un élément <substeps>.
    <step>
        <cmd>Allez observer des oiseaux.</cmd>
        <substeps>
        </substeps>
    </step>
    

    Vous pouvez avoir un ou plusieurs éléments <substeps> à l’intérieur de l’élément <step>. Cependant, ces éléments <substeps> ne peuvent s’imbriquer les uns dans les autres – ils peuvent seulement être ajoutés séquentiellement au même niveau.
  4. Si votre éditeur n’a pas ajouté automatiquement l’élément <substep> et son élément <cmd> à l’intérieur de l’élément <substep>, faites-le.
    <step>
        <cmd>Allez observer des oiseaux.</cmd>
        <substeps>
            <substep>
                <cmd></cmd>
            </substep>
        </substeps>
    </step>
    

  5. Ajoutez du contenu à l’élément <cmd> à l’intérieur de l’élément <substep> tel que présenté ici.
    <step>
        <cmd>Allez observer des oiseaux.</cmd>
        <substeps>
            <substep>
                <cmd>Promenez-vous.</cmd>
            </substep>
        </substeps>
    </step>
    

    Vous pouvez ajouter les mêmes éléments optionnels à l’intérieur de l’élément <substep> qu’à l’intérieur de l’élément <step>, tel que l’élément <info>. Par contre, vous ne pouvez pas ajouter un élément <substeps> à l’intérieur d’un élément <substep>.
  6. Après la balise de fermeture de l’élément <substep>, ajoutez deux éléments <substep> supplémentaires et ajoutez-y du contenu tel que présenté ici :
    <step>
        <cmd>Allez observer des oiseaux.</cmd>
        <substeps>
            <substep>
                <cmd>Promenez-vous.</cmd>
            </substep>
            <substep>
                <cmd>Lorsque vous en voyez un, arrêtez-vous.</cmd>
            </substep>
            <substep>
                <cmd>Identifiez-le.</cmd>
            </substep>
        </substeps>
    </step>
    

Contributeurs