doc/sbcl-html.dsl

   1 <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN"
   2
   3 --
   4
   5 This is a stylesheet for converting DocBook to HTML, implemented as a
   6 customization layer over Norman Walsh's modular DocBook stylesheets.
   7 It's possible that it could be useful for other documents, or even
   8 that it could be an example of decent DSSSL style, but if so, that's
   9 basically an accident, since it was written based on a superficial
  10 reading of chapter 4 of _DocBook: The Definitive Guide_, by Norman
  11 Walsh and Leonard Muellner, and has only been tested on the SBCL
  12 manual.
  13
  14 This software is part of the SBCL system. See the README file for more
  15 information.
  16
  17 The SBCL system is derived from the CMU CL system, which was written
  18 at Carnegie Mellon University and released into the public domain. The
  19 software is in the public domain and is provided with absolutely no
  20 warranty. See the COPYING and CREDITS files for more information.
  21
  22 KLUDGE: The ENTITY docbook.dsl command is hardwired to the appropriate
  23 location for my OpenBSD 2.9 system. There's got to be a more flexible
  24 way to do it, but I'm not enough of an SGML guru to begin to guess
  25 what it would be. (WHN 2001-10-15)
  26
  27 --
  28
  29  [<!ENTITY docbook.dsl
  30            SYSTEM
  31            "/usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl"
  32            CDATA
  33            dsssl>]>
  34
  35 <style-sheet>
  36 <style-specification id="html" use="docbook">
  37 <style-specification-body>
  38
  39 ;;; FIXME: It would be nice to have output files have ".html" extensions
  40 ;;; instead of ".htm" extensions.
  41
  42 ;;; Essentially all the stuff in the "Programming languages and
  43 ;;; constructs" section (pp. 40-41 of _DocBook: The Definitive Guide_)
  44 ;;; is to be monospaced. The one exception is "replaceable", which
  45 ;;; needs to be distinguishable from the others.
  46 ;;;
  47 ;;; (In the modular stylesheets as of 1.54, some elements like "type"
  48 ;;; were typeset in the same font as running text, which led to
  49 ;;; horrible confusion in the SBCL manual.)
  50 (element action ($mono-seq$))
  51 (element classname ($mono-seq$))
  52 (element constant ($mono-seq$))
  53 (element errorcode ($mono-seq$))
  54 (element errorname ($mono-seq$))
  55 (element errortype ($mono-seq$))
  56 (element function ($mono-seq$))
  57 (element interface ($mono-seq$))
  58 (element interfacedefinition ($mono-seq$))
  59 (element literal ($mono-seq$))
  60 (element msgtext ($mono-seq$))
  61 (element parameter ($mono-seq$))
  62 (element property ($mono-seq$))
  63 (element replaceable ($italic-seq$))
  64 (element returnvalue ($mono-seq$))
  65 (element structfield ($mono-seq$))
  66 (element structname ($mono-seq$))
  67 (element symbol ($mono-seq$))
  68 (element token ($mono-seq$))
  69 (element type ($mono-seq$))
  70 (element varname ($mono-seq$))
  71
  72 ;;; Things in the "Operating systems" and "General purpose"
  73 ;;; sections (pp. 41-42 and pp. 42-43
  74 ;;; of _DocBook: The Definitive Guide_) are handled on a case
  75 ;;; by case basis.
  76 ;;;
  77 ;;; "Operating systems" section
  78 (element application ($charseq$))
  79 (element command ($mono-seq$))
  80 (element envar ($mono-seq$))
  81 (element filename ($mono-seq$))
  82 (element medialabel ($mono-seq$))
  83 ;;; (The "msgtext" element is handled in another section.)
  84 (element option ($mono-seq$))
  85 ;;; (The "parameter" element is handled in another section.)
  86 (element prompt ($bold-mono-seq$))
  87 (element systemitem ($mono-seq$))
  88 ;;;
  89 ;;; "General purpose" section
  90 (element database ($charseq$))
  91 (element email ($mono-seq$))
  92 ;;; (The "filename" element is handled in another section.)
  93 (element hardware ($mono-seq$))
  94 (element inlinegraphic ($mono-seq$))
  95 ;;; (The "literal" element is handled in another section.)
  96 ;;; (The "medialabel" element is handled in another section.)
  97 ;;; (The "option" element is handled in another section.)
  98 (element optional ($italic-mono-seq$))
  99 ;;; (The "replaceable" element is handled in another section.)
 100 ;;; (The "symbol" element is handled in another section.)
 101 ;;; (The "token" element is handled in another section.)
 102 ;;; (The "type" element is handled in another section.)
 103
 104 </style-specification-body>
 105 </style-specification>
 106
 107 <external-specification id="docbook" document="docbook.dsl">
 108
 109 </style-sheet>