26.5.8.2 Ending ancestor elements after the current block

In some cases, it is not clear whether the end of a block element should also end the enclosing parent element. To close a parent element at the end of the current block element (for example):

[DocBookCloseAfter]
; para format = parent to be closed, with any other elements
;  nested under it, at the end of the current block element.
FigAnchor = figure

Use this setting to force closure of elements that were opened based on settings in [DocBookParents]; see §26.5.2 Designating DocBook ancestor elements. You can list as many possible ancestors as necessary; order is not important.

For individual cases, you can insert a DocBookCloseAfter PI marker in the paragraph for the current block element instead, with content the name(s) of the ancestor element(s) to close. You can also use a DocBookCloseAfter PI marker to override a [DocBookCloseAfter] setting when you want to close a higher (or lower) ancestor than the setting specifies.

Previous Topic:  26.5.8.1 Ending ancestor elements before the current block

Next Topic:  26.5.9 Opening DocBook ancestor elements

Parent Topic:  26.5.8 Closing DocBook ancestor elements

Sibling Topics:

26.5.8.1 Ending ancestor elements before the current block

Table of ContentsIndex