What Is Doxsl?

Doxsl is a library of XSLT 2.0 stylesheets that are used to generate code documentation for XSLT stylesheet applications. The libary collects the XSLT stylesheet modules in the application and contains functions and base templates that can used to generate documentation in a wide variety of markup languages.

Doxsl includes default implementations for generating stylesheet documentation in DITA, DocBook, and HTML. Doxsl can be extended to create other formats such as XSL-FO (for PDF and other print layout formats), ODF, or WordML.

The Doxsl Core Library

The Doxsl Core library is responsible for collecting and collating all of the XSLT stylesheets in an XSLT application into an in-memory result set that can be used for processing the output. In addition, the Doxsl Core includes many xsl:functions that allow implementors to access data from the application including:

Documentation Schemas

In addition to the Doxsl Core Library, Doxsl also includes a very loose documentation markup schema that you can use to document your stylesheets. It's integrated with the XSLT 2.0 schema if you have a syntax-aware editor that enables code-competion, or if you want to simply validate your stylesheet against the schema.

Note:

The Doxsl processor does not validate your code comments and will simply fail to process markup it doesn't understand.

You aren't obligated to use it to generate your documentation. It just provides basic XML markup that Doxsl implements out of the box if used, and provides non-documented stylesheets with a starting point for enabling more complete code documentation. If you've documented your code with another markup schema, you don't have to retrofit your documentation with Doxsl's (unless you want to). Instead, you can override Doxsl's comment processing code with your own.