Omni Systems, Inc.

  

Mif2Go User's Guide, Version 33u53

  

Valid HTML 4.01!

 

Made with Mif2Go

16 Producing DocBook XML > 16.5 Nesting DocBook block elements > 16.5.7 Specifying full ancestry for nested sections


16.5.7 Specifying full ancestry for nested sections

When you have nested DocBook sections you must specify parentage starting with $top for every section title. For example:

[DocBookParents]

Heading1 = $top section

Heading2 = $top section section

Heading3 = $top section section section

Heading4 = $top section section section section

Otherwise, the higher levels would also match the rule for the lower levels; so, for example, the following settings:

[DocBookParents]

Heading1 = section

Heading2 = section section

would allow another Heading1 section to follow a Heading2 section without closing the lower-level Heading2 section. The starting $top prevents this.

In addition, you would need to specify:

[DocBookFirst]

Heading* = section

so that each heading starts a new section when it occurs at the same level as the preceding section. Otherwise a second Heading2 section would be valid inside the first Heading2 section, and would not close that section and start a new section of its own at the same level.

See also:

§16.5.5 Specifying alternate ancestries for the same element

§16.5.6 Specifying first-child status for nested elements



16 Producing DocBook XML > 16.5 Nesting DocBook block elements > 16.5.7 Specifying full ancestry for nested sections