Dans cette section, nous installerons tous les outils dans les dossiers appropriés. Tous vont dans /usr/local/dbtools/
. Créez ce dossier à l'aide de la commande suivante :
# mkdir /usr/local/dbtools
Cette procédure est la partie la plus facile, mais aussi la plus longue. Gardez à l'esprit que la compilation d'OpenJade demande du temps. Pour installer OpenJade, réalisez les opérations suivantes :
Positionnez-vous dans le dossier /tmp/downloads
.
#
cd /tmp/downloads
Décompressez le fichier.
#
gzip -d openjade-1.3.x.tar.gz
Dépaquetez le fichier.
#
tar -xvf openjade-1.3.x.tar
Déplacez-vous dans le dossier openjade-1.3
#
cd openjade-1.3.x
Exécutez la commande ./configure.
#
./configure --prefix=/usr/local/dbtools/openjade
Exécutez la commande make.
#
make
Exécutez la commande make install. Dès maintenant, les fichiers binaires d'OpenJade seront installés sous /usr/local/dbtools/openjade
.
#
make install
Copiez le dossier dsssl
de /tmp/downloads/openjade-1.3.x
vers /usr/local/dbtools/openjade
.
#
cp -dpR dsssl /usr/local/dbtools/openjade/
Durant cette étape, nous installerons le DSSSL de Norman Walsh dans un endroit approprié. Le DSSSL n'a pas besoin d'être compilé.
Positionnez-vous dans le dossier /tmp/downloads
.
#
cd /tmp/downloads
Décompressez le fichier.
#
gzip -d docbook-dsssl-1.76.tar.gz
Dépaquetez le fichier.
#
tar -xvf docbook-dsssl-1.76.tar
Déplacez-vous dans le dossier /usr/local/dbtools/docbook-dsssl
.
#
mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl
Dans cette section, nous installerons les DTD DocBook.
Positionnez-vous dans le dossier /usr/local/dbtools
.
#
cd /usr/local/dbtools
Créez trois nouveaux dossiers, nommés dtd3.1
, dtd4.1
, et dtd4.1.2
.
#
mkdir dtd3.1#
mkdir dtd4.1#
mkdir dtd4.1.2
Déplacez-vous dans le dossier dtd3.1
.
#
cd dtd3.1
Décompressez le fichier DocBook SGML v3.1 dans ce dossier.
#
unzip /tmp/downloads/docbk31.zip
Déplacez-vous dans le dossier dtd4.1
.
#
cd ../dtd4.1
Décompressez le fichier DocBook SGML v4.1 dans ce dossier.
#
unzip /tmp/downloads/docbk41.zip
Déplacez-vous dans le dossier dtd4.1.2
.
#
cd ../dtd4.1.2
Décompressez le fichier DocBook XML v4.1.2 dans ce dossier.
#
unzip /tmp/downloads/docbk412.zip
Dans cette section, nous installerons les entités ISO que nous avons téléchargées sur le site Internet du TLDP.
Tout d'abord, nous installons les entités ISO pour la DTD 3.1 SGML.
Positionnez-vous dans le dossier /usr/local/dbtools/dtd3.1
.
#
cd /usr/local/dbtools/dtd3.1
Copiez ici le fichier /tmp/download/entities.tar.gz
.
#
cp /tmp/download/entities.tar.gz .
Décompressez le fichier.
#
gzip -d entities.tar.gz
Dépaquetez le fichier.
#
tar -xvf entities.tar
Ensuite, nous installons les entités ISO pour la DTD 4.1 SGML.
Positionnez-vous dans le dossier /usr/local/dbtools/dtd4.1
.
#
cd /usr/local/dbtools/dtd4.1
Copiez ici le fichier /tmp/download/entities.tar.gz
.
#
cp /tmp/download/entities.tar.gz .
Décompressez le fichier.
#
gzip -d entities.tar.gz
Dépaquetez le fichier.
#
tar -xvf entities.tar
Enfin, nous installons la feuille de style personnalisée du TLDP.
Positionnez-vous dans le dossier /tmp/download
.
#
cd /tmp/download
Copiez le fichier ldp.dsl
à l'emplacement /usr/local/dbtools/docbook-dsssl/print
.
#
cp ldp.dsl /usr/local/dbtools/docbook-dsssl/print
Copiez le fichier ldp.dsl
à l'emplacement /usr/local/dbtools/docbook-dsssl/html
.
#
cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html
Le contenu du fichier ldp.dsl
doit être modifié pour refléter le chemin absolu du fichier docbook.dsl
. Voici la zone originale du fichier qui doit être adaptée :
<![%html;[ <!ENTITY % print "IGNORE"> <!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA dsssl> ]]> <!ENTITY % print "INCLUDE"> <![%print;[ <!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA dsssl> ]]>
Éditez le fichier ldp.dsl
situé à l'emplacement /usr/local/dbtools/docbook-dsssl/print
avec un éditeur de texte.
#
emacs /usr/local/dbtools/docbook-dsssl/print/ldp.dsl
Modifiez le contenu du fichier comme suit :
<![%html;[ <!ENTITY % print "IGNORE"> <!ENTITY docbook.dsl SYSTEM "/usr/local/dbtools/docbook-dsssl/print/docbook.dsl" CDATA dsssl> ]]> <!ENTITY % print "INCLUDE"> <![%print;[ <!ENTITY docbook.dsl SYSTEM "/usr/local/dbtools/docbook-dsssl/print/docbook.dsl" CDATA dsssl> ]]>
Éditez le fichier ldp.dsl
situé à l'emplacement /usr/local/dbtools/docbook-dsssl/html
avec un éditeur de texte.
#
emacs /usr/local/dbtools/docbook-dsssl/html/ldp.dsl
Modifiez le contenu du fichier comme suit :
<![%html;[ <!ENTITY % print "IGNORE"> <!ENTITY docbook.dsl SYSTEM "/usr/local/dbtools/docbook-dsssl/html/docbook.dsl" CDATA dsssl> ]]> <!ENTITY % print "INCLUDE"> <![%print;[ <!ENTITY docbook.dsl SYSTEM "/usr/local/dbtools/docbook-dsssl/html/docbook.dsl" CDATA dsssl> ]]>
Cette étape est facultative. Elle est utile seulement si vous désirez créer des documents PDF à partir de HTML.
Retournez dans le dossier des téléchargements.
#
cd /tmp/download
Décompressez et dépaquetez le code source de HTMLDOC.
#
gzip -d htmldoc-1.8.xx-source.tar.gz#
tar -xvf htmldoc-1.8.xx-source.tar#
cd htmldoc-1.8.xx-1
Exécutez configure pour définir le chemin d'installation.
#
./configure --prefix=/usr/local/dbtools/htmldoc#
make
Lors de la rédaction de ce document, HTMLDOC version 1.8.20-1 était disponible. Cette version connaît un problème de fontes dans le fichier Makefile
. Il devrait se plaindre à l'installation des fontes, parce qu'elles ne sont pas disponibles sur le système.
Voici l'erreur obtenue lorsque vous exécuterez make install :
#
make install
Making all in htmldoc...
Making all in doc...
Installing in fonts...
Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts...
/bin/cp: cannot stat `ZapfChancery.afm': No such file or directory
/bin/cp: cannot stat `ZapfChancery.pfa': No such file or directory
/bin/cp: cannot stat `ZapfDingbats.afm': No such file or directory
/bin/cp: cannot stat `ZapfDingbats.pfa': No such file or directory
make[1]: *** [install] Error 1
Pour corriger ce problème d'installation, éditez le fichier fonts/Makefile
et mettez en commentaires les lignes référencées aux fontes ZapfChancery et ZapfDingbats.
Ensuite, exécutez l'installation :
#
make install
Making all in htmldoc...
Making all in doc...
Installing in fonts...
Installing font files in /usr/local/dbtools/htmldoc/share/htmldoc/fonts...
Installing in data...
Installing in doc...
Installing in htmldoc...