Shaun McCance
shaunm@gnome.org 2008-2009
Erstellen Sie eine Liste der Schritte, die ein Benutzer zur Ausführung einer Aufgabe auszuführen hat:

# Prozeduren

    mal_block_steps = element steps {
      attribute style { xsd:NMTOKENS } ?,
      attribute * - (mal:* | local:*) { text } *,

      mal_block_title ?,

      element item {
        attribute style { xsd:NMTOKENS } ?,
        attribute * - (mal:* | local:*) { text } *,

        mal_block +
      } +
    }

Use the `steps` element to create a list of steps the reader should follow. The `steps` element is structurally similar to the `list` element, but marking the list as being instructions to the reader allows special display rules to be applied. If you want a numbered list that is not a procedure, use the `list` element with the `type` attribute to `"numbered"` instead.

# Anmerkungen

The `steps` element can contain an optional `title` element followed by one or more `item` elements. Each child `item` element can contain a mixture of text and any general inline elements.

The `steps` element can occur in any general block context, including inside pages, sections, and certain block elements.

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 `steps` element can have attributes from external namespaces. See for more information on external-namespace attributes.

# Beispiele

Erstellen Sie eine einfache Schritt-für-Schritt-Anleitung, welcher der Leser folgen soll:

<steps> <title>Planting Magic Beans</title> <item><p>Dig a hole 10cm deep.</p></item> <item><p>Place magic beans in the hole.</p></item> <item><p>Fill hole with fertilized soil.</p></item> <item><p>Water frequently.</p></item> </steps>

## Anbau magischer Bohnen

Graben Sie ein 10 cm tiefes Loch.

Legen Sie magische Bohnen in das Loch.

Fill hole with fertilized soil.

Gießen Sie gelegentlich.

Erstellen Sie eine Prozedur mit einer verschachtelten Liste und einer verschachtelten Prozedur:

<steps> <title>Planting Magic Beans</title> <item> <p>Perform one of the following:</p> <list> <item><p>Dig a whole 10cm deep.</p></item> <item><p>Find a whole 10cm deep.</p></item> </list> </item> <item><p>Place magic beans in the hole.</p></item> <item><p>Fill hole with fertilized soil.</p></item> <item> <p>Water frequently with the following steps:</p> <steps> <item><p>Fill watering can with water.</p></item> <item><p>Pour water onto spot where beans were planted.</p></item> </steps> </item> </steps>

## Anbau magischer Bohnen

Führen Sie eine der folgenden Aktionen aus:

Graben Sie ein 10 cm tiefes Loch.

Finden Sie ein 10 cm tiefes Loch.

Legen Sie magische Bohnen in das Loch.

Fill hole with fertilized soil.

Wässern Sie gelegentlich folgendermaßen:

Füllen Sie eine Gießkanne mit Wasser.

Gießen Sie Wasser auf die Stelle, an der die Bohnen gepflanzt wurden.

# Processing Expectations

Procedures are displayed as block elements, with each child `item` displayed as a numbered list item. When present, the `title` element should be displayed in a way that makes it clear that it is the title of the list. List items are interpreted in the same way as `li` elements in HTML, except that the `item` element only allows block-level child content.

Procedures should have a background color, border, or other styling effect to clearly differentiate them from basic numbered lists. Special styling allows readers to skim pages more easily.

# Vergleich mit anderen Formaten

Das `steps`-Element ähnelt dem `procedure`-Element in DocBook. Beachten Sie die folgenden Unterschiede:

Anstelle eines separaten `step`-Elements verwendet Mallard einfach das allgemeine `item`-Element für jeden Schritt.

DocBook provides an explicit `substeps` element. Mallard provides no such element; simply nest `steps` elements for the same effect.

Mallard bietet keine Entsprechung zum `stepalternatives`-Element. Verwenden Sie eine `einfache Pfeilliste`, falls nötig, mit einem einführenden Text.

DocBook allows leading block-level content in the `procedure` element. This is not allowed in Mallard, though an optional `title` element is allowed.