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