Skip to content
This repository has been archived by the owner on Feb 9, 2019. It is now read-only.
/ xs3p Public archive

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

License

Notifications You must be signed in to change notification settings

bitfehler/xs3p

Repository files navigation

Project discontinued

I haven't had to deal with XML and releated technologies for many years now and I don't feel capable of making informed decisions about this project anymore. I would like to thank everyone who contributed or wanted to contribute for their interest. I recommend you browse the available forks and find one that is still actively developed.

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.

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