diff options
Diffstat (limited to 'pst/xml/docbook-xsl-ns.xml')
| -rw-r--r-- | pst/xml/docbook-xsl-ns.xml | 270 |
1 files changed, 270 insertions, 0 deletions
diff --git a/pst/xml/docbook-xsl-ns.xml b/pst/xml/docbook-xsl-ns.xml new file mode 100644 index 0000000000..a66f4c0199 --- /dev/null +++ b/pst/xml/docbook-xsl-ns.xml @@ -0,0 +1,270 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../../general.ent"> + %general-entities; + + <!ENTITY path "https://github.com/docbook/xslt10-stylesheets/releases/download/release"> + + <!ENTITY docbook-xsl-ns-download-http "&path;/&docbook-xsl-version;/docbook-xsl-&docbook-xsl-version;.tar.bz2"> + <!ENTITY docbook-xsl-ns-download-ftp " "> + <!ENTITY docbook-xsl-ns-md5sum "4a400f0264a19329c7f95f69e098744a"> + <!ENTITY docbook-xsl-ns-size "23 MB"> + <!ENTITY docbook-xsl-ns-buildsize "49 MB"> + <!ENTITY docbook-xsl-ns-time "less than 0.1 SBU"> +]> + +<sect1 id="docbook-xsl-ns" +xreflabel="docbook-xsl-ns-&docbook-xsl-version;"> + <?dbhtml filename="docbook-xsl-ns.html"?> + + + <title>docbook-xsl-ns-&docbook-xsl-version;</title> + + <indexterm zone="docbook-xsl-ns"> + <primary sortas="a-DocBook-XSL-Stylesheets">DocBook XSL + Stylesheets (Namespaced)</primary> + </indexterm> + + <sect2 role="package"> + <title>Introduction to DocBook XSL Stylesheets (Namespaced)</title> + + <para> + The <application>DocBook XSL Stylesheets (Namespaced)</application> + package contains XSL stylesheets. These are useful for + performing transformations on XML DocBook 5.0 files. + </para> + + &lfs122_checked; + + <bridgehead renderas="sect3">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para> + Download (HTTP): <ulink url="&docbook-xsl-ns-download-http;"/> + </para> + </listitem> + <listitem> + <para> + Download (FTP): <ulink url="&docbook-xsl-ns-download-ftp;"/> + </para> + </listitem> + <listitem> + <para> + Download MD5 sum: &docbook-xsl-ns-md5sum; + </para> + </listitem> + <listitem> + <para> + Download size: &docbook-xsl-ns-size; + </para> + </listitem> + <listitem> + <para> + Estimated disk space required: &docbook-xsl-ns-buildsize; + </para> + </listitem> + <listitem> + <para> + Estimated build time: &docbook-xsl-ns-time; + </para> + </listitem> + </itemizedlist> + + <bridgehead renderas="sect3">Additional Downloads</bridgehead> + <itemizedlist spacing='compact'> + <listitem> + <para> + Required patch: <ulink url= + "&patch-root;/docbook-xsl-&docbook-xsl-version;-stack_fix-1.patch"/> + </para> + </listitem> + </itemizedlist> + + <bridgehead renderas="sect3">DocBook XSL Stylesheets (Namespaced) Dependencies</bridgehead> + + <bridgehead renderas="sect4">Recommended (at runtime)</bridgehead> + <para role="recommended"> + <xref role="runtime" linkend="libxml2"/> + </para> + + <bridgehead renderas="sect4">Optional (all used at runtime)</bridgehead> + <para role="optional"> + <xref role="runtime" linkend="apache-ant"/> + (to produce <quote>webhelp</quote> documents), + <xref role="runtime" linkend="libxslt"/> + (or any other XSLT processor), to process + Docbook documents, + <xref role="runtime" linkend="ruby"/> + (to utilize the <quote>epub</quote> stylesheets), + <xref role="runtime" linkend="zip"/> + (to produce <quote>epub3</quote> documents), and + <ulink url="https://sourceforge.net/projects/saxon/files/saxon6/"> + Saxon6 + </ulink> and + <ulink url="http://xerces.apache.org/xerces2-j/">Xerces2 Java</ulink> + (used with <xref role="runtime" linkend="apache-ant"/> + to produce <quote>webhelp</quote> documents) + </para> + + + </sect2> + + <sect2 role="installation"> + <title>Installation of DocBook XSL Stylesheets (Namespaced)</title> + + <para> + First, fix a problem that causes stack overflows when doing recursion: + </para> + +<screen><userinput>patch -Np1 -i ../docbook-xsl-nons-&docbook-xsl-version;-stack_fix-1.patch</userinput></screen> + + <para> + BLFS does not install the required packages to run the test suite + and provide meaningful results. + </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; && + +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-&docbook-xsl-version; && + +ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;/VERSION.xsl</userinput></screen> + + <para> + The documentation for this package is shared with its non-namespaced + counterpart, the <xref linkend='docbook-xsl'/> package. Install the + latter if you want the documentation. + </para> + </sect2> + + <sect2 role="configuration"> + <title>Configuring DocBook XSL Stylesheets</title> + + <sect3 id="docbook-xsl-ns-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 (both <emphasis>http</emphasis> + and <emphasis>https</emphasis> forms are used because upstream + have had both in their documentation): + </para> + +<screen role="root"><userinput>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" \ + "http://cdn.docbook.org/release/xsl/&docbook-xsl-version;" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog && + +xmlcatalog --noout --add "rewriteSystem" \ + "https://cdn.docbook.org/release/xsl/&docbook-xsl-version;" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog && + +xmlcatalog --noout --add "rewriteURI" \ + "http://cdn.docbook.org/release/xsl/&docbook-xsl-version;" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog && + +xmlcatalog --noout --add "rewriteURI" \ + "https://cdn.docbook.org/release/xsl/&docbook-xsl-version;" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog && + +xmlcatalog --noout --add "rewriteSystem" \ + "http://cdn.docbook.org/release/xsl/current" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog && + +xmlcatalog --noout --add "rewriteSystem" \ + "https://cdn.docbook.org/release/xsl/current" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog && + +xmlcatalog --noout --add "rewriteURI" \ + "http://cdn.docbook.org/release/xsl/current" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog && + +xmlcatalog --noout --add "rewriteURI" \ + "https://cdn.docbook.org/release/xsl/current" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog && + +xmlcatalog --noout --add "rewriteSystem" \ + "http://docbook.sourceforge.net/release/xsl-ns/current" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog && + +xmlcatalog --noout --add "rewriteURI" \ + "http://docbook.sourceforge.net/release/xsl-ns/current" \ + "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \ + /etc/xml/catalog</userinput></screen> + + </sect3> + + </sect2> + + <sect2 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Files</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;/*/*.xsl</seg> + <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="xsl-stylesheets-ns"> + <term><filename>XSL Stylesheets (Namespaced)</filename></term> + <listitem> + <para> + are used for performing transformations on XML files + </para> + <indexterm zone="docbook-xsl-ns xsl-stylesheets-ns"> + <primary sortas="g-XSL-Stylesheets-Namespaced">XSL Stylesheets (Namespaced)</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> |