Les concepts contiennent des éléments DITA de base, tels que des paragraphes, des listes, des images, des tableaux et bien d’autres. La plupart de ces éléments peuvent également être utilisés dans les autres types de rubrique (tâche et référence). La seule exception est l’élément <conbody>, qui est spécifique au concept.
Au minimum, le concept doit contenir un élément <concept> racine (avec un attribut id) qui contient un élément <title>.
Après l’élément <title> et un élément optionnel <shortdesc> ou <abstract>, l’élément <conbody> contient le concept lui-même.
L’élément <conbody> a un modèle de contenu ouvert. Cela signifie que les éléments contenus dans <conbody> ne sont pas tenus de suivre une séquence stricte. Tant qu’un élément est autorisé à l’intérieur, il peut apparaître dans n’importe quel ordre. Les exceptions sont les éléments <section> et <exemple>, qui ne peuvent être suivis que par d’autres éléments <section> ou <exemple> ou un élément <conbodydiv>.
Vidéo : Créer un concept DITA
Pratique
- Faites une copie du fichier leçon1/l_nouveau_concept_debut.dita et ouvrez-le dans votre éditeur.
Remarque :
Si vous utilisez un éditeur de texte compatible DITA, assurez-vous que vous êtes en mode texte plutôt qu’en mode auteur ou visuel.
Vous devriez voir ceci :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="mon_premier_concept">
<title>xyz</title>
</concept>
La première ligne (qui commence par <?xml) est une déclaration XML, qui est une partie standard de tous les fichiers XML.
La déclaration DOCTYPE sur la deuxième ligne identifie ce fichier comme un concept.
La troisième ligne est la balise d’ouverture de l’élément <concept>, qui utilise l’identifiant unique « mon_premier_concept ».
L’élément <title> sur la quatrième ligne contient le titre de la rubrique.
La cinquième ligne utilise la balise de fermeture </concept> pour montrer où se termine l’élément <concept>.
- À l’intérieur de l’élément <title>, modifiez le texte du titre comme indiqué dans l’exemple suivant.
Remarque :
Lorsque vous travaillez à l’intérieur d’un élément, insérez le contenu entre les balises d’ouverture et de fermeture.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="mon_premier_concept">
<title>Espèces de canards sauvages</title>
</concept>
- Après l’élément <title>, ajoutez un élément <conbody>.
Remarque :
Lors de l’ajout d’un élément après un autre élément, insérer le nouvel élément après la balise de fermeture du premier élément.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="mon_premier_concept">
<title>Espèces de canards sauvages</title>
<conbody>
</conbody>
</concept>
L’élément <conbody> contiendra tout le contenu réel du concept.
Contributeurs
