From owner-freebsd-doc  Tue Sep  2 10:25:05 1997
Return-Path: <owner-freebsd-doc>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id KAA17154
          for doc-outgoing; Tue, 2 Sep 1997 10:25:05 -0700 (PDT)
Received: from fallout.campusview.indiana.edu (fallout.campusview.indiana.edu [149.159.1.1])
          by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id KAA17149
          for <freebsd-doc@FreeBSD.ORG>; Tue, 2 Sep 1997 10:25:01 -0700 (PDT)
Received: from localhost (jfieber@localhost)
	by fallout.campusview.indiana.edu (8.8.5/8.8.5) with SMTP id MAA06480;
	Tue, 2 Sep 1997 12:17:19 -0500 (EST)
Date: Tue, 2 Sep 1997 12:17:19 -0500 (EST)
From: John Fieber <jfieber@indiana.edu>
To: nik@iii.co.uk
cc: A Joseph Koshy <koshy@india.hp.com>, freebsd-doc@FreeBSD.ORG
Subject: Re: Docbook tools?
In-Reply-To: <19970902110518.05385@strand.iii.co.uk>
Message-ID: <Pine.BSF.3.96.970902121146.6383D-100000@fallout.campusview.indiana.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-freebsd-doc@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk

On Tue, 2 Sep 1997 nik@iii.co.uk wrote:

> I don't use the HTML generation, since it takes a DocBook <book> and turns
> it into multiple HTML files. I prefer the single file approach of instant,
> hence the hybrid approach above.

My HTML stylsheet assums that a <book> is actually a book-length
thing and divides on chapters.  The FreeBSD handbook as a single
HTML file is nearly a megabyte an not much fun to manipulate in
your typical browser.

For shorter things, use

<!DOCTYPE article PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
<article>
<artheader>
...
</artheader>
...
</article>

which will generate a single file for the main text.
Unfortunately this approach doesn't work if you want to use
sgmlfmt as the transpecs don't correctly handle articles.

-john