Difference between revisions of "DocBook XSL Stylesheets"

From CBLFS
Jump to navigationJump to search
Line 16: Line 16:
 
=== Required ===
 
=== Required ===
 
* [[LibXML2]]
 
* [[LibXML2]]
 +
 +
{{Note|If you downloaded the optional documentation tarball, unpack it into the same directory as the source tarball.}}
  
 
== Non-Multilib or Multilib ==
 
== Non-Multilib or Multilib ==
  
'''''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.'''''
+
=== Package Installation ===
  
 
Install DocBook XSL Stylesheets by running the following commands:
 
Install DocBook XSL Stylesheets by running the following commands:
  
  install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-{{DocBook XSL Stylesheets-Version}} &&
+
  install -v -m755 -d /usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}} &&
 
  cp -v -R VERSION common eclipse extensions fo highlighting html \
 
  cp -v -R VERSION common eclipse extensions fo highlighting html \
 
           htmlhelp images javahelp lib manpages params \
 
           htmlhelp images javahelp lib manpages params \
 
           profiling slides template website xhtml \
 
           profiling slides template website xhtml \
     /usr/share/xml/docbook/xsl-stylesheets-{{DocBook XSL Stylesheets-Version}}
+
     /usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}
  
 
If you downloaded the optional documentation tarball, install the documentation by issuing the following commands
 
