simplesect — A section of a document with no subdivisions
simplesect ::=
((((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)+)
A simplesect
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 alternatives
to the numbered sections and have unbounded depth.
simplesect
s, which are terminal. The
simplesect
s can occur as the “leaf”
sections in either recursive sections or any of the numbered
sections, or directly in components.
None of the sectioning elements is allowed to “float” in a component. You can place paragraphs and other block elements before a section, but you cannot place anything after it.
The important semantic distinction of
simplesect
elements is that they never appear in the
table of contents.
Formatted as a displayed block. A simplesect
element never appears in the table of
contents.
Common attributes and common linking attributes.
Specifies an identifying string for presentation purposes
Identifies the editorial or publication status of the element on which it occurs
<article xmlns='http://docbook.org/ns/docbook'> <title>Example simplesect</title> <section><title>Additional Coding</title> <para>Support for the additional features requested will be provided. </para> <simplesect><title>Estimated Time</title> <para>2 to 3 weeks. </para> </simplesect> </section> </article>