docbook-xsl-nons-1.79.2

#### Beyond Linux® From Scratch (systemd Edition) - Version 9.0

### Chapter 49. Extensible Markup Language (XML)

- Prev

  docbook-xml-4.5

- Next

  itstool-2.0.6

- Up
- Home

# docbook-xsl-nons-1.79.2

## Introduction to DocBook XSL Stylesheets

The DocBook XSL Stylesheets package contains XSL stylesheets. These are useful for performing transformations on XML DocBook files.

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

### Package Information

- Download (HTTP): https://github.com/docbook/xslt10-stylesheets/releases/download/release/1.79.2/docbook-xsl-nons-1.79.2.tar.bz2

- Download MD5 sum: 2666d1488d6ced1551d15f31d7ed8c38

- Download size: 22 MB

- Estimated disk space required: 58 MB (includes installing optional documentation)

- Estimated build time: less than 0.1 SBU

### Additional Downloads

- Required patch: http://www.linuxfromscratch.org/patches/blfs/9.0/docbook-xsl-nons-1.79.2-stack_fix-1.patch

Optional documentation

- Download (HTTP): https://github.com/docbook/xslt10-stylesheets/releases/download/release/1.79.2/docbook-xsl-doc-1.79.2.tar.bz2

- Download MD5 sum: 62375ca864fc198cb2b17d98209d0b8c

- Download size: 1.0 MB

### DocBook XSL Stylesheets Dependencies

#### Recommended (at runtime)

libxml2-2.9.9

#### Optional (all used at runtime)

apache-ant-1.10.6 (to produce “webhelp” documents), libxslt-1.1.33 (or any other XSLT processor), to process Docbook documents - the Python2 modules libxml2 and libxslt can be used, Python-2.7.16 (at runtime), Ruby-2.6.4 (to utilize the “epub” stylesheets), Zip-3.0 (to produce “epub3” documents), and Saxon6 and Xerces2 Java (used with apache-ant-1.10.6 to produce “webhelp” documents)

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/docbook-xsl

## Installation of DocBook XSL Stylesheets

First, fix a problem that causes stack overflows when doing recursion:

    patch -Np1 -i ../docbook-xsl-nons-1.79.2-stack_fix-1.patch

If you downloaded the optional documentation tarball, unpack it with the following command:

    tar -xf ../docbook-xsl-doc-1.79.2.tar.bz2 --strip-components=1

BLFS does not install the required packages to run the test suite and provide meaningful results.

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

    install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 &&

    cp -v -R VERSION assembly common eclipse epub epub3 extensions fo        \
             highlighting html htmlhelp images javahelp lib manpages params  \
             profiling roundtrip slides template tests tools webhelp website \
             xhtml xhtml-1_1 xhtml5                                          \
        /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 &&

    ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2/VERSION.xsl &&

    install -v -m644 -D README \
                        /usr/share/doc/docbook-xsl-nons-1.79.2/README.txt &&
    install -v -m644    RELEASE-NOTES* NEWS* \
                        /usr/share/doc/docbook-xsl-nons-1.79.2

If you downloaded the optional documentation tarball, install the documentation by issuing the following command as the `root` user:

    cp -v -R doc/* /usr/share/doc/docbook-xsl-nons-1.79.2

## Configuring DocBook XSL Stylesheets

### Config Files

`/etc/xml/catalog`

### Configuration Information

### Note

If you are installing the current version of docbook-xsl-nons over a previous version of docbook-xsl, then remove the old rewrite entries in the catalog as the `root` user:

    sed -i '/rewrite/d' /etc/xml/catalog

Create (or append) and populate the XML catalog file using the following commands as the `root` user:

    if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &&
    if [ ! -f /etc/xml/catalog ]; then
        xmlcatalog --noout --create /etc/xml/catalog
    fi &&

    xmlcatalog --noout --add "rewriteSystem" \
               "https://cdn.docbook.org/release/xsl-nons/1.79.2" \
               "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
        /etc/xml/catalog &&

    xmlcatalog --noout --add "rewriteURI" \
               "https://cdn.docbook.org/release/xsl-nons/1.79.2" \
               "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
        /etc/xml/catalog &&

    xmlcatalog --noout --add "rewriteSystem" \
               "https://cdn.docbook.org/release/xsl-nons/current" \
               "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
        /etc/xml/catalog &&

    xmlcatalog --noout --add "rewriteURI" \
               "https://cdn.docbook.org/release/xsl-nons/current" \
               "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
        /etc/xml/catalog &&

    xmlcatalog --noout --add "rewriteSystem" \
               "http://docbook.sourceforge.net/release/xsl/current" \
               "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
        /etc/xml/catalog &&

    xmlcatalog --noout --add "rewriteURI" \
               "http://docbook.sourceforge.net/release/xsl/current" \
               "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
        /etc/xml/catalog

Occasionally, you may find the need to install other versions of the XSL stylesheets as some projects reference a specific version. One example is BLFS-6.0, which required the 1.67.2 version. In these instances you should install any other required version in its own versioned directory and create catalog entries as follows (substitute the desired version number for `<version>`):

    xmlcatalog --noout --add "rewriteSystem" \
               "http://docbook.sourceforge.net/release/xsl/<version>" \
               "/usr/share/xml/docbook/xsl-stylesheets-<version>" \
        /etc/xml/catalog &&

    xmlcatalog --noout --add "rewriteURI" \
               "http://docbook.sourceforge.net/release/xsl/<version>" \
               "/usr/share/xml/docbook/xsl-stylesheets-<version>" \
        /etc/xml/catalog

## Contents

Installed Programs: None
Installed Libraries: None
Installed Directories: /usr/share/xml/docbook/xsl-stylesheets-1.79.2 and /usr/share/doc/docbook-xsl-1.79.2

Last updated on 2019-08-16 15:28:01 -0700

- Prev

  docbook-xml-4.5

- Next

  itstool-2.0.6

- Up
- Home