[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: Self documentation, my crude stab in that direction

Subject: Re: Self documentation, my crude stab in that direction
From: Norman Walsh <ndw@xxxxxxxxxx>
Date: 10 Jul 2000 14:06:31 -0400
Re: Self documentation
/ "Pawson, David" <DPawson@xxxxxxxxxxx> was heard to say:
| >For each
| >template/variable/etc., I have an element in the doc: namespace that
| >contains documentation for it. My goal (as yet only partially
| >achieved) is to write stylesheets that build (reference/API)
| >documentation from this system. (This system isn't meant to address
| >tutorial and end-user documentation.)
| 
| Stepping back a little Norm.
| Just checking understanding.
| From the example I think you want to produce docbook xml
| (as documentation) from the docbook xsl stylesheets.
| Then to (presumably) use your docbook stylesheets again
| to format that into pdf/html?
| 
| Is that your objective?

Yes. The stylesheets are supposed to work directly, unmodified as XSLT
stylesheets. As documentation, they're run through another XSLT
stylesheet that produces (a set of) reference pages in XML. Those are
further processed (probably combined with prose documentation written
separate from the stylehsheets (for some definition of probably :-))
to produce HTML or RTF.

                                        Be seeing you,
                                          norm

-- 
Norman.Walsh@xxxxxxxxxxxx | If you are hankering after certainty, you
XML Technology Center     | are better advised to seek it in religion:
Sun Microsystems, Inc.    | the stock-in-trade of science is not
                          | certainty but doubt.--K.C. Cole


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


Current Thread

PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.