Re: [xsl] documenting xsl stylesheets

Subject: Re: [xsl] documenting xsl stylesheets
From: Paul Tremblay <phthenry@xxxxxxxxxxxxx>
Date: Tue, 10 Feb 2004 03:52:19 -0500
On Tue, Feb 10, 2004 at 09:21:34AM +0100, Kielen, Agnes wrote:
> 
> The idea is this. 
> During implementation and testing I use an 'XSLT with documentation elements'. When the stylesheets are ready for production I do several things.
> - Create a stripped stylesheet for production with 'createProduction.xsl'
> - Create an XML file with all documentation data with 'createDocumentation.xsl'
> - This new XML-file is used as input for the 'docToHtml.xsl' and creates a normal HTML file.
> 
> The reason I use this intermediate step of creating an XML file and only then the HTML is this: The intermediaye XML-file can be used to create several types of output, HTML, PDF and so on. At the moment the tool provides only supports HTML output. 
> 
> So for each original 'stylesheet with documentation nodes' 3 transformations are necessary when you want a stripped production stylesheet an HTML output. I still have plans to automate this proces by writing something smart myself or with Ant.
> 

Ah! Okay. I was using the html stylsheet directly on the xsl stylesheet,
and of course getting <html>one long, long line</html>

I've noticed that there is another standard for documenting stylehseets
found at:

http://xsltsl.sourceforge.net/

This mthod uses docbook elements.

After much searching on the web, I also found a debate about how to
standardize xslt documentation. (I even think you chimed in, Agnes.) 

Some posters suggested that xslt 2.0 incorporate a <doc:> element. 

But I reached the conclusion that no standard for xslt documentation was
reached.

Thanks


Paul
-- 

************************
*Paul Tremblay         *
*phthenry@xxxxxxxxxxxxx*
************************

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


Current Thread