- ----------------------------------------------------------------------
- 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 Stphane 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
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#1 | 10838 | Robert Cowham | Populate //guest/robert_cowham/perforce/utils/p4convert/... from //guest/perforce_softwar...e/p4convert/.... « |
10 years ago | |
//guest/perforce_software/p4convert/docs/_build/docbook-xsl-ns-1.78.1/extensions/README.LIBXSLT | |||||
#1 | 10706 | Paul Allen | Add document '_build' files. | 10 years ago |