Shaun McCance
shaunm@gnome.org 2008-2009
Teilen Sie die Seiten in logische Abschnitte, um den Leser beim schnellen Finden von Information zu unterstützen.

# Abschnitte

    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.

# Anmerkungen

Das `section`-Element enthält ein optionales `info`-Element, ein `title`-Element, weiteren allgemeinen Block-Inhalt und eine Reihe von `section`-Elementen.

Das `section`-Element kann in `page`-Elementen und anderen `section`-Elementen vorkommen.

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 for more information on external-namespace attributes.

# Processing Expectations

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 and for more information. Sections in guide pages have topic links inserted following their block content. See for more information.