2.3. Tools for XSL Stylesheets

In order to successfully use the XSL stylesheets you must have some XSLT processor. This is sufficient for generating HTML version of the documentation. If you also want to create a version suitable for printing, you will additionally need a FO processor.

This is an operating system independent section, as most of the tools are written in the Java language, or provide a version in Java. This means, you can run them on virtually any operating system, where a Java Virtual Machine is available. See the Java homepage for more information.

Note: Using XSL stylesheets to generate different formats of the phpdoc XML files is optional currently. This method is not as well supported as DSSSL stylesheets, but is a promising technology. You do not need to setup any tools mentioned here if you would not like to play with XSL stylesheets. However we plan to use XSL in the future for HTML generation, and possibly PDF generation, if we can manage to work out how to do it correctly.

The phpdoc Makefile has options to generate files using the XSL sheets, but these are currently experimental (and require xsltproc exclusively). After running ./configure you can run make html_xsl to generate HTML files using XSL sheets.

XSLT processors:

Note: As we tested, other XSLT processors, like XT and MSXML cannot handle the DocBook XSL stylesheets, so these cannot be used for even the simplest HTML creation.

FO processors: