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
|
