Wrox Programmer Forums
Go Back   Wrox Programmer Forums > XML > XSLT
XSLT General questions and answers about XSLT. For issues strictly specific to the book XSLT 1.1 Programmers Reference, please post to that forum instead.
Welcome to the p2p.wrox.com Forums.

You are currently viewing the XSLT section of the Wrox Programmer to Programmer discussions. This is a community of software programmers and website developers including Wrox book authors and readers. New member registration was closed in 2019. New posts were shut off and the site was archived into this static format as of October 1, 2020. If you require technical support for a Wrox book please contact http://hub.wiley.com
Old January 21st, 2010, 12:04 PM
Authorized User
Join Date: Apr 2008
Posts: 11
Thanks: 5
Thanked 0 Times in 0 Posts
Default Documentation of XSL?

I'm looking to generate a re-usable XSL library of named templates, and was wondering if there were either any best practices, or just good ideas in the area.

I have been working along the lines of adding a 'xml-stylesheet' processing instruction to my XSL library which would cause it to produce HTML documentation when opened with a web browser. For documentation, I looked at the documentation examples from the xsltsl SourceForge project. The example that I saw (example.xsl from the download ZIP) seemed nice, but the effort seems dormant, and I could not find a XSD from which to emulate the example.

I work in a large organization, and would like a standard from which to work. If I could find one, I could produce a standard XSL for producing HTML documentation from XSL files.

[Note: Ideally, I'd like to build an XSL which could produce HTML documentation from any type of XML file (XML, XSL, XSD, WSDL, etc.), but only a few of these seem poised to do this. (E.g., WSDL has a nice means to annotate.)

Any words of wisdom?
Old January 21st, 2010, 02:27 PM
Friend of Wrox
Join Date: Nov 2007
Posts: 1,243
Thanks: 0
Thanked 245 Times in 244 Posts

I am not sure there is a standard but you could check http://www.cranesoftwrights.com/reso...tyle/index.htm to see whether it fits your needs.
Martin Honnen
Microsoft MVP (XML, Data Platform Development) 2005/04 - 2013/03
My blog
The Following User Says Thank You to Martin Honnen For This Useful Post:
whelanj (February 2nd, 2010)
Old January 21st, 2010, 07:11 PM
mhkay's Avatar
Wrox Author
Join Date: Apr 2004
Posts: 4,962
Thanks: 0
Thanked 292 Times in 287 Posts

There have been a number of attempts to produce a "standard" for documenting stylesheets over the years, but I'm not sure many of them are used by a wider community than their originators and a few friends. Choose one that suits you.
Michael Kay
Author, XSLT 2.0 and XPath 2.0 Programmer\'s Reference
The Following User Says Thank You to mhkay For This Useful Post:
whelanj (February 2nd, 2010)

Similar Threads
Thread Thread Starter Forum Replies Last Post
Do you know NET 2.0 documentation tools? woojtii .NET Framework 2.0 1 August 3rd, 2006 04:30 PM
Images in documentation... gbianchi Pro VB.NET 2002/2003 0 August 15th, 2005 12:43 PM
code documentation in jsp allang JSP Basics 0 August 7th, 2005 08:34 PM
ASP Documentation deanglass Classic ASP Basics 3 July 21st, 2003 12:45 AM

Powered by vBulletin®
Copyright ©2000 - 2020, Jelsoft Enterprises Ltd.
Copyright (c) 2020 John Wiley & Sons, Inc.