section — A recursive section
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
)*)
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. The
simplesect
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. You can place paragraphs and other block elements before a section, but you cannot place anything after it.
Formatted as a displayed block. Sometimes sections are numbered.
Use of deeply nested section
s may cause
problems in some processing systems.
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 section</title> <para>This <tag>article</tag> uses recursive sections.</para> <section> <title>Like a Sect1</title> <subtitle>Or How I Learned to Let Go of Enumeration and Love to Recurse</subtitle> <info> <abstract> <para>A trivial example of recursive sections.</para> </abstract> </info> <para>This section is like a Sect1.</para> <section><title>Like a Sect2</title> <para>This section is like a Sect2.</para> <section><title>Like a Sect3</title> <para>This section is like a Sect3.</para> <section><title>Like a Sect4</title> <para>This section is like a Sect4.</para> <section><title>Like a Sect5</title> <para>This section is like a Sect5.</para> <section><title>Would be like a Sect6</title> <para>This section would be like a Sect6, if there were one.</para> <section><title>Would be like a Sect7</title> <para>This section would be like a Sect7, if there was one.</para> </section> </section> </section> </section> </section> </section> </section> </article>