[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] Re: xsl/xslt coding standard
Mike Brown wrote: > I add frequent comments to explain why I'm doing whatever I'm doing. At an XSLT Q&A in Oxford recently, someone asked about adding comments to stylesheets, and it made me think of the discussions we had ages ago about the different ways of embedding *structured* comments in a stylesheet. We talked then about using extension elements, but it's a real pain because you have to have xsl:fallback in each of them to stop processors getting worried. One possibility that came to mind, though, was being able to specify one or more documentation-element namespaces for adding documentation to the stylesheet. So something like: <xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:html="http://www.w3.org/1999/xhtml" documentation-element-prefixes="html"> <html:p>Here's some documentation of my stylesheet</html:p> <xsl:template match="/"> <html:p>And I can use it within templates too!</html:p> ... </xsl:template> </xsl:stylesheet> What do y'all think? Cheers, Jeni --- Jeni Tennison http://www.jenitennison.com/ 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
|