Ajouter d’autres éléments

Rédiger des concepts DITA Leçon 3 : Plus d’éléments Ajouter d’autres éléments
Progression de la Leçon
0% Terminé

DITA utilise plein d’autres éléments importants. En voici trois de plus :

<fn>

Élément insèrant une note de bas de page.

<menucascade>

Élément indiquant l’ordre d’un chemin de menu, tel que Fichier > Enregistrer sous. L’élément <menucascade> doit contenir un ou plusieurs éléments <uicontrol>. Chaque élément <uicontrol> contient le texte d’un titre de menu.

<dl>

Élément contenant une liste de définition. Une liste de définition est une liste de termes et leur définition correspondante, présenté, par défaut, sous un format similaire à un tableau à deux colonnes. La liste de définition contient une ou plusieurs entrées, marqué avec l’élément <dlentry> et chaque entrée contient un terme (marqué avec l’élément <dt>) et une ou plusieurs définitions (marqué avec l’élément <dd>).
Pratique
  1. Continuez d’utiliser le fichier leçon3/l_concept_elements_debut.dita et ajouter chacun de ces éléments dans votre fichier d’exemple.
  2. Après le dernier élément <p>, ajoutez un nouvel élément <p> avec, à l’intérieur, l’élément <fn>, tel que présenté dans l’exemple suivant : 
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_elements">
   <title>Nourrir les canetons</title>
  <conbody>
...
 <p>Les canetons ont besoin d'une plus grande quantité de protéines dans leur alimentation que les canards adultes.<fn>Un taux de protéines de 18 à 20% est recommandé pour les canetons nouveau-nés.</fn></p>
</conbody>
</concept>

    L’élément <fn> indique où le numéro de référence de la note de bas de page apparaîtra dans le paragraphe. Par défaut, le texte présent dans l’élément <fn> est affiché en bas de la page (pour les PDF) ou à la fin de la rubrique (pour l’HTML) lorsque vous générez la publication du fichier.
  3. Après le dernier élément <p>, ajoutez un nouvel élément <p> avec un élément <menucascade> à l’intérieur, tel que présenté dans l’exemple suivant :
    Vidéo : Créer un menu en cascade avec DITA
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_elements">
   <title>Nourrir les canetons</title>
  <conbody>
...
<p>Pour créer une feuille de calcul afin de savoir quand vous devez réapprovisionner
    en eau et en nourriture vos canetons, allez à 
<menucascade>
</menucascade>.
</p>
</conbody>
</concept>

    Dans l’exemple que vous avez ajouté, l’élément <menucascade> sera utilisé pour montrer les options du menu impliquées dans la création d’une feuille de calcul.
  4. À l’intérieur de l’élément <menucascade>, ajoutez un élément <uicontrol> et ajoutez-y du contenu tel que présenté dans l’exemple suivant : 
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_elements">
   <title>Nourrir les canetons</title>
   <conbody>
...
<menucascade>
<uicontrol>Fichier</uicontrol>
</menucascade>
...
</conbody>
</concept>

    Dans l’exemple ajouté, l’élément <uicontrol> contient le nom de la première option de menu impliquée dans la création d’une feuille de calcul : « Fichier ».
  5. Après l’élément <uicontrol>, ajoutez deux éléments <uicontrol> supplémentaires et ajoutez-y du contenu tel que présenté dans l’exemple suivant : 
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_elements">
   <title>Nourrir les canetons</title>
  <conbody>
... 
<menucascade>
<uicontrol>Fichier</uicontrol>
<uicontrol>Nouveau</uicontrol>
<uicontrol>Tableur</uicontrol>
</menucascade>
...
</conbody>
</concept>

    Par défaut, une flêche est insérée entre les éléments <uicontrol> au niveau de la publication pour indiquer la hiérarchie des options du menu.
    Avec les éléments <menucascade> et <uicontrol> dans l’exemple que vous avez ajouté, l’utilisateur sait maintenant qu’il doit cliquer sur « Fichier », puis « Nouveau », puis « Tableur ».
    Vous pouvez utiliser l’élément <uicontrol> sans l’élément <menucascade>. Par exemple, vous pouvez marquer un mot avec l’élément <uicontrol> pour indiquer un bouton sur lequel l’utilisateur doit cliquer. Comme l’élément <uicontrol> indique que le texte qu’il entoure aura un style particulier, évitez d’utiliser l’élément <b> ou d’autres éléments de style intégré à l’intérieur de l’élément <uicontrol>.
  6. Après l’élément <menucascade>, ajoutez un nouvel élément introductif <p> suivi d’un élément <dl> tel que présenté dans l’exemple suivant :
    Vidéo : Créer une liste de définition avec DITA
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_elements">
   <title>Nourrir les canetons</title>
   <conbody>
