3.3.2. Les balises ou éléments XML
Ce chapitre rassemble quelques éléments de base de DocBook et explique comment les mettres en oeuvre dans serna-free. Nous verrons aussi comment ces éléments sont encodés en DocBook XML.
Dans serna-free, le menu contextuel peut être activé dans les deux zones d'édition. Il offre un accès à toutes les possibilités d'édition du document.Quand le texte est séléctioné, il est possible de le 'tagguer' et de l'insérer entre deux balises XML.
Mettre en évidence des mots
Un mot peut être mis en évidnce en le mettant en : Gras (bold), italique (italic) ou en le soulignant (underline)
Pour faire ceci, sélectionnez le texte à mettre en évidence dans la zone d'édition puis cliquez sur les boutons de la barre d'outils. Le document sera modifié comme représenté dans la copie d'écran ci-dessous:
Cette image représente le code XML ainsi généré:
<para>A word could be highlighted using enphsis: <emphasis role="bold">Bold</emphasis>, <emphasis role="italic">italic</emphasis>, <emphasis role="underline">underline</emphasis></para>
Un mot peut aussi représenter un fichier (filename), une application, une commande (command), un code, une phrase, un nom de classe (classname)... Il y a de nombreuse possibilités offertes par les références DocBook. Pour mettre en evidence un mot ou une phrase, vos devez le seletionner puis utiliser le menu contextuel
Images
Les images sont des objets spécifiques et doivent être insérées dans des balises <mediaobject> ou <inlinemediaobject> composées par un <imageobject> lui même contenant une <imagedata>.
L'élément <imagedata> contient des attributs accessible depuis le menu contextuel
L'image à afficher est définie par l'attribut fileref. Vous pouvez utiliser la petite icône en forme de dossier jaune pour sélectionner l'image à insérer.
Le code XML ainsi généré ressemblera à ceci:
<mediaobject>
<imageobject>
<imagedata align="center" fileref="images/MediaObject.png"/>
</imageobject>
</mediaobject>
Listes
Deux types de listes existent:<itemizedlist> et <orderedlist>. Pour la première balise, chaque élément de la liste sera précédé par un point. Dans la liste ordonée, chaque élément est précédé par un nombre.
Les élements <itemizedlist> et <orderedlist> représentent les points d'entrées des listes. Ces éléments sont composés de <listitem> qui contiennent l'information à afficher, un <para> dans l'exemple ci dessous:
Le code XML ainsi généré ressemblera à ceci:
<itemizedlist>
<listitem>
<para>Introduction stored into the file <filename>Section-Introduction.xml</filename></para>
</listitem>
<listitem>
<para>Installation stored into the file <filename>Section-Installation.xml</filename></para>
</listitem>
<listitem>
<para>Redaction stored into the file <filename>Section-Redaction.xml</filename></para>
</listitem>
<listitem>
<para>Publication stored into the file <filename>Section-Publication.xml</filename></para>
</listitem>
</itemizedlist>
Dans ce document nous n'utilisons que des <itemizedlist>. La creation de sous-liste peut se faire en insérant un <itemizedlist> ou <orderedlist> dans un <listitem>.
Listing de programme
L'élément <programlisting> permet d'insérer des morceaux de code dans le document. publican offre la possibilité d'effectuer une coloration synthaxique du texte pour rendre le code plus lisible. Pour permettre une coloration synthaxique correcte, il faut définir le langage utilisé. Ce langage sera définit dans l'attribut language. La liste des langages supportés se trouve dans la page suivante:
La première colonne représente les mots clés à ajouter dans l'attribut.
Pour aller plus loin
Des vidéos commentées en anglais expliquant l'utilisation de serna sont disponible ici:
Des recommentations pour écrire un article DocBook sont disponible en anglais ici:
