xsl-list
[Top] [All Lists]

Re: documenting xsl stylesheets

2004-02-10 01:52:19
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(_at_)earthlink(_dot_)net*
************************

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



<Prev in Thread] Current Thread [Next in Thread>