Je me suis intéressée ces derniers jours à l’évolution de Docbook en Docbook 5… Voici quelques notes qui n’ont aucune valeur à part un mémento personnel, mais si d’autres arrivent à se retrouver dans ma prose, pourquoi pas.

Primo les outils, pour la validation et la transformation HTML :

 java -jar jing.jar docbook.rng chrome.xml java -jar saxon9.jar -o XXX.html XXX.xml docbook-xsl2-snapshot/base/html/docbook.xsl 

D’autre part, quelques remarques de balisage. Il faut apparemment passer ce genre de trucs dans la déclaration :

 <book xmlns="http://docbook.org/ns/docbook"       xmlns:xlink="http://www.w3.org/1999/xlink"> 

Le premier xmlns est le docbook lui-même, le 2e est pour pouvoir utiliser l’espace de nommage xlink (Ouais, parce que DB5 a apparemment introduit des espaces de nommage, c’est bien, ça alourdit encore la syntaxe qui est pas des plus légères à la base déjà… Enfin, ça doit avoir un intérêt profond).

La syntaxe d’un lien hypertexte devient un truc de ce goût-là :

 <link xlink:href="http://XXX">le lien ici</link>. 

La balise <graphic> est supprimée, pour ajouter une image il faut maintenant passer par des <mediaobject>

 <figure xml:id="fig.mafigurel">   <title>Titre de ma super figure</title>   <mediaobject>     <imageobject>       <imagedata fileref="figure.png"/>     </imageobject>   </mediaobject> </figure> 

On notera au passage l’apparition du xml: devant id dans la figure. Par ailleurs, il semble que le valideur soit plus trop copain avec les deux-points dans les id, un problème de confusion avec la syntaxe des namespaces je suppose.

Je n’ai pas encore rencontré dans mon usage d’autre modification profonde du bidule ; pour plus d’informations, je vous invite à vous reporter au site officiel de Docbook, ainsi qu’à la version en cours d’écriture du canard, soit le DocBook 5.0, the definitive guide et au Transition Guide. Si je tombe sur d’autres subtilités, j’essaierai de re-poster ici.

Et un jour, je pigerai tout ce b*** de namespaces XML, de RNG, de DTD, de schémas, de… bref 🙂