section
section — A recursive section.
Synopsis
section ::= ![[-]](figs/web/nav/down.gif)
![[+]](figs/web/nav/right.gif)
- Sequence of:
- One of:
- One of:
- Sequence of:
- One or more of:
bridgeheaddialoguedramapoetryremarkrevhistory- Indexing inlines
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
- List elements
- Paragraph elements
- Publishing elements
- Technical elements
- Verbatim elements
- Optionally one of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- One or more of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- Zero or more of:
- One of:
Attributes
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
two
types of sectioning elements in DocBook:
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. You can place paragraphs and other block elements before a section, but you cannot place anything after it.
Processing expectations
Formatted as a displayed block. Sometimes sections are numbered.
Use of deeply nested sections may cause problems in
some processing systems.
Attributes
Common attributes and common linking attributes.
- label
Specifies an identifying string for presentation purposes
- status
Identifies the editorial or publication status of the element on which it occurs
Children
The following elements occur in section: address, anchor, bibliography, bibliolist, blockquote, bridgehead, calloutlist, dialogue, drama, epigraph, equation, example, figure, formalpara, glossary, glosslist, index, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titlereq.info), informalequation, informalexample, informalfigure, informaltable, itemizedlist, literallayout, mediaobject, note, orderedlist, para, poetry, procedure, qandaset, remark, revhistory, section, sidebar, simpara, simplelist, simplesect, subtitle, table, task, title, titleabbrev, toc, variablelist.
See Also
bridgehead, sect1, sect2, sect3, sect4, sect5, simplesect
Examples
<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>