Date: Tue, 03 Nov 1998 13:44:24 -0500 From: "G. Ken Holman" <gkholman@CanadaMail.com> To: email@example.com Subject: ANN: CSLDSSSL (was: DocBook and Jade for Literate Programming)
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.
G. Ken Holman mailto:gkholman@CanadaMail.com 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