mal_section = element section {
attribute id { xsd:ID },
attribute style { xsd:NMTOKENS } ?,
attribute * - (mal:* | local:*) { text } *,
mal_info ?,
mal_block_title,
mal_block *,
mal_section *
}A section is a prominent logical part of a page or another section. Breaking up material into sections can help readers find information more quickly. In Mallard, sections can take part in automatic linking just as pages can.
The section element contains an optional info element, a title element, any general block content, and any number of section elements.
The section can occur in page elements and other section elements.
The id attribute takes a unique identifier. It should be distinct from all other id attributes in the same page, including those on other section elements and on the containing page element.
The style attribute takes a space-separated list of style hints. Processing tools should adjust their behavior according to those style hints they understand.
The section element can have attributes from external namespaces. See External Namespaces for more information on external-namespace attributes.
Each section is displayed as a block. The title of a section is displayed prominently, followed by any child block content, and finally by each child section. Note that automatic links, style hints, or other special features may insert material or change the way pages are displayed. Sections should be clearly separated from their surrounding content to make the beginning and ending of each section obvious. The depth of each section should be clear, although this may not be feasible for deeply nested sections.
Sections may have links associated with them. All sections should have guide links and see also links displayed when applicable. See Guide Links and See Also Links for more information. Sections in guide pages have topic links inserted following their block content. See Topic Links for more information.