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
versionattribute.
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
sections, which are an alternative to the numbered sections and have unbounded depth.simplesects, which are terminal. Thesimplesects 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. ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access