Cours DocBook accelere

Chapitre 8. Les graphiques

Ci-dessous, le liste des balises concernées :

screeninfo - Information sur la capture d'écran
screenshot - Représentation sur la façon dont l'utilisateur voit une capture d'écran
mediaobject - Une image, un son, un texte qui peut être encodé en différents formats en même temps, non interprété dans le corps du texte
inlinemediaobject - Une image, un son, un texte, qui peut être encodé en différents formats en même temps, sera interprété dans le corps du texte
imagedata - Un des formats d'encodage d'image, comme EPS pour l'impression et JPG pour la mise en ligne

La documentation pour les applications graphiques demandent des captures d'écran, des icônes, des boutons et d'autres éléments graphiques. DocBook possède des balises pour les captures d'écran, les graphiques et les graphiques dans le corps du texte. Les exemples ci-dessous contiennent la même image en tant que capture d'écran et graphique dans le corps du texte.

Exemple 8-1. Un mediaobject dans le corps du texte


<para>
Voici un tas de rectangles
<inlinemediaobject>
<imageobject> <imagedata fileref="rectangles.eps" format="EPS" /> </imageobject>
<imageobject> <imagedata fileref="rectangles.png" format="PNG" /> </imageobject>
<textobject> <phrase>Un tas de rectangles</phrase> </textobject>
</inlinemediaobject>
</para>

La balise <inlinemediaobject> est affichée à côté du texte. L'attribut fileref de la balise <imagedata> contient le nom du fichier graphique, le format contient le type de fichier graphique et l'attribut optionnel align modifie l'alignement du graphique. Converti, l'exemple donne ceci :

Voici un tas de rectangles

Exemple 8-2. Une capture d'écran


<screenshot>
<screeninfo>Colored Rectangles</screeninfo>
<mediaobject>
<imageobject> <imagedata fileref="rectangles.eps" format="EPS" /> </imageobject>
<imageobject> <imagedata fileref="rectangles.png" format="PNG" /> </imageobject>
<textobject> <phrase>A bunch of rectangles</phrase> </textobject>
<caption>
<para>Here are a bunch of rectangles</para>
</caption>
</mediaobject>
</screenshot> 

La balise <screenshot> désigne une capture d'écran avec la balise <screeninfo> qui fournit une description textuelle. Le coeur de la capture d'écran est la balise <mediaobject> qui pointe vers le fichier graphique comme indiqué dans le premier exemple. Une capture d'écran, une fois convertie done ceci :

Here are a bunch of rectangles