Subject: Re: 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
|
Cart
