XML-Technologien / DocBook / Inline-Elemente / Tastenspezifische Elemente

Tastenspezifische Elemente

(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)

In vielen Programmen gibt es Funktionen, die über Tastenkombinationen erreichbar sind. Diese "Hotkeys" können auch in DocBook ausgezeichnet werden. Zu der Kategorie der tastenspezifischen Elemente zählen:

accel: Ein Tastenkürzel in einer GUI:

<para>Sichern Sie Ihre Daten mittels <guimenu><accel>S</accel>peichern</guimenu>.</para>

Ergebnis: Sichern Sie Ihre Daten mittels Speichern als....

keycap: Eine Taste (siehe Erklärung weiter unten).

keycode, keysym: Ein interner Bezeichner (keycode) für eine Taste, häufig nummerisch und ein symbolischer Name (keysym):

<para><keycap>F1</keycap> entspricht <keycode>0x3B</keycode> und hat den symbolischen Namen <keysym>KEY_F1</keysym> ...</para>

Beispiele zu keycap:

<keycombo>
  <keycap>Strg</keycap>
  <keycap>C</keycap>
</keycombo>

Es bietet sich an, bei allgemeingültigen Tasten wie Strg, Alt und andere das Attribut function zu verwenden (erst ab DocBook 4.3 verfügbar):

<keycombo>
  <keycap function="ctrl">Strg</keycap>
  <keycap>C</keycap>
</keycombo>

Dies erhöht die Konsistenz Ihrer Dokumente. Falls Sie Ihre Dateien übersetzen müssen, bedeutet dies weniger Arbeit für Ihre Übersetzer. Als Ergebnis erhält man: Strg + C. Zwischen Strg und C wird ein Zusatzzeichen eingefügt, das je nach Konvention sehr unterschiedlich aussehen kann. Durch das Attribut action in keycap oder keycombo beeinflussen Sie dieses Zeichen. Folgende Werte sind erlaubt:

click: kennzeichnet eine Kombination, bei der mit der Maustaste einmal geklickt werden muss, möglicherweise zusammen mit einer zusätzlichen Taste.
double-click: wie bei Option click, jedoch muss die Maustaste zweimal kurz hintereinander (so genannter "Doppelklick") gedrückt werden.
press: Ein Mausklick oder Tastendruck.
seq: Sequenz, das heißt, die Tasten werden mit einem zeitlichen Abstand und nicht zusammen gedrückt.
simul: Gleichzeitige Tastendrücke oder Mausklicks.
other: Eine andere, nicht standardisierte Aktion, die über das Attribut otheraction genauer identifiziert wird.

Um Emacs-Tastenkombinationen auszuzeichnen gibt man ein:

<para>Die Tastenkombination zum Speichern in Emacs lautet:
 <keycombo action="seq">
  <keycombo action="press">
    <keycap>C</keycap><keycap>x</keycap>
  </keycombo>
  <keycombo action="press">
    <keycap>C</keycap><keycap>s</keycap>
  </keycombo>
...</para>

Das Ergebnis sieht so aus: Strg-x Strg-s.

shortcut: Eine Tastaturkombination, die auch über einen Menüpunkt aktiviert werden kann (siehe GUI-spezifische Elemente).

<< zurück

vor >>

Tipp der data2type-Redaktion:
Zum Thema DocBook bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

DITA
XSLT

Copyright © 2009 Millin Verlag
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

Millin Verlag, Siebengebirgsring 36, 53797 Lohmar, info(at)millin.de