Cours DocBook accelere

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 :

Note

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.

  1. Télécharger les paquetages

  2. 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

Note

L'ordre d'installation des paquetages est important.

Note

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 :