[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Use of SGML for documentation (Re: potato -> woody upgrade not smooth...)



(not subscribed to debian-sgml, please CC)
On Sat, Jul 07, 2001 at 05:14:43PM -0400, Matt Zimmerman wrote:
> 
> > > > And if I want to write data in an easily manipulatable form, I use Lisp.
> > > 
> > > I refuse to believe that you're advocating writing documentation in LISP.
> > LISP is a data-representation format.  
> 
> I don't think I was advocating using SGML or any related technology as a
> general-purpose data-representation format (as some have insisted XML is).
> 
I cooked up a quick example for you... see the 3 attached files.

-- 
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Matthew Danish                         email: mdanish@andrew.cmu.edu ;;
;; OpenPGP public key available from:        'finger mrd@db.debian.org' ;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Ignore this nasty loading stuff, I just hacked the HTML generation macros
;; from IMHO (http://alpha.onshored.com) and made them output SGML...
;; will clean this up sometime.
(load "util.lisp")
(load "htmlgen.lisp")

(with-open-file
 (stream "test.out" :direction :output)

 (net.html.generator:sgml-stream
  stream
  
  (:!doctype :debiandoc :public "-//DebianDoc//DTD DebianDoc//EN")
  (:debiandoc
   (:book
    (:titlepag
     (:title "Foobar, LISP style")
     (:author
      (:name "Matthew Danish")
      (:email "mrd@debian.org"))
     (:copyright "This document is released into the public domain."))
    (:chapt
     (:heading "Title")
     (:p "Content"))))))

(quit)
<!DOCTYPE DEBIANDOC PUBLIC "-//DebianDoc//DTD DebianDoc//EN"><debiandoc><book><titlepag><title>Foobar, LISP style</title><author><name>Matthew Danish</name><email>mrd@debian.org</email></author><copyright>This document is released into the public domain.</copyright></titlepag><chapt><heading>Title</heading><p>Content</p></chapt></book></debiandoc>

Attachment: test.out.ps
Description: PostScript document


Reply to: