%general-entities; ]> $Date$ docbook-xsl-nons-&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. &lfs111_checked; 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; Additional Downloads Required patch: Optional documentation Download (HTTP): Download MD5 sum: &docbook-xsl-doc-md5sum; Download size: &docbook-xsl-doc-size; DocBook XSL Stylesheets Dependencies Recommended (at runtime) Optional (all used at runtime) (to produce webhelp documents), (or any other XSLT processor), to process Docbook documents - the Python2 modules libxml2 and libxslt can be used, (at runtime), (to utilize the epub stylesheets), (to produce epub3 documents), and Saxon6 and Xerces2 Java (used with to produce webhelp documents) User Notes: Installation of DocBook XSL Stylesheets First, fix a problem that causes stack overflows when doing recursion: patch -Np1 -i ../docbook-xsl-nons-&docbook-xsl-version;-stack_fix-1.patch If you downloaded the optional documentation tarball, unpack it with the following command: tar -xf ../docbook-xsl-doc-&docbook-xsl-version;.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-&docbook-xsl-version; && 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-&docbook-xsl-version; && ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;/VERSION.xsl && install -v -m644 -D README \ /usr/share/doc/docbook-xsl-nons-&docbook-xsl-version;/README.txt && install -v -m644 RELEASE-NOTES* NEWS* \ /usr/share/doc/docbook-xsl-nons-&docbook-xsl-version; 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-&docbook-xsl-version; Configuring DocBook XSL Stylesheets Config Files /etc/xml/catalog /etc/xml/catalog Configuration Information 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/&docbook-xsl-version;" \ "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \ /etc/xml/catalog && xmlcatalog --noout --add "rewriteURI" \ "https://cdn.docbook.org/release/xsl-nons/&docbook-xsl-version;" \ "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \ /etc/xml/catalog && xmlcatalog --noout --add "rewriteSystem" \ "https://cdn.docbook.org/release/xsl-nons/current" \ "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \ /etc/xml/catalog && xmlcatalog --noout --add "rewriteURI" \ "https://cdn.docbook.org/release/xsl-nons/current" \ "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \ /etc/xml/catalog && xmlcatalog --noout --add "rewriteSystem" \ "http://docbook.sourceforge.net/release/xsl/current" \ "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \ /etc/xml/catalog && xmlcatalog --noout --add "rewriteURI" \ "http://docbook.sourceforge.net/release/xsl/current" \ "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \ /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 Files Installed Directories /usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;/*/*.xsl /usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version; and /usr/share/doc/docbook-xsl-nons-&docbook-xsl-version; Short Descriptions XSL Stylesheets are used for performing transformations on XML files XSL Stylesheets