Écrire de la documentation en utilisant DocBook: Un cours accéléré
Précédent	Chapitre 2. Les premiers pas	Suivant

2.2. L'ancienne méthode : les DocBook-Tools

Les DocBook-tools consistent en plusieurs paquetages qui fonctionnent ensemble pour convertir des fichiers SGML DocBook dans d'autres formats, et accomplir d'autres opérations. Ces formats comprennent :

HTML
TeX et DVI
PostScript
RTF
PDF
Man pages
TexInfo

Nous avons dit que les DocBook-Tools étaient destinés au SGML DocBook. C'est vrai, mais ils peuvent aussi s'utiliser pour des fichiers XML DocBook.

La page du projet DocBook-Tools est sur http://sources.redhat.com/docbook-tools et les paquetages eux-mêmes peuvent être obtenus depuis ftp://sources.redhat.com/pub/docbook-tools/new-trials/ ou un des mirroirs. Certaines distributions commerciales ont adopté les DocBook-Tools et fournissent leur propres CD.

Les DocBook-Tools comprennent les paquetages suivants :

sgml-common: déclarations SGML de base et outils
jade: moteur de feuilles de style SGML et DSSSL
jadetex: ensemble de macros TeX utilisées par les fichiers générés par Jade
docbook-dtdXX-sgml: DTD SGML DocBook (un paquetage par version de la DTD)
docbook-style-dsssl: Feuilles de style DSSSL de Norman Walsh pour DocBook
perl-SGMLSpm: Interface entre Perl et SGML
docbook-utils: Scripts Shell et utilitaires perl
psgml: Mode majeur pour Emacs pour éditer des fichiers SGML

Nous décrirons seulement la version RPM de ces paquetages. Pour les autres formats vous devrez adapter.

Télécharger les paquetages
Les installer

comme dans l'exemple suivant :

$ ncftp ftp://sources.redhat.com
ncftp> cd pub/docbook-tools/new-trials/RPMS
ncftp> mget i386/*.rpm
ncftp> mget noarch/*.rpm
ncftp> quit
$ su
Password: ultra-sucure
# rpm -ih sgml-common*.rpm
# rpm -ih jade*.rpm
# rpm -ih jadetex*.rpm
# rpm -ih docbook-dtd44-sgml*.rpm
# rpm -ih docbook-style-dsssl*.rpm
# rpm -ih perl-SGMLSpm*.rpm
# rpm -ih docbook-utils*.rpm
# exit

L'ordre d'installation des paquetages est important.

Quand vous faites une mise à jour, au lieu d'installer pour la première fois, l'étape rpm -ih sera remplacée par rpm -Uh.

Vous êtes maintenant prêt pour éditer des documents SGML/DocBook et ensuite les convertir en d'autres formats. Pour ceci vous utiliserez une des commandes suivantes :

docbook2html => HTML
docbook2ps => PostScript
docbook2pdf => PDF
docbook2rtf => Rich Text Format
etc.

Précédent	Sommaire	Suivant
Les premiers pas	Niveau supérieur	La nouvelle méthode : XSLTProc et FOP