Shaun McCance
shaunm@gnome.org 2007-2009
Provide a caption for a formal block element.

# Blockbeschreibungen

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

      mal_inline
    }

The `desc` element marks a short text description for formal block elements like figure. The description provided by `desc` is formatted as a caption for the formal element.

# Anmerkungen

The `desc` element can contain a mixture of text and any general inline elements.

Das `desc`-Element kann in den formalen Block-Elementen `figure`, `listing` und `synopsis` vorkommen.

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

The `desc` element can also be used in an informational context. See for more information.

# Beispiele

Use `desc` to provide a caption for a figure:

<figure> <desc>Drake, the Mallard mascot</desc> <media type="image" mime="image/png" src="figures/mallard.png"/> </figure>
Drake, das Maskottchen von Mallard

Use `desc` to provide a caption for a listing:

<listing> <desc>A first Mallard page</desc> <code><![CDATA[ <page xmlns="http://projectmallard.org/1.0/" type="guide" id="index"> <!-- Content goes here --> </page>]]></code> </listing>
Eine erste Mallard-Seite
<page xmlns="http://projectmallard.org/1.0/" type="guide" id="index"> <!-- Content goes here --> </page>

Weitere Beispiele finden Sie in den Seiten , und .

# Processing Expectations

The exact display of a description will depend on how the enclosing formal element is displayed. A description is a block of text that is displayed directly above or below the normal contents of the enclosing element.

A description should be displayed in a way that makes its role clearn and which clearly distinguishes it from the normal block content of the enclosing element.