Shaun McCance
shaunm@gnome.org 2008-2009
Provide a title or caption for a multimedia object.

# Abbildungen

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

      mal_block_title ?,
      mal_block_desc ?,
      mal_block +
    }

Use the `figure` element to provide a title or caption for a multimedia object or other block object. To provide a title for the contents of a file, such as a code block, use the `listing` element instead.

# Anmerkungen

The `figure` element contains an optional title element, an optional desc element, and any general block content.

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

# Beispiele

Use `figure` to provide a title and caption for an image:

<figure> <title>Drake</title> <desc>Drake is the Mallard mascot.</desc> <media type="image" mime="image/png" src="figures/mallard.png"/> </figure>

## Drake

Drake ist das Maskottchen von Mallard.

# Processing Expectations

Figures are displayed as block elements, with each of their child elements being interpreted as block elements. When present, the title and description should be displayed in a way that makes their respective roles clear.

# Vergleich mit anderen Formaten

The `figure` is similar to the `figure` element in DocBook. DocBook only provides a title for figures, whereas Mallard distinguishes between a title and a caption.