Skip to content
/ xs3p Public
forked from bitfehler/xs3p

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

License

Notifications You must be signed in to change notification settings

donniexyz/xs3p

 
 

Repository files navigation

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:

  • donniexyz added: sort on elements based on @id ascending (was [ local-name(.) asc, @name asc ] now [ @id asc, local-name(.) asc, @name asc ])
  • 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.

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • XSLT 100.0%