1

We want to document an XML file structure using the self-documented XSD schema file.

As Sphinx provides some autodoc support for some languages, is there an equivalent way to generate some kind of good looking documentation directly from XSD ?

NB: we use Sphinx / ReStructuredText for project documentation.

Donatello
  • 3,486
  • 3
  • 32
  • 38
  • Sphinx has no built-in functionality for generating reST-based documentation from XSD, and I don't know any other tool that can do it. Perhaps you can build something yourself based on this project: https://github.com/averagehuman/python-html2rest. Or use some other tool that does not involve reST/Sphinx at all: https://stackoverflow.com/a/533257/407651. – mzjn Mar 31 '18 at 09:03

1 Answers1

0

A great XSD documentation generator you can find here: http://www.flexdoc.xyz/flexdoc-xml/xsddoc/

It generates highly detailed XML schema documentation with diagrams:

enter image description here

ColdFusion
  • 2,381
  • 13
  • 14
  • that's interesting but unfortunately there is no simple integration capabilities with Sphinx-Doc, which is what we want to do. maybe we could investigate later. – Donatello Sep 12 '18 at 15:31