Après avoir expliqué rapidement ce que l'équipe de traduction française avait réussi à faire suite au passage du SGML au XML, j'ai remarqué qu'il me manquait les solutions à deux problèmes pour faire de même avec la documentation originale.

Tout d'abord, la documentation originale comprend des insertions conditionnelles. En effet, le chapitre d'installation est aussi un document spécifique généré pour être inclus dans le package des sources de PostgreSQL. Ce fichier contient le mot document quand il fait partie de la génération du fichier INSTALL et contient le mot chapitre quand il fait partie de la génération complète du manuel. Parfois, ce sont des sections entières qui sont intégrées ou ignorées. Comment faire pour obtenir le même résultat en XML Docbook ? Il existe un moyen simple : les attributs de profile. Il existe des attributs standards comme os. En indiquant <para os="linux">linux-2.6.16</para><para os="windows">Windows XP</para>, vous obtiendrez un paragraphe contenant le texte « linux-2.6.16 » avec le profile os=linux et vous obtiendrez un paragraphe contenant le texte « Windows XP » avec le profile os=windows. Sans profile, vous n'aurez pas de paragraphe. Vous pouvez aussi créer des attributs personnalisés. Comme aucun des standards ne me convenait, j'ai créé un attribut que j'ai ajouté à chaque élément conditionnel. Vous trouverez ici la liste des modifications. J'arrive donc maintenant à générer un document autonome concernant l'installation.

Mon deuxième problème est la génération des pages man. Je n'ai pas encore terminé mais j'ai réussi à générer une page man... pas très belle, mais elle se génère. Toutes les infos sont disponibles ici grâce à l'excellent « Guide complet de Docbook XSL », malheureusement en anglais. Il serait temps qu'il se trouve un traducteur :)