...
</menucascade>
<p>Les canards domestiques sont classés par catégories en fonction de leur poids.
Ces catégories de poids peuvent vous aider à choisir une espèce en fonction de la quantité
dont vous aurez besoin pour nourrir vos canards.</p>
<dl>
</dl>
</conbody>
</concept>

    L’élément <dl> établit le cadre d’une liste de définitions.
  7. À l’intérieur de l’élément <dl>, ajoutez un élément <dlentry> tel que présenté dans l’exemple suivant : 
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_elements">
   <title>Nourrir les canetons</title>
   <conbody>
...
<dl>
 <dlentry>
</dlentry>
...
</conbody>
</concept>

    Chaque élément <dlentry> contient un terme et sa définition. L’élément <dlentry> peut contenir un ou plusieurs éléments <dd>.
  8. À l’intérieur de l’élément <dlentry>, ajoutez les éléments <dt> et <dd> et ajoutez-y du contenu tel que présenté dans l’exemple suivant : 
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_elements">
   <title>Nourrir les canetons</title>
   <conbody>
...
    <dlentry>
    <dt>Nain</dt>
        <dd>Les canards les plus légers et les meilleurs voleurs, comme le canard colvert.</dd>
...
</conbody>
</concept>

    L’élément <dt> contient le terme, et l’élément <dd> contient sa définition.
  9. Après l’élément <dlentry>, ajoutez trois autres éléments <dlentry> et ajoutez-y du contenu à l’aide des éléments <dt> et <dd> tel que présenté dans l’exemple suivant : 
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_elements">
   <title>Nourrir les canetons</title>
  <conbody>
...
    </dlentry>
    <dlentry>
        <dt>Léger</dt>
        <dd>Les deuxièmes canards les plus légers et les meilleures pondeuses, comme
            le canard Khaki Campbell.</dd>
    </dlentry>
    <dlentry>
        <dt>Moyen</dt>
        <dd>Les canards de poids moyen et généralement les plus calmes, comme le canard suédois.</dd>
    </dlentry>
    <dlentry>
        <dt>Lourd</dt>
        <dd>Les canards les plus lourds et généralement les plus amicaux, comme le canard de Pékin.</dd>
    </dlentry>
...
</conbody>
</concept>

  10. Vérifier votre fichier leçon3/l_concept_elements_debut.dita à l’aide du fichier exemple leçon3/l_concept_elements.dita.
Pratique
  1. Ouvrez le fichier leçon3/l_concept_elements_exercice_debut.dita et utilisez-le pour convertir en DITA le contenu suivant :

    Accroître la visibilité des produits

    Le contenu technique peut aider les organisations à accroître la visibilité de leurs produits sur le marché. Officiellement, le contenu technique est destiné aux clients des produits, c’est-à-dire aux personnes qui achètent un produit et qui consultent ensuite la documentation.

    Mais un sondage d’opinion indique qu’environ un tiers des acheteurs1 consultent la documentation avant d’acheter un produit, et que la qualité de la documentation aura une incidence sur leur décision d’achat.

    Pour susciter de nouvelles perspectives, votre contenu doit être performant de trois manières différentes : être consultabe, trouvable et découvrable.

    Consultable
    Les informations doivent être disponibles via une recherche sur internet.
    Trouvable
    L’information doit être performante pour les mots-clés pertinents.
    Découvrable
    L’information doit augmenter la possibilité que les gens établissent un lien avec vos informations.

    Pour en savoir plus, allez sur Contenu > Objectifs commerciaux > Marketing et visibilité du produit > Augmenter la visibilité du produit.

    1 « Sentiments des consommateurs sur la documentation des produits », un sondage d’opinion réalisé en ligne par Sharon Burton

  2. Vérifiez votre fichier leçon3/l_concept_elements_exercice_debut.dita à l’aide du fichier exemple leçon3/l_concept_elements_exercice.dita.
Contributeurs
Chapitre précédent
Retour à la Leçon
Leçon suivante