ANN: CSLDSSSL (was: DocBook and Jade for Literate Programming)

Subject: ANN: CSLDSSSL (was: DocBook and Jade for Literate Programming)
From: "G. Ken Holman" <gkholman@xxxxxxxxxxxxxx>
Date: Tue, 03 Nov 1998 13:44:24 -0500
Based on James' request for comments on literate programming:

At 98/10/30 18:38 -0600, James H. Cloos Jr. wrote:
>I'm looking for a good base tool-suite for literate programming (a
>Knuthian Web -- as opposed to a Berners-Lee-esque Web -- if you will :)
>and am looking at something based on DocBook, using Jade for both
>conversion for publication (HTML, ps/pdf via TeX, etc) and extraction
>of the code.
>
>Has anyone tried anything like this?  Any comments/ideas on how to
>best do it?

I've been scrambling to package and put up on my website a literate DSSSL
stylesheet environment that I've been using for a while to write a DSSSL
script and its associated documentation in a single file.

CSLDSSSL is an Annotatable DSSSL Stylesheet document model, where the
annotations and documentation are captured in rich element structure,
interspersed with the actual DSSSL code recognized by the DSSSL engine in
the architectural instance of the stylesheet.  The environment produces
both HTML and printed documentation of the rich markup.

Since I've only been planning to use it for my own work (the HTML3.2
volunteer work for Jon and my X2D shareware), I'm not sure it is exactly
ready for prime time, but I was prompted to release it based on James' post
because I use JADE's SGML syntax semantics for one of the outputs which is
the distilled DSSSL code.  From this, James, you can see how I've extracted
raw ASCII text from within a marked up document ... when the supplied batch
file is invoked with a given Annotated Stylesheet, one of the outputs
produced is an unannotated version of the stylesheet.

Any bug reports or suggestions for improvement are welcome.

Follow the Resources link in my trailer below to get a copy of the
environment.

I hope this helps.

............ Ken


--
G. Ken Holman               mailto:gkholman@xxxxxxxxxxxxxx
Crane Softwrights Ltd.  http://www.CraneSoftwrights.com/d/
Box 266,                                V: +1(613)489-0999
Kars, Ontario CANADA K0A-2E0            F: +1(613)489-0995
Training:   http://www.CraneSoftwrights.com/d/schedule.htm
Resources: http://www.CraneSoftwrights.com/d/resources.htm
Shareware: http://www.CraneSoftwrights.com/d/shareware.htm


 DSSSList info and archive:  http://www.mulberrytech.com/dsssl/dssslist


Current Thread