DB 3.1 -?-> DB 4.1

[Bob Bernstein <poobah@ruptured-duck.com>]

I am struggling with a mystifying change in behaviour in how DocBook and its
HTML stylesheets output the HTML files. I have a potato system but wanting to
go to DB 4.1 I installed the woody debs for that, and the stylesheets from
woody also.

With DB 3.1 I was used to jade outputting the chunked HTML files for, say
"newsite.sgml", to the directory '../newsite' without any intervention on my
part. I did *not* have any mention of out-dir or use-output-dir in my
stylesheet driver file. 

Now I find that jade outputs good HTML, properly chunked, but the files wind
up in the same directory as the source SGML. No amount of tweaking with
use-output-dir or output-dir seems to have any effect on this. My guess is I
have addled something in the process of installing the new debs. Here's my
driver file (a little untidy, sorry!):

--- snip ---

<!--
    html.dsl - stylesheets for HTML output.

    $Id: html.dsl,v 1.6 1999/04/15 18:14:22 cdegroot Exp $

    SGMLtools - an SGML toolkit.
    Copyright (C) 1998 Cees A. de Groot
  
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
  
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
  
    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  
  -->
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML
Stylesheet//EN" CDATA dsssl>
]>
<style-sheet>

<style-specification id="html" use="docbook">
<style-specification-body> 
    ;;
    ;;  This is the standard HTML stylesheet, which deviates only a little bit
    ;;  from the plain version.
    ;;
    (define %html-ext% ".html")

    (define %root-filename% "index")
    (define use-output-dir #t)
    (define %output-dir% "/home/wingnut/jtan_site/newsite")

    (define %body-attr% 
    ;;  http://www.htmlgoodies.com/colors.html
    ;; What attributes should be hung off of BODY?
    (list
    ;; (list "BGCOLOR" "#FFF8DC")
    (list "BGCOLOR" "#FFFFF0")
    (list "TEXT" "#000000")))

    ;; turn this off!   
    (define %shade-verbatim% #f)
    (define %use-id-as-filename% #t)

    (define %graphic-default-extension% "gif")
    ;; rem'd out by me:
    (define %admon-graphics% #t)
    
    
    ;; added by me for snort:
    ;; (define %generate-article-toc% #t)

  ;; do we need this here?
  ;; (define $generate-chapter-toc$ 
  ;; Should a Chapter Table of Contents be produced?
  ;; (lambda ()
  ;;  (or (not nochunks)
  ;; (node-list=? (current-node) (sgml-root-element)))))

 (define nochunks
  ;; Suppress chunking of output pages
  #f)

 (define %gentext-nav-use-tables%
  ;; Use tables to build the navigation headers and footers?
  #t)

(define %spacing-paras%
  ;; Block-element spacing hack
  #t)

 (define %gentext-nav-tblwidth% 
  ;; If using tables for navigation, how wide should the tables be?
  "80%") 
  
 (define %stylesheet% "myOldstyle.css")
 (define %stylesheet-type% "text/css")
	  
</style-specification-body>
</style-specification>


<style-specification id="howto" use="html">
<style-specification-body>
    ;;
    ;;  This stylesheet tries to get a bit closer to what people are used to
from
    ;;  SGMLtools 1.0.
    ;;
    (define %generate-article-toc% #t)
</style-specification-body>
</style-specification>

<external-specification id="docbook" document="docbook.dsl">
</style-sheet>

--- snip ---

One more question:

I notice in the stylesheet docs mention of 'dbhtml PI's. I understand these
are statements of the form

<?dbhtml output-dir="/home/wingnut/jtan_site/newsite">

but I cannot for the life of me find any discussion anywhere of how to use
them. Would a statement like the one above go in a stylesheet?














--
Bob Bernstein                  http://www.ruptured-duck.com