3. Installation des outils de conversion — OpenJade

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

3.1. Installation d'OpenJade

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 :

  1. Positionnez-vous dans le dossier /tmp/downloads.

    # cd /tmp/downloads
    
  2. Décompressez le fichier.

    # gzip -d openjade-1.3.x.tar.gz
    
  3. Dépaquetez le fichier.

    # tar -xvf openjade-1.3.x.tar
    
  4. Déplacez-vous dans le dossier openjade-1.3

    # cd openjade-1.3.x
    
  5. Exécutez la commande ./configure.

    # ./configure --prefix=/usr/local/dbtools/openjade
    
  6. Exécutez la commande make.

    # make
    
  7. Exécutez la commande make install. Dès maintenant, les fichiers binaires d'OpenJade seront installés sous /usr/local/dbtools/openjade.

    # make install
    
  8. Copiez le dossier dsssl de /tmp/downloads/openjade-1.3.x vers /usr/local/dbtools/openjade.

    # cp -dpR dsssl /usr/local/dbtools/openjade/
    

3.2. Installation du DSSSL de Norman Walsh

Durant cette étape, nous installerons le DSSSL de Norman Walsh dans un endroit approprié. Le DSSSL n'a pas besoin d'être compilé.

  1. Positionnez-vous dans le dossier /tmp/downloads.

    # cd /tmp/downloads
    
  2. Décompressez le fichier.

    # gzip -d docbook-dsssl-1.76.tar.gz
    
  3. Dépaquetez le fichier.

    # tar -xvf docbook-dsssl-1.76.tar
    
  4. Déplacez-vous dans le dossier /usr/local/dbtools/docbook-dsssl.

    # mv docbook-dsssl-1.76 /usr/local/dbtools/docbook-dsssl
    

3.3. Installation des DTD DocBook

Dans cette section, nous installerons les DTD DocBook.

  1. Positionnez-vous dans le dossier /usr/local/dbtools.

    # cd /usr/local/dbtools
    
  2. 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
    
  3. Déplacez-vous dans le dossier dtd3.1.

    # cd dtd3.1
    
  4. Décompressez le fichier DocBook SGML v3.1 dans ce dossier.

    # unzip /tmp/downloads/docbk31.zip
    
  5. Déplacez-vous dans le dossier dtd4.1.

    # cd ../dtd4.1
    
  6. Décompressez le fichier DocBook SGML v4.1 dans ce dossier.

    # unzip /tmp/downloads/docbk41.zip
    
  7. Déplacez-vous dans le dossier dtd4.1.2.

    # cd ../dtd4.1.2
    
  8. Décompressez le fichier DocBook XML v4.1.2 dans ce dossier.

    # unzip /tmp/downloads/docbk412.zip
    

3.4. Installation des entités ISO

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.

  1. Positionnez-vous dans le dossier /usr/local/dbtools/dtd3.1.

    # cd /usr/local/dbtools/dtd3.1
    
  2. Copiez ici le fichier /tmp/download/entities.tar.gz.

    # cp /tmp/download/entities.tar.gz .
    
  3. Décompressez le fichier.

    # gzip -d entities.tar.gz
    
  4. Dépaquetez le fichier.

    # tar -xvf entities.tar
    

Ensuite, nous installons les entités ISO pour la DTD 4.1 SGML.

  1. Positionnez-vous dans le dossier /usr/local/dbtools/dtd4.1.

    # cd /usr/local/dbtools/dtd4.1
    
  2. Copiez ici le fichier /tmp/download/entities.tar.gz.

    # cp /tmp/download/entities.tar.gz .
    
  3. Décompressez le fichier.

    # gzip -d entities.tar.gz
    
  4. Dépaquetez le fichier.

    # tar -xvf entities.tar
    

3.5. Installation du DSL du TLDP

Enfin, nous installons la feuille de style personnalisée du TLDP.

  1. Positionnez-vous dans le dossier /tmp/download.

    # cd /tmp/download
    
  2. Copiez le fichier ldp.dsl à l'emplacement /usr/local/dbtools/docbook-dsssl/print.

    # cp ldp.dsl /usr/local/dbtools/docbook-dsssl/print
    
  3. Copiez le fichier ldp.dsl à l'emplacement /usr/local/dbtools/docbook-dsssl/html.

    # cp ldp.dsl /usr/local/dbtools/docbook-dsssl/html
    
  4. 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>
    ]]>
    

3.6. Installation de HTMLDOC

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