Re: [docbook-apps] Is there a good tool for XSL documentation?

[Michael Smith <smith@xml-doc.org>]

All the HTML reference documentation for the DocBook XSL
stylesheets is auto-generated from doc embedded in the
stylesheets. Some examples -

  http://docbook.sourceforge.net/snapshots/xsl/doc/common/common.html#template.select.mediaobject.index
  http://docbook.sourceforge.net/snapshots/xsl/doc/html/appendix.autolabel.html

Source files for those are -

  http://docbook.sourceforge.net/snapshots/xsl/common/common.xsl
  http://docbook.sourceforge.net/snapshots/xsl/params/appendix.autolabel.xml

And the XSL stylesheets that do the transformation are here:

  http://docbook.sourceforge.net/snapshots/xsl/docsrc/

It's not an off-the-shelf system. But you could probably adapt it
to your needs easily enough if you were to check out the source
for the DocBook XSL distro from the project CVS and spend a little
time looking at the makefiles and such.

  --Mike

Bruce D'Arcus <bdarcus.lists@gmail.com> writes:

> On 9/12/05, Thomas, Ludger <Ludger.Thomas@iese.fraunhofer.de> wrote:
> 
> > I am looking for a good tool to automatically generate some documentation
> > from my customized XSL layer (e.g. from comments). I tried out xsldoc but
> > ran into some problems with local paths. Is there a better OSS solution out
> > there to extract meaningfull documentation (XML prefered) from xsl files?
> 
> I use xsltdoc and have found it to be excellent.  Example here:
> 
> http://xbiblio.sourceforge.net/doc/index.html
> 
> Did you contact the author about your problem?
> 
> Bruce

-- 
Michael Smith
http://sideshowbarker.net/

smime.p7s