Name
section — A recursive section
Synopsis
section ::=
((((title
&
titleabbrev
? & subtitle
?),
info
? db.titleforbidden.info) |
info
db.titlereq.info),
(((annotation
| bridgehead
|
remark
| revhistory
| Indexing inlines | Admonition elements | Formal elements | Graphic elements | Informal elements | List elements | Paragraph elements | Publishing elements | Synopsis elements | Technical elements | Verbatim elements)+,
((section
+, simplesect
*) |
simplesect
+ | refentry
+)?) |
(section
+, simplesect
*) |
simplesect
+ | refentry
+),
(bibliography
| glossary
|
index
| toc
)*)
Additional constraints
If this element is the root element, it must have a
version
attribute.
Description
A section
is one of the top-level sectioning
elements in a component. There are three types of sectioning elements in
DocBook:
Explicitly numbered sections,
sect1
…sect5
, which must be properly nested and can only be five levels deep.Recursive
section
s, which are an alternative to the numbered sections and have unbounded depth.simplesect
s, which are terminal. Thesimplesect
s can occur as the “leaf” sections in recursive sections or any of the numbered sections, or directly in components.
The section
element may be more convenient than
numbered sections in some authoring environments because instances can
be moved around in the document hierarchy without renaming.
None of the sectioning elements is allowed to “float” in a component. ...
Get DocBook 5: The Definitive Guide now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.