Minuscule mémento Docbook 5

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 🙂

5 commentaires sur « Minuscule mémento Docbook 5 »

  1. Personnellement, je pense que le XML est un outil trés puissant, mais qui a les même problèmes que la programmation Web : quand on commence ça à l’air facile (donc tout le monde pense savoir le faire) mais en réalité c’est un vrai métier. J’ai passé des centaines d’heures sur des problèmes XML mais je ne prétendrai pas être vraiment compétent dans ce domaine.

Laisser un commentaire

Entrez vos coordonnées ci-dessous ou cliquez sur une icône pour vous connecter:

Logo WordPress.com

Vous commentez à l'aide de votre compte WordPress.com. Déconnexion / Changer )

Image Twitter

Vous commentez à l'aide de votre compte Twitter. Déconnexion / Changer )

Photo Facebook

Vous commentez à l'aide de votre compte Facebook. Déconnexion / Changer )

Photo Google+

Vous commentez à l'aide de votre compte Google+. Déconnexion / Changer )

Connexion à %s