Re: [docbook] Reference sectioning

["Bob Stayton" <bobs@sagehill.net>]

Hi Marco,
Using sections at multiple levels to contain refentry pages is perfectly ok.
That's why the section elements permit refentry.

But keep in mind that once you have a refentry in a given section, you can't
follow it with any subsections within that section.  In other words, your
refentry elements have to be in section elements that are terminal leaves in
your hierarchy.

You might wonder why this restriction exists.  I think it is because a
refentry is itself a type of section, and the DocBook DTD doesn't permit
mixing different types of sections as siblings.  The simplesect element has
the same restriction.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Marco Correia" <mvc@netcabo.pt>
To: "Docbook List" <docbook@lists.oasis-open.org>
Sent: Friday, February 25, 2005 12:48 PM
Subject: [docbook] Reference sectioning


> Hi,
>
> I'm creating a huge set of reference pages and I would like to have them
> organized in sections (in a tree structure). I'm using multiple
<reference>
> blocks but that gives me only level 1 sectioning since <reference>
elements
> cannot be nested. Using nested <section>s seems the only way, but...
>
> is there a better way?
>
> -- 
> Marco Correia <mvc@netcabo.pt>
>
>