docbook-dsssl-1.78

Introduction to docbook-dsssl

Download location (HTTP):       http://telia.dl.sourceforge.net/sourceforge/docbook/docbook-dsssl-1.78.tar.gz
Download location (FTP):        
Version used:                   1.78
Package size:                   384 KB
Estimated Disk space required:  4 MB

The docbook-dsssl package contains dsssl stylesheets. These are used by openjade or other tools to transform SGML and XML DocBook files.

Installation of docbook-dsssl

Install docbook-dsssl by running the following commands:

mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-1.78/dtds/decls &&
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-1.78/lib &&
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-1.78/common &&
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-1.78/html &&
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-1.78/print &&
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-1.78/test &&
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-1.78/images &&
install bin/collateindex.pl /usr/bin &&
cp catalog VERSION /usr/share/sgml/docbook/dsssl-stylesheets-1.78 &&
cp dtds/decls/*.dcl \
/usr/share/sgml/docbook/dsssl-stylesheets-1.78/dtds/decls &&
cp lib/dblib.dsl /usr/share/sgml/docbook/dsssl-stylesheets-1.78/lib &&
cp common/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-1.78/common &&
cp common/*.ent /usr/share/sgml/docbook/dsssl-stylesheets-1.78/common &&
cp html/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-1.78/html &&
cp lib/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-1.78/lib &&
cp print/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-1.78/print &&
cp images/*.gif /usr/share/sgml/docbook/dsssl-stylesheets-1.78/images &&
install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
/usr/share/sgml/docbook/dsssl-stylesheets-1.78/catalog &&
install-catalog --add /etc/sgml/sgml-docbook.cat \
/etc/sgml/dsssl-docbook-stylesheets.cat

Command explanations

These commands create a make install script for this package.

Configuring docbook-dsssl

Configuration Information

The following configuration is necessary in order to utilize openjade to convert the BLFS Book from XML to HTML:
ln -sf {your home directory}/BLFS/BOOK/blfs.dsl \
/usr/share/sgml/docbook/dsssl-stylesheets-1.78/html/

If you would like to test xml-dtd, dsssl-stylesheets and openjade against the BLFS book, use the following command. The commands are written for a cvs checkout to your home directory with output going to the present working directory, so make any necessary modifications for your setup.
mkdir introduction postlfs general connect basicnet server \
content x kde gnome xsoft multimedia pst preface appendices other &&
openjade -t sgml \
-d /usr/share/sgml/docbook/dsssl-stylesheets-1.78/html/blfs.dsl \
/usr/share/sgml/docbook/dsssl-stylesheets-1.78/dtds/decls/xml.dcl \
~/BLFS/BOOK/index.xml
If successful you should have a HTML BLFS book in exactly the same format as presented on the web page.

Contents

The docbook-dsssl package contains dsssl-stylesheets and collateindex.pl.

Description

collateindex.pl

collateindex.pl is a pearl script that creates a DocBook index from raw index data.