/xs3p

Modernized fork of the xs3p XSD documentation tool - using bootstrap, markdown and HTML5.

Primary LanguageXSLTOtherNOASSERTION

xs3p XSD documentation generator

This tool generates nice-looking HTML documentation from XML Schema Descriptions.

It is a fork of version 1.1.5 of the xs3p doc tool from http://xml.fiforms.org/xs3p/ - see the original README for more information.

Added features include:

  • Complete re-design using Bootstrap
  • Output of UTF-8 encoded files
  • Output of HTML5
  • Support Markdown formatting in <documentation> elements, powered by the Pagedown library

You can see a nice example result here:

which is the result of one of the examples added specifically to demonstrate the new features of this fork.

Another interesting example is the result for the XML Schema .xsd itself:

That one pushes the system to its limits, but it's still useful in my opinion.

Known issues

  • There is currently no way to inline the Bootstrap and jQuery sources, thus those files must be fetched when viewing the documentation. Their URLs can be set, though, so you could serve them locally if offline viewing is a requirement.
  • While I even added some features (e.g. linking to the source attribute of the <documentation> element, if present), some features that have previously worked may have gone missing. Quite some refactoring was involved and it is quite hard to test some of the more esoteric features of XSD.
  • There are some minor display issues, but as far as I can tell none of them impact the usability.