summaryrefslogtreecommitdiff
path: root/extensions/README.LIBXSLT
blob: 2c80274484243eb31aea59625fbe54b50c82c4a7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
----------------------------------------------------------------------
              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