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(_at_)cranesoftwrights(_dot_)com> 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(_at_)CraneSoftwrights(_dot_)com
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
--~------------------------------------------------------------------
XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list
To unsubscribe, go to: http://lists.mulberrytech.com/xsl-list/
or e-mail:
<mailto:xsl-list-unsubscribe(_at_)lists(_dot_)mulberrytech(_dot_)com>
--~--
--~------------------------------------------------------------------
XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list
To unsubscribe, go to: http://lists.mulberrytech.com/xsl-list/
or e-mail: <mailto:xsl-list-unsubscribe(_at_)lists(_dot_)mulberrytech(_dot_)com>
--~--