This is the mail archive of the xsl-list@mulberrytech.com mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Tools to create HTML documentation for XSLT Stylesheets?


I'm creating a lot of XML DTDs and associated XSLT stylesheets for
transforming documents that conform to these DTDs. I would like to create
some detailed design documents about these DTD and XSLT files. Ideally, the
output would be nicely formatted HTML documentation. If you are familiar
with Java and the JavaDoc utility that produces HTML documentation for Java
Classes by extracting class definitions along with associated comments
directly from the Java sources, I would like to do something similar for my
XML DTDs and XSLT stylesheets.

I have found one tool already that comes close to what I want for XML DTDs.
The only drawback is that the documentation has to be placed in a separate
file rather than being embedded directly in the DTD as structured comments.
Other than that, it looks pretty good. It is called DTDDoc and you can find
out about it here:

      http://www.garshol.priv.no/download/software/dtddoc/

I have yet to find anything comparable for generating documentation about an
XSLT stylesheet. DTDDoc happens to be a free tool, but, I am interested in
any tool (free or commercial offering) that functions as an XSLTDoc tool
generating HTML documentation for XSLT stylesheets. I have already done
quite a bit of searching. I have looked at several of the major XML and XSL
resources sites without success. I would appreciate any product
recommendations or pointers to internet sites with information on this.

Thanks,

Mike Van Riper
van@icarian.com

P.S. The ironic thing is that XSLT is often used to generate documentation.
In fact, I could even imagine writing a transformation that worked on an
XSLT stylesheet as the input XML document to a transformation that did
something along these lines. Unfortunately, my day job is keeping me busy
day and night already. :-)


 XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]