Shaun McCance
shaunm@gnome.org 2008-2009
Heben Sie die Ausgabe eines Computerprogramms hervor.

# Computerausgaben

    mal_inline_output = element output {
      mal_attr_link ?,
      attribute style { xsd:NMTOKENS } ?,
      attribute * - (mal:* | local:*) { text } *,

      mal_inline
    }

Use the `output` element to mark up text that is output by a computer program. Typically, this is text output in a command-line environment, although you may use the `output` element for computer-generated text in a text box or similar control in a graphical application. For messages and other labels in a graphical applicaiton, use the `gui` element.

You can use the `style` attribute to indicate what type of text is being marked up. Inside a `screen` element, this may be used to format normal text, error text, and prompts differently.

# Anmerkungen

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

The `output` element can occur in any general inline context, including inside most inline elements, some basic block elements, and certain informational elements.

The `output` element can link to other pages or documents. See for more information.

The `style` attribute takes a space-separated list of style hints. Processing tools should adjust their behavior according to those style hints they understand.

Typische Werte für das `style`-Attribut sind:

`output` | Standardausgabe eines laufenden Programms
`error` | Standard-Fehlermeldung eines laufenden Programms
`prompt` | Die Befehlszeile für eine interaktive Shell

The `output` element can have attributes from external namespaces. See for more information on external-namespace attributes.

The `output` element, together with the `input` element, may be used to mark up the contents of a `screen` element, allowing processing tools to treat them differently.

# Beispiele

Use `ouptut` to mark up text generated by a program:

The output of <cmd>echo $SHELL</cmd> is <output>/bin/bash</output> if you use the Bourne-again shell.

Der Befehl echo $SHELL gibt /bin/bash aus, falls Sie die Bourne-Again-Shell verwenden.

Use `output` and `input` inside a `screen` element:

<screen> <output style="prompt">$ </output><input>ls mal_inline_output.xml</input> <output>mal_inline_output.xml</output> </screen>

    $ls mal_inline_output.xml
    mal_inline_output.xml

Verwenden Sie `output` für Fehlermeldungen:

<screen> <output style="prompt">$ </output><input>ls mal.xml</input> <output style="error">ls: mal.xml: No such file or directory</output> </screen>

    $ls mal_inline_computeroutput.xml
    ls: mal_inline_computerouput.xml: No such file or directory

# Processing Expectations

Computer output is displayed in a fixed-width or wide font. Fixed-width fonts tend to have more distinction between visually similar characters. A border or background color may be used to make the beginning and end of the ouptut clear.

# Vergleich mit anderen Formaten

The `output` element is similar to the `computeroutput` element in DocBook. When necessary, the `output` element may be used with the `style` attribute `"prompt"` in place of DocBook's `prompt` element. In some cases, it may be appropriate to use the `output` element with the `style` attribute `"error"` in place of DocBook's `errorname` and `errortext` elements.