Ok, donc vous avez tlcharg le source XML. Et maintenant, que faire ?
Vous allez probablement vouloir convertir ces fichiers XML en des fichiers
plus faciles  lire comme le HTML, le PS, le PDF, le TXT ou d'autres encore.
Tout ceci est indiqu plus bas.

Commenons par tlcharger quelques logiciels.

Si tout ce que vous souhaitez est de convertir le XML en HTML, tlchargez ce
qui suit :

OpenJade                  - http://openjade.sourceforge.net/
DocBook-XML DTD           - http://www.docbook.org/xml/4.1.2/
Modified DocBook Entities - 
	http://linuxfromscratch.org/~gerard/docbook-4.1.2-newent.tar.bz2
DSSSL DocBook Stylesheets - http://www.nwalsh.com/docbook/dsssl/

Comme la DTD DocBook et les feuilles de style sont disponibles en tant qu'archives
zip, vous aurez aussi besoin de tlcharger le paquetage unzip si votre systme
Linux n'en dispose pas encore :

Unzip                     - ftp://ftp.uu.net/pub/archiving/zip/src/

Si vous voulez convertir le livre en PS et PDF, je recommande d'utiliser le
programme Htmldoc. Il prend un fichier HTML (cr avec openjade que vous avez
dj tlcharg) et le convertit en PS ou PDF :

HTMLDOC                   - http://www.easysw.com/htmldoc/
FLTK (interface X)        - http://sourceforge.net/projects/fltk

Si vous voulez tre capable de convertir le livre en TXT, je vous recommande
d'utiliser lynx pour convertir le HTML en TXT avec l'option -dump de lynx.

Lynx					  - http://lynx.browser.org

Vous avez maintenant tout le ncessaire. Installons tout a.

Crez le rpertoire /usr/share/docbook, allez-y et dballez-y l'archive DTD
docbook-xml. Dplacez tous les fichiers et rpertoires  partir du nouveau
sous-rpertoire cr dans le rpertoire actuel (/usr/share/docbook). Nous
n'avons pas rellement besoin d'un sous-rpertoire
/usr/share/docbook/docbook-<version>.

Supprimez le rpertoire ent et dballez le fichier docbook-4.1.2-newent.tar.bz2.
Ceci crera un nouveau rpertoire ent avec les fichiers d'entits qui
fonctionneront mieux avec XML.

Crez le rpertoire /usr/share/dsssl, allez-y et dballez-y l'archive des feuilles
de style dsssl. Renommez le rpertoire qui a t cr par tar par
'docbook'. Maintenant, crez un lien symbolique vers le fichier blfs.dsl que vous
trouverez dans l'archive BLFS-BOOK XML, dans /usr/share/dsssl/docbook/html

La dernire tape concerne l'installation d'OpenJade.

Pour qu'openjade puisse convertir des documents bass sur DocBook vers
d'autres formats, il a besoin de savoir o les fichiers relatifs  la
DTD DocBook sont situs. C'est une sorte d'quivalent DocBook de la
variable $PATH . Vous avez deux moyens pour ce faire :

1) Vous pouvez initialiser la variable $SGML_CATALOG_FILES avec les chemins
complets vers les fichiers catalogues.
   ou
2) Vous pouvez coder en dur les chemins dans le binaire openjade.

Si vous choisissez l'option 1, ajoutez ce qui suit dans votre fichier de
configuration bash, que ce soit le profile systme ou un autre fichier :

export SGML_CATALOG_FILES=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog

Suivi des instructions pour l'installation d'openjade :
	./configure --prefix=/usr
	make
	make install
	cp -av dsssl /usr/share/dsssl/openjade

Si vous choisissez l'option 2, installez OpenJade ainsi :

	./configure --prefix=/usr \
	 --enable-default-catalog=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog
	make
	make install
	cp -av dsssl /usr/share/dsssl/openjade

Et vous n'avez pas besoin de vous inquitez de la variable $SGML_CATALOG_FILES
dans ce cas.

Vous tes fin prt pour convertir du XML en HTML (en plus d'autres formats
supports par openjade). Si vous voulez aussi convertir en PS et PDF, installez
les deux paquetages suivants.

FLTK (vous pouvez laisser celui-ci si vous ne souhaitez pas avoir d'interface X) :
	./configure --prefix=/usr
	make
	make install

HTMLDOC:
Installez-le en lanant :

	./configure --prefix=/usr
	make
	make install

Le dernier paquetage est Lynx, utilis pour la conversion HTML vers TXT.
Installez-le en lanant :

	./configure --prefix=/usr
	make
	make install

Maintenant, tout est configur. Retournez dans le fichier README pour quelques
exemples de convertion d'XML vers d'autres formats.
