Chapitre 7. DocBook, les premières balises

Table des matières

Structure du document
Structure générale
Différences et points communs entre article et book
Les principales balises de structure
sect1, sect2, sect3, sect4, sect5
para
blockquote
itemizedlist
orderedlist
listitem
Quelques balises d'avertissement
Les principales balises d'information sur le document
Quelques balises génériques
emphasis
ulink
Références bibliographiques pour les différentes balises

Attention

Toutes les balises de DocBook doivent être écrites en minuscules.

Structure du document

Structure générale

Le document XML de base doit contenir au minimum les entêtes XML. Pour commencer, je vous conseille d'utiliser ces lignes (à adapter en fonction de la version utilisée, ici 4.1.2) :

      <?xml version='1.0' encoding="ISO-8859-15" ?>
      <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                     "/usr/share/sgml/docbook/xml-dtd/docbookx.dtd">
            

Cela indique au programme que c'est un document XML version 1.0, utilisant un codage de caractère ISO-8859-15 (europe de l'ouest avec le symbole de l'euro) et la DTD précise que vous allez utiliser.

Il faut ensuite donner le type de document, livre ou article :

                <book lang="fr">
            

ou

                <article lang="fr">
            

Si vous voulez rédiger un article, ne pas oublier de le préciser aussi dans DOCTYPE.

Le document devra bien entendu se terminer par la fermeture de cette première balise (</book> ou </article>).

Différences et points communs entre article et book

La principale différence (en tout cas la plus visible) est la possibilité d'insérer des chapitres (<chapter>) ou une préface (<preface>) dans un book et pas dans un article.

Ils devront cependant tous deux commencer par un titre (balise <title>).