#### Beyond Linux® From Scratch (systemd Edition) - Version r13.0-491

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

- Prev

  docbook-xml-5.0

- Next

  docbook-xsl-ns-1.79.2

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

### Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

### 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: https://www.linuxfromscratch.org/patches/blfs/svn/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: 522 KB

### DocBook XSL Stylesheets Dependencies

#### Recommended (at runtime)

libxml2-2.15.3

#### Optional (all used at runtime)

apache-ant-1.10.17 (to produce “webhelp” documents), libxslt-1.1.45 (or any other XSLT processor), to process Docbook documents, Ruby-4.0.3 (to utilize the “epub” stylesheets), Zip-3.0 (to produce “epub3” documents), and Saxon6 and Xerces2 Java (used with apache-ant-1.10.17 to produce “webhelp” documents)

## 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 -svf 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

Create (or append) and populate the XML catalog file using the following commands as the `root` user (both http and https forms are used because upstream have had both in their documentation):

    (set -e

     install -v -d -m755 /etc/xml
     [ -e /etc/xml/catalog ] || xmlcatalog --noout --create /etc/xml/catalog

     for uri in http{,s}://cdn.docbook.org/release/xsl-nons/{1.79.2,current} \
                http://docbook.sourceforge.net/release/xsl/current; do
       for rewrite in System URI; do
         xmlcatalog --noout --add "rewrite$rewrite"             \
           "$uri"                                               \
           "/usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2" \
           /etc/xml/catalog
       done
     done)

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 Files: /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2/*/*.xsl
Installed Directories: /usr/share/xml/docbook/xsl-stylesheets-nons-1.79.2 and /usr/share/doc/docbook-xsl-nons-1.79.2

### Short Descriptions

`XSL Stylesheets` | are used for performing transformations on XML files

- Prev

  docbook-xml-5.0

- Next

  docbook-xsl-ns-1.79.2

- Up
- Home