#### Beyond Linux® From Scratch (System V Edition) - Version 12.3

### Chapter 48. Standard Generalized Markup Language (SGML)

- Prev

  OpenJade-1.3.2

- Next

  DocBook-utils-0.6.14

- Up
- Home

# docbook-dsssl-1.79

## Introduction to DocBook DSSSL Stylesheets

The DocBook DSSSL Stylesheets package contains DSSSL stylesheets. These are used by OpenJade or other tools to transform SGML and XML DocBook files.

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

### Package Information

- Download (HTTP): https://downloads.sourceforge.net/docbook/docbook-dsssl-1.79.tar.bz2

- Download (FTP):

- Download MD5 sum: bc192d23266b9a664ca0aba4a7794c7c

- Download size: 277 KB

- Estimated disk space required: 14 MB

- Estimated build time: less than 0.1 SBU

### Additional Downloads

Documentation and test data

- Download (HTTP): https://downloads.sourceforge.net/docbook/docbook-dsssl-doc-1.79.tar.bz2

- Download MD5 sum: 9a7b809a21ab7d2749bb328334c380f2

- Download size: 142 KB

### DocBook DSSSL Stylesheets Dependencies

#### Required

sgml-common-0.6.3

#### Required (to Test the DocBook SGML Toolchain)

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

## Installation of DocBook DSSSL Stylesheets

If you downloaded the documentation, run:

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

Install DocBook DSSSL Stylesheets by running the following commands as the `root` user:

    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

## Command Explanations

The above commands create an installation script for this package.

## Testing the DocBook SGML Toolchain (Optional)

The following commands will perform the necessary tests to confirm that your installed DocBook SGML toolchain will produce desired results. You must have the docbook-3.1-dtd, docbook-4.5-dtd, OpenSP-1.5.2, and OpenJade-1.3.2 packages installed, and perform the tests as the `root` user.

All tests will be performed from the `/usr/share/sgml/docbook/dsssl-stylesheets-1.79/doc/testdata` directory as the `root` user:

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

The first test should produce no output to stdout (your screen) and create a file named `jtest.rtf` in the current directory:

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

The next test should return only the following line to stdout: `onsgmls:I: "OpenSP" version "1.5.2"`

    onsgmls -sv test.sgm

The next test should produce no output to stdout and create a file named `test.rtf` in the current directory:

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

The last test should produce no output to stdout and create a file named `c1.htm` in the current directory:

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

Finally, clean up:

    rm jtest.rtf test.rtf c1.htm

## Contents

Installed Program: collateindex.pl
Installed Libraries: None
Installed Files: DSSSL stylesheets
Installed Directory: /usr/share/sgml/docbook/dsssl-stylesheets-1.79

### Short Descriptions

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

- Prev

  OpenJade-1.3.2

- Next

  DocBook-utils-0.6.14

- Up
- Home