source: pst/xml/docbook-xsl.xml@ 0aeb696

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

    <!-- Inserted as a reminder to do this. The mention of a test suite
         is usually right before the root user installation commands. Please
         delete these 12 (including one blank) lines after you are done.-->

    <!-- Use one of the two mentions below about a test suite,
         delete the line that is not applicable. Of course, if the
         test suite uses syntax other than "make check", revise the
         line to reflect the actual syntax to run the test suite -->

    <!-- <para>This package does not come with a test suite.</para> -->
    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->

  <!ENTITY docbook-xsl-download-http "http://prdownloads.sourceforge.net/docbook/docbook-xsl-&docbook-xsl-version;.tar.bz2">
  <!ENTITY docbook-xsl-download-ftp  " ">
  <!ENTITY docbook-xsl-md5sum        "6ebd29a67f2dcc3f2220f475ee6f6552">
  <!ENTITY docbook-xsl-size          "1.0 MB">
  <!ENTITY docbook-xsl-buildsize     "35.9 MB (includes installing optional documentation)">
  <!ENTITY docbook-xsl-time          "less than 0.1 SBU">

  <!ENTITY docbook-xsl-doc-download  "http://prdownloads.sourceforge.net/docbook/docbook-xsl-doc-&docbook-xsl-version;.tar.bz2">
]>

<sect1 id="docbook-xsl"
xreflabel="DocBook XSL Stylesheets-&docbook-xsl-version;">
  <?dbhtml filename="docbook-xsl.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
    <keywordset>
      <keyword role="package">docbook-xsl-&docbook-xsl-version;.tar</keyword>
      <keyword role="ftpdir">docbook-xsl</keyword>
    </keywordset>
  </sect1info>

  <title>DocBook XSL Stylesheets-&docbook-xsl-version;</title>

  <indexterm zone="docbook-xsl">
    <primary sortas="a-DocBook-XSL-Stylesheets">DocBook XSL
    Stylesheets</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to DocBook XSL Stylesheets</title>

    <para>The <application>DocBook XSL Stylesheets</application>
    package contains XSL stylesheets. These are useful for
    performing transformations on XML DocBook files.</para>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&docbook-xsl-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&docbook-xsl-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &docbook-xsl-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &docbook-xsl-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &docbook-xsl-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &docbook-xsl-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Optional documentation: <ulink
        url="&docbook-xsl-doc-download;"/></para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">DocBook XSL Stylesheets Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="libxml2"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/docbook-xsl"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of DocBook XSL Stylesheets</title>

    <para>If you downloaded the optional documentation tarball, unpack it
    when you unpack the source tarball. The documentation tarball unpacks into
    subdirectories of the source tree.</para>

    <para>Install <application>DocBook XSL Stylesheets</application>
    by running the following commands as the
    <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
cp -v -R VERSION common eclipse extensions fo html \
         htmlhelp images javahelp lib manpages params \
         profiling slides template website xhtml \
    /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;</userinput></screen>

    <para>If you downloaded the optional documentation tarball, install the
    documentation by issuing the following commands as the
    <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/docbook-xsl-&docbook-xsl-version; &amp;&amp;
cp -v -R doc/* /usr/share/doc/docbook-xsl-&docbook-xsl-version;</userinput></screen>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring DocBook XSL Stylesheets</title>

    <sect3 id="docbook-xsl-config">
      <title>Config Files</title>

      <para><filename>/etc/xml/catalog</filename></para>

      <indexterm zone="docbook-xsl docbook-xsl-config">
        <primary sortas="e-etc-xml-catalog">/etc/xml/catalog</primary>
      </indexterm>

    </sect3>

    <sect3>
      <title>Configuration Information</title>

      <para>Create (or append) and populate the XML catalog file using the
      following commands as the <systemitem class="username">root</systemitem>
      user:</para>

<screen role="root"><userinput>if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &amp;&amp;
if [ ! -f /etc/xml/catalog ]; then
    xmlcatalog --noout --create /etc/xml/catalog
fi &amp;&amp;

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 &amp;&amp;

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 &amp;&amp;

xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
    /etc/xml/catalog &amp;&amp;

xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
    /etc/xml/catalog</userinput></screen>

      <para>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 needs 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 <replaceable>&lt;version&gt;</replaceable>):</para>

<screen role="root"><userinput>xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
           "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
    /etc/xml/catalog &amp;&amp;

xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
           "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
    /etc/xml/catalog</userinput></screen>

<!-- Commented uot until be sure that there is no objetions from any of the
     {C,H}LFS editors

      <para>If you will be using the stylesheets from this installation to
      render the LFS and HLFS SVN books, then you need to create a symbolic
      link to the stylesheets directory so that the image files will be
      found. Create the link by issuing the following command as the
      <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>ln -v -sfn xsl-stylesheets-1.69.1 \
    /usr/share/xml/docbook/xsl-stylesheets-current</userinput></screen>
-->

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Files</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>None</seg>
        <seg>None</seg>
        <seg>XSL style sheets for HTML and FO</seg>
        <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; and
        /usr/share/doc/docbook-xsl-&docbook-xsl-version;</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>