Re: [xsl] New SourceForge Project: Doxsl - A Documentation Generator for XSLT

["Jim Earley" <xml.jim@xxxxxxxxx>]

Ken,

Thanks for the pointer - I will definitely take a look.  I really
appreciate the advice.

Cheers,

Jim

On Thu, Apr 3, 2008 at 1:50 PM, G. Ken Holman
<gkholman@xxxxxxxxxxxxxxxxxxxx> wrote:
>
> At 2008-04-03 12:39 -0600, Jim Earley wrote:
> > My apologies if this is a repeat post (my other mail client seems to
> > be having issues):
> >
> > At any rate:
> >
> > I've created a new SourceForge project called Doxsl
> > (http://doxsl.sourceforge.net) that generates documentation for XSLT
> > stylesheets, much like javadoc or Perl POD docs. However, unlike
> > these, Doxsl supports generating docs into DITA and HTML (DocBook is
> > coming in the near future).
> >
> > I've posted the first release (1.0.1 RC-1).  I welcome all feedback
> > and suggestions for making Doxsl useful.
> >
>
> You may find some techniques that I use in XSLStyle (today it is the top
> Google link using that term; or you can find it in the free resources
> section of our web site linked below) appropriate to your project.  This is
> an XSLT stylesheet documentation methodology, much like javadoc, that I
> first announced in 2004.  The current release supports either DocBook or
> DITA.  It is freely downloaded from our web site.  The name derives from the
> fact that it is a stylesheet for stylesheets.
>
> XSLStyle includes a complete report of the import/include tree and an
> alphabetized index of all globally-named constructs declared in all modules.
> By dragging and dropping an apex XSLT stylesheet with an embedded stylesheet
> association processing instruction, the HTML report of the DITA or DocBook
> constructs is fully rendered for the entire suite of fragments in the
> import/include tree.  Attributes characterize those globally named
> constructs that are expected to be available for customization by a wrapping
> stylesheet, from those named constructs that are expected to be for
> "internal" use only by the stylesheet library.
>
> My customers have found such documentation valuable in supporting the
> deliveries I make of stylesheet libraries that contain many fragments.
>
> The design provides for any other vocabulary to be added to XSLStyle to be a
> choice in the documentation constructs used within the XSLStyle framework.
>
> I hope this helps.
>
> . . . . . . . . . . . . . Ken
>
>
> --
> Upcoming:  UBL Apr.22,24; genericode code lists Apr.23; Rome,Italy
> World-wide corporate, govt. & user group XML, XSL and UBL training
> RSS feeds:     publicly-available developer resources and training
> G. Ken Holman                 mailto:gkholman@xxxxxxxxxxxxxxxxxxxx
> Crane Softwrights Ltd.          http://www.CraneSoftwrights.com/s/
> Box 266, Kars, Ontario CANADA K0A-2E0    +1(613)489-0999 (F:-0995)
> Male Cancer Awareness Nov'07  http://www.CraneSoftwrights.com/s/bc
> Legal business disclaimers:  http://www.CraneSoftwrights.com/legal