Cart
|
[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] Re: documenting xsl stylesheets
 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 
|
PURCHASE STYLUS STUDIO ONLINE TODAY!Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced! 
Download The World's Best XML IDE!Accelerate XML development with our award-winning XML IDE - Download a free trial today! Subscribe in XML format
|
