Utilisation

Personnellement j'utilise XEmacs avec le mode psgml pour écrire mes documents. Une fois le document écrit il vous suffit de le transformer. Si vous avez installé stylesheet vous avez a votre disposition de petit script qui font tout pour vous.

Tableau 13-1. Script de conversion

Si vous n'avez pas installé stylesheet il faut le faire a la main avec jade. Ou bien vous pouvez utiliser des scripts que j'ai retravaille avec les stylesheet trouvé sur le site web de Norman Walsh. Vous avez la version en .tar.gz ou bien la version en RPM. Les scripts commences tous par dbkx2????.

Structure d'un document DocBook avec XEmacs

Un document DocBook doit toujours commencer par la déclaration de la DTD, ceci permet à XEmacs de vous présenter un menu contextuel avec tous les tags à votre disposition à l'endroit ou vous êtes dans votre document.

Exemple 13-1. Exemple de document DocBook

<?xml version="1.0" standalone="no"?>

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.1beta1//EN"
  "file:///usr/local/opt/docbookx/dtd/docbookx.dtd" [
<!ENTITY bp "Benjamin POUSSIN">
]>

<book>
...
</book>

Utilisation de jade

Exemple 13-2. Tableau des paramètre pour la génération avec jade

        Sortie désirée    Backend    Style    Options
	rtf               rtf        print    -V rtf-backend
	tex               tex        print    -V tex-backend -i tex
	html              sgml       htmlweb  -i html
	javahelp          sgml       help     -i help
          

Si je souhaite une sortie html du document je peux utiliser la commande suivante jade -t sgml -ihtml -d /path/to/docbook/html/docbook.dsl mon_document.sgml