Shaun McCance
shaunm@gnome.org 2007-2009
Mark up a key to be pressed on the user's keyboard.

# Zugriffstaste

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

      mal_inline
    }

Use the `key` element to mark up a key on the keyboard. You can use this for letter keys, such as Q, or for keys with names, such as Ctrl. Generally, the contents of the `key` element should be what is printed on the physical key, although it may be a textual description for keys with symbols printed on them.

Do not use `key` to mark up a class of keys, such as arrow keys. These do not require markup in running prose. Inside a `keyseq` element, you are allowed to use text without a `key` element exactly for this purpose.

Do not use `key` to mark up a symbolic key code or a numeric key value; if necesarry, use `sys` for these instead.

# Anmerkungen

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

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

The `key` element can also occur inside the `keyseq` element, where it has special meaning.

The `key` 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.

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

# Beispiele

Verwenden Sie `key`, um eine Buchstabentaste hervorzuheben:

Press <key>M</key> to mark the selected message as read.

Drücken Sie M, um die ausgewählte Nachricht als gelesen zu markieren.

Verwenden Sie `key`, um eine Funktionstaste hervorzuheben:

Press <key>F9</key> to check for new messages.

Drücken Sie F9, um nach neuen Nachrichten zu sehen.

Use `key` to refer to a specific key by a textual description:

Press the <key>Down</key> key to select the next item.

Drücken Sie die Taste Pfeiltaste ab, um das nächste Objekt auszuwählen.

# Processing Expectations

No particular special rendering is required for `key` elements. Keys may be rendered with lightened text or other sublte styling effects to distinguish them from the surrounding text.

# Vergleich mit anderen Formaten

Das `key`-Element ähnelt dem `keycap`-Element in DocBook. Mallard stellt keine Elemente bereit, die den DocBook-Elementen `keysym` und `keycode` entsprechen. In den meisten Fällen können diese einfach mit einem `sys`-Element hervorgehoben werden.