Re: db2html

[Raja R Harinath <harinath cs umn edu>]

Dan Hensley <dan.hensley@att.net> writes:
> allbery@ece.cmu.edu wrote:
> > On 16 Sep, Andreas Buesching wrote:
> > | Can anyone tell me were I can find this tool 'db2html', beaucse I need
> > | it for gnome-core install.
> >
> > More specifically, gnome-core/gnome-terminal/no fails to build; it
> > unconditionally requires db2html.
> 
> I'm not sure why it fails to build--I don't have db2html either, but
> I haven't had any problems compiling--I just don't get help files.
> By the way, good luck getting this question answered.  The FAQ is
> pretty sparse on this subject, and looking through the past few
> months, I've noticed that the question has come up several times,
> with (almost?) no responses.  I recall seeing one response that was
> basically to create a simple script wrapper around jade, but now I
> can't seem to find it.

For Linux, you can get `db2html' from:

  * DocBook RPMs at http://sourceware.cygnus.com/docbook-tools/
  * `cygnus-stylesheets' package on Debian
  * I think a package called `sgmltools-2' for SuSE

For other systems, here's my homegrown `db2html' and DSSSL driver file
that customizes the "Norman Walsh Modular DocBook DSSSL Stylesheets".
(This assumes that you already have a sane SGML setup, with all the
right catalog files, and of course, the DocBook stylesheets).

#! /bin/sh

db2x_dir=$HOME/lib/sgml/db2x
html_stylesheet=$db2x_dir/docbook-html-override.dsl
html_css=$db2x_dir/docbook.css

case $1 in
/*) input=$1 ;;
*) input=`pwd`/$1 ;;
esac

test -f $input || exit 1

output=`echo $input | /bin/sed -e 's,.*/,,' -e 's,\.sgml$,,;s,\.sgm$,,'`

test -z "$output" && exit 1

test -d ${output}.old && rm -rf ${output}.old
test -d $output && mv $output ${output}.old
mkdir $output

cd $output
cp $html_css .
jade -t sgml -d $html_stylesheet $input

exit 0

The `docbook-html-override.dsl' mentioned there is:

<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY dbhtmlstyle PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL>
]>

<style-sheet>
<style-specification use="docbook">
<style-specification-body>

;; These are some customizations to the HTML output produced by the
;; Modular DocBook Stylesheets <URL:http://nwalsh.com>

(define %html-ext% ".html")
(define %use-id-as-filename% #t)
(define %stylesheet% "docbook.css")
(define %shade-verbatim% #t)

</style-specification-body>
</style-specification>

<external-specification id="docbook" document="dbhtmlstyle">

</style-sheet>

This is essentially a repost of an earlier message I posted in July,
but the archive seems to be missing my message -- maybe it cannot
handle attachments.

- Hari
-- 
Raja R Harinath ------------------------------ harinath@cs.umn.edu
"When all else fails, read the instructions."      -- Cahn's Axiom
"Our policy is, when in doubt, do the right thing."   -- Roy L Ash