docbook-dsssl-1.79

Introduction à DocBook DSSSL Stylesheets

Le paquet DocBook DSSSL Stylesheets contient des feuilles de style DSSSL. Elles sont utilisées par OpenJade ou par d'autres outils pour transformer des fichiers SGML et DocBook XML.

This package is known to build and work properly using an LFS 12.1 platform.

Informations sur le paquet

Téléchargements supplémentaires

Documentation et données de test

Dépendances de DocBook DSSSL Stylesheets

Requises

sgml-common-0.6.3

Requises (pour tester l'ensemble d'outils DocBook SGML)

docbook-3.1-dtd, docbook-4.5-dtd, OpenSP-1.5.2 et OpenJade-1.3.2

Installation de DocBook DSSSL Stylesheets

Si vous avez téléchargé la documentation, lancez :

tar -xf ../docbook-dsssl-doc-1.79.tar.bz2 --strip-components=1

Installez DocBook DSSSL Stylesheets en exécutant les commandes suivantes en tant qu'utilisateur root :

install -v -m755 bin/collateindex.pl /usr/bin                      &&
install -v -m644 bin/collateindex.pl.1 /usr/share/man/man1         &&
install -v -d -m755 /usr/share/sgml/docbook/dsssl-stylesheets-1.79 &&
cp -v -R * /usr/share/sgml/docbook/dsssl-stylesheets-1.79          &&

install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
    /usr/share/sgml/docbook/dsssl-stylesheets-1.79/catalog         &&

install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
    /usr/share/sgml/docbook/dsssl-stylesheets-1.79/common/catalog  &&

install-catalog --add /etc/sgml/sgml-docbook.cat              \
    /etc/sgml/dsssl-docbook-stylesheets.cat

Explication des commandes

Les commandes ci-dessus créent un script d'installation pour ce paquet.

Tester l'ensemble d'outils DocBook SGML (facultatif)

Les commandes suivantes effectueront les tests nécessaires pour confirmer que l'ensemble d'outils DocBook SGML installé produira les résultats désirés. Vous devez avoir installé les paquets docbook-3.1-dtd, docbook-4.5-dtd, OpenSP-1.5.2 et OpenJade-1.3.2 et effectuer les tests en tant qu'utilisateur root.

Tous les tests seront effectués à partir du répertoire /usr/share/sgml/docbook/dsssl-stylesheets-1.79/doc/testdata en tant qu'utilisateur root :

cd /usr/share/sgml/docbook/dsssl-stylesheets-1.79/doc/testdata

Le premier test ne devrait donner aucun résultat sur la sortie standard (votre écran) et créer un fichier nommé jtest.rtf dans le répertoire actuel :

openjade -t rtf -d jtest.dsl jtest.sgm

Le test suivant ne devrait renvoyer que la ligne suivante sur la sortie standard onsgmls:I: "OpenSP" version "1.5.2"

onsgmls -sv test.sgm

Le test suivant ne devrait donner aucun résultat sur la sortie standard et créer un fichier nommé test.rtf dans le répertoire actuel :

openjade -t rtf \
    -d /usr/share/sgml/docbook/dsssl-stylesheets-1.79/print/docbook.dsl \
    test.sgm

Le dernier test ne devrait donner aucun résultat sur la sortie standard et créer un fichier nommé c1.htm dans le répertoire actuel :

openjade -t sgml \
    -d /usr/share/sgml/docbook/dsssl-stylesheets-1.79/html/docbook.dsl \
    test.sgm

Enfin, faites le ménage :

rm jtest.rtf test.rtf c1.htm

Contenu

Programme installé: collateindex.pl
Bibliothèques installées: Aucune
Fichiers installés: DSSSL stylesheets
Répertoire installé: /usr/share/sgml/docbook/dsssl-stylesheets-1.79

Descriptions courtes

collateindex.pl

est un script Perl qui crée un index DocBook à partir de données d'index raw