This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: errors ... but where
- From: Bob Stayton <bobs at caldera dot com>
- To: "Grobe, Gary" <Gary_Grobe at bmc dot com>,"'docbook at lists dot oasis-open dot org'" <docbook at lists dot oasis-open dot org>
- Date: Wed, 07 Aug 2002 13:55:53 -0700
- Subject: Re: DOCBOOK: errors ... but where
- References: <3DAC9CD31458D411BCE700D0B75D0A13035F609F@ES09-HOU.bmc.com>
On Wed, Aug 07, 2002 at 10:16:38AM -0500, Grobe, Gary wrote:
> Ok, just a bit confused on the way I'm reading the DocBook Element
> References now. The ref page for <sect1> says it takes <bridgehead> as a
> child. Doesn't that mean that I can nest <bridgehead> inside a <sect1> tag
> ... as follows?
>
> <sect1>
> <bridgehead>Test</bridgehead>
> <para>test</para>
> </sect1>
No, the ordering of children matters to some degree.
The "Children" section in the reference doesn't
provide ordering information. The "Content Model"
section does. See the section "Understanding Content
Models" to figure it out.
Basically the order after the sect1 start tag is:
1. optional sect1info
2. required title, optional subtitle, optional titleabbrev
3. optional toc, lot, etc.
4. a mix of other content (including bridgehead).
The only required child is title.
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
Caldera International, Inc. fax: (831) 429-1887
email: bobs@caldera.com