53 lines
2.2 KiB
Text
53 lines
2.2 KiB
Text
|
----------------------------------------------------------------------
|
|||
|
|
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<53>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
|