Dans l'écriture d'un document DocBook il y a deux étapes bien distinctes :
l'écriture proprement dite du texte XML, en respectant la DTD de DocBook ;
la transformation de ce texte en un document lisible par un humain moyen (PDF, HTML, etc.)
Les deux principales difficultés sont sans doute de devoir respecter la syntaxe de XML et la DTD de DocBook.
On essaiera de réduire ces deux difficultés en utilisant un éditeur de texte performant, particulièrement bien étudié pour la création de textes XML : Quanta (voir la section qui lui est consacrée dans la Bibliographie).
Une autre difficulté sera sans doute pour certains de devoir respecter les règles de typographie française. Si vous n'êtes pas très à l'aise avec ces règles, vous trouverez quelques liens vers de saines lectures dans la Bibliographie.
Il faudra cependant en connaître d'abord un minimum, afin de savoir ce qu'on peut faire et ce qui est interdit... Le manuel DocBook vous donnera une liste exhaustive des balises utilisables.
Ces difficultés sont surtout d'ordre informatique (c'est-à-dire techniques). Nous donnerons quelques recettes, mais il faut se souvenir que le but de ce cours est de vous sensibiliser à la nécessité de séparer la structure de la présentation, et non pas de « vous apprendre DocBook ».