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 --
  23
  24  [<!ENTITY docbook.dsl
  25            SYSTEM
  26            "/usr/lib/sgml/stylesheets/nwalsh-modular/html/docbook.dsl"
  27            CDATA
  28            dsssl>]>
  29
  30 <style-sheet>
  31 <style-specification id="html" use="docbook">
  32 <style-specification-body>
  33
  34 ;;; FIXME: It would be nice to have output files have ".html" extensions
  35 ;;; instead of ".htm" extensions.
  36
  37 ;;; Essentially all the stuff in the "Programming languages and
  38 ;;; constructs" section (pp. 40-41 of _DocBook: The Definitive Guide_)
  39 ;;; is to be monospaced. The one exception is "replaceable", which
  40 ;;; needs to be distinguishable from the others.
  41 ;;;
  42 ;;; (In the modular stylesheets as of 1.54, some elements like "type"
  43 ;;; were typeset in the same font as running text, which led to
  44 ;;; horrible confusion in the SBCL manual.)
  45 (element action ($mono-seq$))
  46 (element classname ($mono-seq$))
  47 (element constant ($mono-seq$))
  48 (element errorcode ($mono-seq$))
  49 (element errorname ($mono-seq$))
  50 (element errortype ($mono-seq$))
  51 (element function ($mono-seq$))
  52 (element interface ($mono-seq$))
  53 (element interfacedefinition ($mono-seq$))
  54 (element literal ($mono-seq$))
  55 (element msgtext ($mono-seq$))
  56 (element parameter ($mono-seq$))
  57 (element property ($mono-seq$))
  58 (element replaceable ($italic-seq$))
  59 (element returnvalue ($mono-seq$))
  60 (element structfield ($mono-seq$))
  61 (element structname ($mono-seq$))
  62 (element symbol ($mono-seq$))
  63 (element token ($mono-seq$))
  64 (element type ($mono-seq$))
  65 (element varname ($mono-seq$))
  66
  67 ;;; Things in the "Operating systems" and "General purpose"
  68 ;;; sections (pp. 41-42 and pp. 42-43
  69 ;;; of _DocBook: The Definitive Guide_) are handled on a case
  70 ;;; by case basis.
  71 ;;;
  72 ;;; "Operating systems" section
  73 (element application ($charseq$))
  74 (element command ($mono-seq$))
  75 (element envar ($mono-seq$))
  76 (element filename ($mono-seq$))
  77 (element medialabel ($mono-seq$))
  78 ;;; (The "msgtext" element is handled in another section.)
  79 (element option ($mono-seq$))
  80 ;;; (The "parameter" element is handled in another section.)
  81 (element prompt ($bold-mono-seq$))
  82 (element systemitem ($mono-seq$))
  83 ;;;
  84 ;;; "General purpose" section
  85 (element database ($charseq$))
  86 (element email ($mono-seq$))
  87 ;;; (The "filename" element is handled in another section.)
  88 (element hardware ($mono-seq$))
  89 (element inlinegraphic ($mono-seq$))
  90 ;;; (The "literal" element is handled in another section.)
  91 ;;; (The "medialabel" element is handled in another section.)
  92 ;;; (The "option" element is handled in another section.)
  93 (element optional ($italic-mono-seq$))
  94 ;;; (The "replaceable" element is handled in another section.)
  95 ;;; (The "symbol" element is handled in another section.)
  96 ;;; (The "token" element is handled in another section.)
  97 ;;; (The "type" element is handled in another section.)
  98
  99 </style-specification-body>
 100 </style-specification>
 101
 102 <external-specification id="docbook" document="docbook.dsl">
 103
 104 </style-sheet>