From owner-freebsd-doc  Mon Jul 20 04:21:47 1998
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Received: (from majordom@localhost)
          by hub.freebsd.org (8.8.8/8.8.8) id EAA22440
          for freebsd-doc-outgoing; Mon, 20 Jul 1998 04:21:47 -0700 (PDT)
          (envelope-from owner-freebsd-doc@FreeBSD.ORG)
Received: from tyree.iii.co.uk (tyree.iii.co.uk [195.89.149.230])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id EAA22432
          for <freebsd-doc@FreeBSD.ORG>; Mon, 20 Jul 1998 04:21:45 -0700 (PDT)
          (envelope-from nik@iii.co.uk)
From: nik@iii.co.uk
Received: from carrig.strand.iii.co.uk (carrig.strand.iii.co.uk [192.168.7.25])
	by tyree.iii.co.uk (8.8.8/8.8.8) with ESMTP id MAA04308;
	Mon, 20 Jul 1998 12:20:42 +0100 (BST)
Received: (from nik@localhost)
	by carrig.strand.iii.co.uk (8.8.8/8.8.7) id MAA12267;
	Mon, 20 Jul 1998 12:19:45 +0100 (BST)
Message-ID: <19980720121943.12887@iii.co.uk>
Date: Mon, 20 Jul 1998 12:19:43 +0100
To: "Jordan K. Hubbard" <jkh@time.cdrom.com>
Cc: Sue Blake <sue@welearn.com.au>, freebsd-doc@FreeBSD.ORG
Subject: Re: tricky handbook link
References: <19980718123833.60504@welearn.com.au> <21608.900732186@time.cdrom.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Mailer: Mutt 0.85e
In-Reply-To: <21608.900732186@time.cdrom.com>; from Jordan K. Hubbard on Fri, Jul 17, 1998 at 08:23:06PM -0700
Organization: interactive investor
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

On Fri, Jul 17, 1998 at 08:23:06PM -0700, Jordan K. Hubbard wrote:
> The latest docbook DTD also makes implicit labels for section headings
> and such now, so you get "free" labels without having to declare all
> of them explicitly.

Not quite. 

As it currently stands, the DSSSL stylesheet for DocBook that we're 
currently using will break the documentation into different HTML files for 
chapters, sections and so on.

By default, it uses a numbering scheme, so sect01.html, sect02.html, and
so on.

If your sections, chapters and so forth include the 'id' attribute like so

    <sect1 id="nutshell">
      <title>FreeBSD in a Nutshell</title>

      ...
    </sect1>

then the stylesheet will instead name this file "nutshell.html", *if* you
customise the stylesheet and add the lines

    (define %use-id-as-filename%
        ;; Use ID attributes as name for component HTML files?
        #t)

I've done this to the current doc/sgml/freebsd.dsl file, which is why the
current snapshot of the DocBook Handbook at 

    <URL:http://www.freebsd.org/%7enik/handbook/>

has files like "bibliography01.html", "bibliography02.html" and so on. 

Note that chapters, sections and so on that do not have an ID attribute are
named with a numbering scheme, hence the existance of "c09.html", "c12.html"
and so on.

N
-- 
Work: nik@iii.co.uk                       | FreeBSD + Perl + Apache
Rest: nik@nothing-going-on.demon.co.uk    | Remind me again why we need
Play: nik@freebsd.org                     | Microsoft?

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message