Home Explore Help
Sign In
lfs
/
lfs-book
2
0
Fork 0
Files Issues Pull Requests 0 Wiki
Tree: b06fc9c775
Branches Tags
lfs-book
/
stylesheets
/
lfs-xsl
/
docbook-xsl-1.78.1
/
extensions
/
README.LIBXSLT

README.LIBXSLT 2.2 KB
History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152 
  1. ----------------------------------------------------------------------
    2. 

  2.               README file for the libxslt extensions
    3. 

  3. ----------------------------------------------------------------------
    4. 

  4. $Id: README.LIBXSLT 7877 2008-03-08 04:07:52Z xmldoc $
    5. 

  5. 

  6. These are XSLT extensions written in Python for use with the DocBook XML 
    7. 

  7. stylesheets and the libxslt library[1].
    8. 

  8. 

  9. Currently, the only available extension is a function for adjusting column
    10. 

  10. widths in tables. For more information, see the section describing the 
    11. 

  11. equivalent Java extension in "DocBook XSL: The Complete Guide"[2].
    12. 

  12. 

  13. ----------------------------------------------------------------------
    14. 

  14. Preparations
    15. 

  15. ----------------------------------------------------------------------
    16. 

  16. In addition to libxml2 and libxslt, the following software needs to 
    17. 

  17. be installed before you start using the extensions:
    18. 

  18. 

  19. 1. Python[3].
    20. 

  20. 

  21. 2. Python bindings for libxml2/libxslt. Most distributions of 
    22. 

  22.    libxml2/libxslt for Unix/Linux include these bindings.
    23. 

  23.    A native Windows port is provided by Stéphane Bidoul[4].
    24. 

  24. 

  25. ----------------------------------------------------------------------
    26. 

  26. Installation of the extensions
    27. 

  27. ----------------------------------------------------------------------
    28. 

  28. No special installation step is needed.
    29. 

  29. 

  30. ----------------------------------------------------------------------
    31. 

  31. How to use the extensions
    32. 

  32. ----------------------------------------------------------------------
    33. 

  33. Instead of using xsltproc, you run a Python program (xslt.py). The 
    34. 

  34. command has this general form:
    35. 

  35. 

  36. python xslt.py xmlfile xslfile [outputfile] [param1=val1 [param2=val]...]
    37. 

  37. 

  38. Modify paths, filenames, and parameters as needed. Make sure to set 
    39. 

  39. the "use.extensions" and "tablecolumns.extension" parameters to 1.
    40. 

  40. 

  41. ----------------------------------------------------------------------
    42. 

  42. Manifest
    43. 

  43. ----------------------------------------------------------------------
    44. 

  44. README.LIBXSLT   This file
    45. 

  45. xslt.py          Executable script file
    46. 

  46. docbook.py       Module that implements extensions
    47. 

  47. 

  48. ----------------------------------------------------------------------
    49. 

  49. [1] http://xmlsoft.org/XSLT
    50. 

  50. [2] http://www.sagehill.net/docbookxsl/ColumnWidths.html
    51. 

  51. [3] http://www.python.org/download
    52. 

  52. [4] http://users.skynet.be/sbi/libxml-python
    53.