◇◆
<section> Section
A major division or subdivision of the text.
Usage/Remarks
Display/Formatting Note
No label (such as a number) is generated to precede a section title. If labeled sections
are desired (which is not recommended), the label must be included as part of the
title. Using labeled sections titles, however, may create display issues for cross-references
to sections.
Typically, no @xreflabel is present. A cross-reference (<xref>) to a section will display the generated word “section” and, in generated quotation
marks, the section title. If needed, brackets or other types of punctuation to enclose
the entire cross-reference must be present in the narrative text.
If an @xreflabel exists, an <xref> to the section will display only the @xreflabel value as the text of the cross-reference; punctuation to enclose the cross-reference
must be present in the narrative text.
Models and Context
May be contained in
Description
Expanded Content Model
(title, subtitle?, (blockquote | equation | figure | informaltable | itemizedlist | mediaobject | note | orderedlist | para | programlisting | table | variablelist)*, section*)
Tagged Sample
Section with recursive sub-sections
... <section xml:id="mul2"> <title>Securing a Permanent Colony in the Claimed Lands</title> <para>With land claimed in the New World, an expedition was mounted to establish a settlement. The first expedition failed. ...</para> ... </section> <section xml:id="mul3"> <title>Native Inhabitants of the New World</title> <para>Upon establishing the Roanoke colony, the settlers ...</para> </section> <section xml:id="mul4"> <title>Native Plants and Wildlife</title> <para>... The settlers discovered that while some roots could be eaten much in appearance as they were dug, others had to be boiled before use as a foodstuff. As more fully described below, other plants included beans, and several crops previously unknown to the Europeans: <itemizedlist> <listitem> <para><quote>macocqwer</quote> (gourds),</para> </listitem> <listitem> <para><quote>melden</quote> (an herb),</para> </listitem> <listitem> <para><quote>planta solis</quote> (sunflower — used in a type of bread, as well as for broth),</para> </listitem> <listitem> <para>peas (powdered in a mortar), and</para> </listitem> <listitem> <para>potatoes.</para> </listitem> </itemizedlist> </para> <section xml:id="mul4-1"> <title>Gourds</title> <para>The native people grew a variety of large broad-leafed, ground-covering vines which produced what they called <quote>macocqwer</quote> or gourds. (<emphasis role="ital">See</emphasis> <xref linkend="mul-fig1"/>.) Varying in color among shades of green, yellow, and orange, these gourds served a number of functions, not chief of which was as a food source. ...</para> ... </section> ... </section> ...