olink.docbook-xsl.extensions.README.LIBXSLT Maven / Gradle / Ivy
----------------------------------------------------------------------
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
© 2015 - 2024 Weber Informatics LLC | Privacy Policy