If you downloaded the optional documentation tarball, install the documentation by issuing the following commands
Line 34: Line 36:
 
  cp -v -R doc/* /usr/share/doc/docbook-xsl-{{DocBook XSL Stylesheets-Version}}
 
  cp -v -R doc/* /usr/share/doc/docbook-xsl-{{DocBook XSL Stylesheets-Version}}
  
Create (or append) and populate the XML catalog file using the following commands:
+
=== Local Catalog ===
  
  if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &&
+
Create a local catalog for this package:
  if [ ! -f /etc/xml/catalog ]; then
+
 
    xmlcatalog --noout --create /etc/xml/catalog
+
  xmlcatalog --noout --create /usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}/catalog.xml &&
fi &&
+
  xmlcatalog --noout --add "rewriteURI" \
 +
            "http://docbook.sourceforge.net/release/xsl/{{DocBook XSL Stylesheets-Version}}" \
 +
            "." \
 +
            /usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}/catalog.xml &&
 
  xmlcatalog --noout --add "rewriteSystem" \
 
  xmlcatalog --noout --add "rewriteSystem" \
 
             "http://docbook.sourceforge.net/release/xsl/{{DocBook XSL Stylesheets-Version}}" \
 
             "http://docbook.sourceforge.net/release/xsl/{{DocBook XSL Stylesheets-Version}}" \
             "/usr/share/xml/docbook/xsl-stylesheets-{{DocBook XSL Stylesheets-Version}}" \
+
             "." \
    /etc/xml/catalog &&
+
            /usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}/catalog.xml &&
 
  xmlcatalog --noout --add "rewriteURI" \
 
  xmlcatalog --noout --add "rewriteURI" \
 +
            "http://docbook.sourceforge.net/release/xsl/current" \
 +
            "." \
 +
            /usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}/catalog.xml &&
 +
xmlcatalog --noout --add "rewriteSystem" \
 +
            "http://docbook.sourceforge.net/release/xsl/current" \
 +
            "." \
 +
            /usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}/catalog.xml
 +
 +
=== Global Catalog ===
 +
 +
Create the global catalog if it doesn't exist:
 +
 +
install -dv -m755 /etc/xml
 +
[ ! -f /etc/xml/catalog ] &&
 +
    xmlcatalog --noout --create /etc/xml/catalog
 +
 +
Add entries into the global catalog for this package:
 +
 +
xmlcatalog --noout --add "delegateURI" \
 
             "http://docbook.sourceforge.net/release/xsl/{{DocBook XSL Stylesheets-Version}}" \
 
             "http://docbook.sourceforge.net/release/xsl/{{DocBook XSL Stylesheets-Version}}" \
             "/usr/share/xml/docbook/xsl-stylesheets-{{DocBook XSL Stylesheets-Version}}" \
+
             "file:///usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}/catalog.xml" \
    /etc/xml/catalog &&
+
            /etc/xml/catalog &&
  xmlcatalog --noout --add "rewriteSystem" \
+
xmlcatalog --noout --add "delegateSystem" \
 +
            "http://docbook.sourceforge.net/release/xsl/{{DocBook XSL Stylesheets-Version}}" \
 +
            "file:///usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}/catalog.xml" \
 +
            /etc/xml/catalog
 +
 
 +
If this package is going to be the default xsl stylesheet, also add the following entries:
 +
 
 +
  xmlcatalog --noout --add "delegateURI" \
 
             "http://docbook.sourceforge.net/release/xsl/current" \
 
             "http://docbook.sourceforge.net/release/xsl/current" \
             "/usr/share/xml/docbook/xsl-stylesheets-{{DocBook XSL Stylesheets-Version}}" \
+
             "file:///usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}/catalog.xml" \
    /etc/xml/catalog &&
+
            /etc/xml/catalog &&
  xmlcatalog --noout --add "rewriteURI" \
+
  xmlcatalog --noout --add "delegateSystem" \
 
             "http://docbook.sourceforge.net/release/xsl/current" \
 
             "http://docbook.sourceforge.net/release/xsl/current" \
             "/usr/share/xml/docbook/xsl-stylesheets-{{DocBook XSL Stylesheets-Version}}" \
+
             "file:///usr/share/xml/docbook/stylesheet/docbook-xsl/{{DocBook XSL Stylesheets-Version}}/catalog.xml" \
    /etc/xml/catalog
+
            /etc/xml/catalog
  
 
[[Category:DocBook-XML]]
 
[[Category:DocBook-XML]]

Revision as of 18:01, 16 May 2010

Download Source: http://prdownloads.sourceforge.net/docbook/docbook-xsl-1.78.1.tar.bz2
Optional Documentation: http://prdownloads.sourceforge.net/docbook/docbook-xsl-doc-1.78.1.tar.bz2

Introduction to DocBook XSL Stylesheets

The DocBook XSL Stylesheets package contains XSL stylesheets. These are useful for performing transformations on XML DocBook files.

Project Homepage: Unknown

Dependencies

Required

Caution.png

Note

If you downloaded the optional documentation tarball, unpack it into the same directory as the source tarball.

Non-Multilib or Multilib

Package Installation

Install DocBook XSL Stylesheets by running the following commands:

install -v -m755 -d /usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1 &&
cp -v -R VERSION common eclipse extensions fo highlighting html \
         htmlhelp images javahelp lib manpages params \
         profiling slides template website xhtml \
    /usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1

If you downloaded the optional documentation tarball, install the documentation by issuing the following commands

install -v -m755 -d /usr/share/doc/docbook-xsl-1.78.1 &&
cp -v -R doc/* /usr/share/doc/docbook-xsl-1.78.1

Local Catalog

Create a local catalog for this package:

xmlcatalog --noout --create /usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1/catalog.xml &&
xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/1.78.1" \
           "." \
           /usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1/catalog.xml &&
xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/1.78.1" \
           "." \
           /usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1/catalog.xml &&
xmlcatalog --noout --add "rewriteURI" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "." \
           /usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1/catalog.xml &&
xmlcatalog --noout --add "rewriteSystem" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "." \
           /usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1/catalog.xml

Global Catalog

Create the global catalog if it doesn't exist:

install -dv -m755 /etc/xml
[ ! -f /etc/xml/catalog ] &&
    xmlcatalog --noout --create /etc/xml/catalog

Add entries into the global catalog for this package:

xmlcatalog --noout --add "delegateURI" \
           "http://docbook.sourceforge.net/release/xsl/1.78.1" \
           "file:///usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1/catalog.xml" \
           /etc/xml/catalog &&
xmlcatalog --noout --add "delegateSystem" \
           "http://docbook.sourceforge.net/release/xsl/1.78.1" \
           "file:///usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1/catalog.xml" \
           /etc/xml/catalog

If this package is going to be the default xsl stylesheet, also add the following entries:

xmlcatalog --noout --add "delegateURI" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "file:///usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1/catalog.xml" \
           /etc/xml/catalog &&
xmlcatalog --noout --add "delegateSystem" \
           "http://docbook.sourceforge.net/release/xsl/current" \
           "file:///usr/share/xml/docbook/stylesheet/docbook-xsl/1.78.1/catalog.xml" \
           /etc/xml/catalog