12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152 |
- ----------------------------------------------------------------------
- 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
|