---------------------------------------------------------------------- README file for the libxslt extensions ---------------------------------------------------------------------- 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