Re: DD: Cookbook procedure markup sample (Was: DD: Status)

[Tony Graham <tgraham@xxxxxxxxxxxxxxxx>]

At 2 Jul 1997 23:11 +0100, Dave Love wrote:
 > Rather than a `cookbook' I'd like to see a documented library à la
 > Scheme's SLIB (some of which is potentially useful asis).

For the rest of us, what is Scheme's SLIB and where do we find it?

 > However, here's a collection of random stuff in case any of it is
 > useful, though not directly formatting-related.  Public domain, I
 > guess, but mostly `trad' anyhow.  I don't have time to mark it up and,
 > actually, for pedagogical purposes and guarantees of runnability I'd
 > prefer to use a literate programming system.  Corrections welcome
 > where I've messed up...

To illustrate using SGML for literate programming, the stylesheet for
Jade's SGML backend at the end of this message extracts just the
program listings.  It works quite well on my previous sample but it's
not bulletproof.  The list of parent elements was taken from the
DocBook documentation, and I wouldn't try the stylesheet on program
listings inside tables just yet.

I was expecting the literate programming question to come up, but more
in terms of how to get the titles and paragraphs into an output
stylesheet as comments or how to generate separate output files for
each <SECT1>.  I'm still looking for a way to turn record ends inside
selected elements into a record end plus ";; ".  I can do it quite
easily in something like CoST, but I don't know how to do it in Jade.

In any case, thank you, Dave, for your contribution.

Regards,


Tony Graham
=======================================================================
Tony Graham, Consultant
Mulberry Technologies, Inc.                         Phone: 301-231-6931
6010 Executive Blvd., Suite 608                     Fax:   301-231-6935
Rockville, MD USA 20852                 email: tgraham@xxxxxxxxxxxxxxxx
=======================================================================

<!doctype style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN">
;; $Id: literate.dsl,v 1.1 1997/07/16 06:04:02 tkg Exp $
;;
;; Jade DSSSL stylesheet to illustrate extracting program listings from
;; an SGML file

(element PROGRAMLISTING
	 (make sequence
	       (literal "&#RE;")
	       (process-children)
	       (literal "&#RE;")))

(define parent-list '("APPENDIX" "ARTICLE" "BIBLIODIV" "BIBLIOGRAPHY"
"BLOCKQUOTE" "CALLOUT" "CAUTION" "CHAPTER" "DEDICATION" "EXAMPLE"
"FIGURE" "FOOTNOTE" "GLOSSDEF" "GLOSSDIV" "GLOSSARY" "IMPORTANT"
"INDEX" "INDEXDIV" "INFORMALEXAMPLE" "LEGALNOTICE" "LISTITEM"
"MSGEXPLAN" "MSGTEXT" "NOTE" "PARA" "PARTINTRO" "PREFACE" "PROCEDURE"
"PROGRAMLISTINGCO" "REFSECT1" "REFSECT2" "REFSECT3" "REFSYNOPSISDIV"
"SECT1" "SECT2" "SECT3" "SECT4" "SECT5" "SETINDEX" "SIDEBAR"
"SIMPLESECT" "STEP" "TIP" "WARNING" "ENTRY"))

(default (apply process-matching-children 
		(append '("PROGRAMLISTING") parent-list)))


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