%general-entities; ]> $LastChangedBy$ $Date$ DocBook XSL Stylesheets-&docbook-xsl-version; DocBook XSL Stylesheets Introduction to <application>DocBook <acronym>XSL</acronym> Stylesheets</application> 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; <application>DocBook <acronym>XSL</acronym> Stylesheets</application> dependencies Required Installation of <application>DocBook <acronym>XSL</acronym> Stylesheets</application> 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 <application>DocBook <acronym>XSL</acronym> Stylesheets</application> 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. Some project stylesheets reference specific versions of XSL stylesheets, like BLFS-6.0, which needs the 1.67.2 version. The following commands can also serve as an example for using a single XSL version to support any hard coded versions, as needed. Ensure you modify the for command below to only include the stylesheet versions you desire (remove references to stylesheet versions you have installed, or plan to install). Issue the following commands as the root user: for XSLVERSION in 1.61.3 1.65.1 1.66.1 1.67.0 1.67.2 1.68.0 do xmlcatalog --noout --add "rewriteSystem" \ "http://docbook.sourceforge.net/release/xsl/$XSLVERSION" \ "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ /etc/xml/catalog xmlcatalog --noout --add "rewriteURI" \ "http://docbook.sourceforge.net/release/xsl/$XSLVERSION" \ "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ /etc/xml/catalog done 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