Matthew Burgess 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
..
LICENSE.txt 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
NOTICE.txt 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
README.LIBXSLT 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
README.txt 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
docbook.py 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
lucene-analyzers-3.0.0.jar 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
lucene-core-3.0.0.jar 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
saxon65.jar 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
tagsoup-1.2.1.jar 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
webhelpindexer.jar 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
xalan27.jar 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago
xslt.py 15c7d39533 Update stylesheets to docbook-xsl-1.78.1. 11 years ago

README.LIBXSLT

----------------------------------------------------------------------
README file for the libxslt extensions
----------------------------------------------------------------------
$Id: README.LIBXSLT 7877 2008-03-08 04:07:52Z xmldoc $

These are XSLT extensions written in Python for use with the DocBook XML
stylesheets and the libxslt library[1].

Currently, the only available extension is a function for adjusting column
widths in tables. For more information, see the section describing the
equivalent Java extension in "DocBook XSL: The Complete Guide"[2].

----------------------------------------------------------------------
Preparations
----------------------------------------------------------------------
In addition to libxml2 and libxslt, the following software needs to
be installed before you start using the extensions:

1. Python[3].

2. Python bindings for libxml2/libxslt. Most distributions of
libxml2/libxslt for Unix/Linux include these bindings.
A native Windows port is provided by Stéphane Bidoul[4].

----------------------------------------------------------------------
Installation of the extensions
----------------------------------------------------------------------
No special installation step is needed.

----------------------------------------------------------------------
How to use the extensions
----------------------------------------------------------------------
Instead of using xsltproc, you run a Python program (xslt.py). The
command has this general form:

python xslt.py xmlfile xslfile [outputfile] [param1=val1 [param2=val]...]

Modify paths, filenames, and parameters as needed. Make sure to set
the "use.extensions" and "tablecolumns.extension" parameters to 1.

----------------------------------------------------------------------
Manifest
----------------------------------------------------------------------
README.LIBXSLT This file
xslt.py Executable script file
docbook.py Module that implements extensions

----------------------------------------------------------------------
[1] http://xmlsoft.org/XSLT
[2] http://www.sagehill.net/docbookxsl/ColumnWidths.html
[3] http://www.python.org/download
[4] http://users.skynet.be/sbi/libxml-python