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 |
---|
|
<- Previous | Index | Next -> |
---|---|---|
RE: [xsl] documenting xsl styleshee, Kielen, Agnes | Thread | RE: [xsl] Re: text() word lists, David . Pawson |
RE: [xsl] documenting xsl styleshee, Kielen, Agnes | Date | [xsl] Normalize / Simplify HTML-Tab, Markus Reinsch |
Month |