%general-entities; ]> $LastChangedBy$ $Date$ DocBook XSL Stylesheets-&docbook-xsl-version; DocBook XSL Stylesheets 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 Download (HTTP): Download (FTP): Download MD5 sum: &docbook-xsl-md5sum; Download size: &docbook-xsl-size; Estimated disk space required: &docbook-xsl-buildsize; Estimated build time: &docbook-xsl-time; DocBook XSL Stylesheets Dependencies Required 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-&docbook-xsl-version; && 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-&docbook-xsl-version; && install -v -d -m755 /usr/share/doc/xml && cp -v -af doc/* /usr/share/doc/xml && cd /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; && 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/&docbook-xsl-version;" \ "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ /etc/xml/catalog && xmlcatalog --noout --add "rewriteURI" \ "http://docbook.sourceforge.net/release/xsl/&docbook-xsl-version;" \ "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ /etc/xml/catalog && xmlcatalog --noout --add "rewriteSystem" \ "http://docbook.sourceforge.net/release/xsl/current" \ "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ /etc/xml/catalog && xmlcatalog --noout --add "rewriteURI" \ "http://docbook.sourceforge.net/release/xsl/current" \ "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ /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 /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-&docbook-xsl-version;/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-&docbook-xsl-version;" \ /etc/xml/catalog && xmlcatalog --noout --add "rewriteURI" \ "http://docbook.sourceforge.net/release/xsl/1.67.2" \ "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ /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 Installed Libraries Installed Files Installed Directories None None XSL style sheets for HTML and FO /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; and /usr/share/doc/xml