README.LIBXSLT
1----------------------------------------------------------------------
2 README file for the libxslt extensions
3----------------------------------------------------------------------
4$Id: README.LIBXSLT 7877 2008-03-08 04:07:52Z xmldoc $
5
6These are XSLT extensions written in Python for use with the DocBook XML
7stylesheets and the libxslt library[1].
8
9Currently, the only available extension is a function for adjusting column
10widths in tables. For more information, see the section describing the
11equivalent Java extension in "DocBook XSL: The Complete Guide"[2].
12
13----------------------------------------------------------------------
14Preparations
15----------------------------------------------------------------------
16In addition to libxml2 and libxslt, the following software needs to
17be installed before you start using the extensions:
18
191. Python[3].
20
212. Python bindings for libxml2/libxslt. Most distributions of
22 libxml2/libxslt for Unix/Linux include these bindings.
23 A native Windows port is provided by St�phane Bidoul[4].
24
25----------------------------------------------------------------------
26Installation of the extensions
27----------------------------------------------------------------------
28No special installation step is needed.
29
30----------------------------------------------------------------------
31How to use the extensions
32----------------------------------------------------------------------
33Instead of using xsltproc, you run a Python program (xslt.py). The
34command has this general form:
35
36python xslt.py xmlfile xslfile [outputfile] [param1=val1 [param2=val]...]
37
38Modify paths, filenames, and parameters as needed. Make sure to set
39the "use.extensions" and "tablecolumns.extension" parameters to 1.
40
41----------------------------------------------------------------------
42Manifest
43----------------------------------------------------------------------
44README.LIBXSLT This file
45xslt.py Executable script file
46docbook.py Module that implements extensions
47
48----------------------------------------------------------------------
49[1] http://xmlsoft.org/XSLT
50[2] http://www.sagehill.net/docbookxsl/ColumnWidths.html
51[3] http://www.python.org/download
52[4] http://users.skynet.be/sbi/libxml-python
53