Créer une rubrique dans un éditeur de texte

Les fichiers DITA sont au format XML et XML est du texte clair. Par conséquent, vous pouvez créer un fichier XML dans n’importe quel éditeur de texte.

Une rubrique DITA de base nécessite une déclaration XML, une déclaration DOCTYPE, un topic, un attribut id sur le topic et un titre. C’est tout.

Voici une rubrique minimale valide :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic id="mapremiererubrique">
  <title>Bonjour le monde</title>
</topic>

Cette rubrique est valide, mais elle n’est pas particulièrement utile car elle n’a aucun corps de contenu. Pour rendre une rubrique utile, vous avez besoin de quelque chose qui ressemble plus à ceci :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic id="mapremiererubrique">
  <title>Bonjour le monde</title>
<body>
  <p>Voici un paragraphe</p>
  <ul>
    <li>les listes à puces sont sympas</li>
    <li>surtout si vous avez au moins deux points</li>
  </ul>
  <note>Et n'oubliez pas les notes.</note>
</body>
</topic>
Contributeurs