DocBook XSL Stylesheets-1.68.1

Introduction to DocBook XSL Stylesheets

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

Package Information

DocBook XSL Stylesheets Dependencies

Required

libxslt-1.1.14

Installation of DocBook XSL Stylesheets

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

install -v -d -m755 /usr/share/xml/docbook/xsl-stylesheets-1.68.1 &&
install -v -d -m755 /etc/xml &&
chown -R root:root . &&
cp -v -af INSTALL VERSION common eclipse extensions fo html htmlhelp \
    images javahelp lib manpages params profiling template xhtml \
    /usr/share/xml/docbook/xsl-stylesheets-1.68.1 &&
install -v -d -m755 /usr/share/doc/xml &&
cp -v -af doc/* /usr/share/doc/xml &&
cd /usr/share/xml/docbook/xsl-stylesheets-1.68.1 &&
sh INSTALL

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

if [ ! -f /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi &&
if [ ! -f /etc/xml/docbook ]; then
    xmlcatalog --noout --create /etc/xml/docbook
fi &&
xmlcatalog --noout --add "rewriteSystem" \
    "http://docbook.sourceforge.net/release/xsl/1.68.1" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.68.1" \
    /etc/xml/catalog &&
xmlcatalog --noout --add "rewriteURI" \
    "http://docbook.sourceforge.net/release/xsl/1.68.1" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.68.1" \
    /etc/xml/catalog &&
xmlcatalog --noout --add "rewriteSystem" \
    "http://docbook.sourceforge.net/release/xsl/current" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.68.1" \
    /etc/xml/catalog &&
xmlcatalog --noout --add "rewriteURI" \
    "http://docbook.sourceforge.net/release/xsl/current" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.68.1" \
    /etc/xml/catalog &&
xmlcatalog --noout --add "delegateSystem" \
    "http://docbook.sourceforge.net/release/xsl/" \
    "file:///etc/xml/docbook" \
    /etc/xml/catalog &&
xmlcatalog --noout --add "delegateURI" \
    "http://docbook.sourceforge.net/release/xsl/" \
    "file:///etc/xml/docbook" \
    /etc/xml/catalog

Command Explanations

sh INSTALL: This command creates a local catalog for the XSL files.

Configuring DocBook XSL Stylesheets

Config Files

/etc/xml/catalog

Configuration Information

The system profile needs to be updated to utilize the new installed catalog. This can be done with the following command:

cat > /etc/profile.d/xsl.sh << "EOF"
# Set up Environment Variable for XSL Processing
export XML_CATALOG_FILES="/usr/share/xml/docbook/\
xsl-stylesheets-1.68.1/catalog.xml /etc/xml/catalog"
EOF

The above installation script creates the files and updates the catalog with the current version of the XML stylesheets. Some project stylesheets reference specific versions of XSL stylesheets, like BLFS-6.0, which needs the 1.67.2 version. The following commands can serve as an example for using a single XSL version to support any hard coded versions, as needed. Use the following as an example to use the current version of the stylesheets for the 1.67.2 version. Edit or add to the commands to suit your particular needs. Issue the commands as the root user:

xmlcatalog --noout --add "rewriteSystem" \
    "http://docbook.sourceforge.net/release/xsl/1.67.2" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.68.1" \
    /etc/xml/catalog &&
xmlcatalog --noout --add "rewriteURI" \
    "http://docbook.sourceforge.net/release/xsl/1.67.2" \
    "/usr/share/xml/docbook/xsl-stylesheets-1.68.1" \
    /etc/xml/catalog

Alternatively, other versions can be installed in their own versioned directories and catalog entries made in the following form:

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 Files: XSL style sheets for HTML and FO
Installed Directories: /usr/share/xml/docbook/xsl-stylesheets-1.68.1 and /usr/share/doc/xml

Last updated on 2005-08-01 13:29:19 -0600