Benutzerschnittstellen

Benutzerschnittstellen
	Software-spezifische Elemente

Der Begriff Benutzerschnittstellen bedeutet nicht zwangsläufig graphische Benutzeroberflächen, so ist es möglich, Kommandos für Kommando-basierte Schnittstellen mit dem Element cmdsynopsis zu Beschreiben und das Element command allein zu benutzen, um Kommandos im Fließtext hervorzuheben.

Beispiel 2.38. Der Befehl cd

<!DOCTYPE cmdsynopsis PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<cmdsynopsis>
  <command>cd</command>
  <arg choice='req'><replaceable>directory</replaceable></arg>
</cmdsynopsis>

Im fertigen Dokument wird das Beispiel folgendermaßen dargestellt:

cd {directory}

hier wurden noch die Elemente arg für Argument mit dem Attribut choice und Wert „req“ (Es handelt sich um ein erforderliches Argument) und replaceable (der Text directory kann ausgetauscht werden) verwendet.

Das Ergebnis, welches der Computer liefert, kann dann entweder, wenn es wenige Zeilen hat, und es auf das Layout nicht unbedingt ankommt, mit dem Element computeroutput gekapselt werden, oder wenn es sich eher um eine Art-ASCII-Screenshot handelt, also auch das Layout von Bedeutung ist, dann ist screen besser geeignet. Auch für das Element screen können mit screenco markierte Bereiche genutzt werden.

Beispiel 2.39. Ein Verzeichnisinhalt anzeigen

<!DOCTYPE screen PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<screen>
C:\cygwin&gt;dir
 Volume in drive C has no label.
 Volume Serial Number is A09D-616F

 Directory of C:\cygwin

24.11.2002  08:43    &lt;DIR&gt;          .
24.11.2002  08:43    &lt;DIR&gt;          ..
24.11.2002  11:05    &lt;DIR&gt;          bin
24.11.2002  08:43                57 cygwin.bat
24.11.2002  11:25               766 cygwin.ico
24.11.2002  08:44    &lt;DIR&gt;          etc
24.11.2002  11:05    &lt;DIR&gt;          lib
24.11.2002  08:43    &lt;DIR&gt;          tmp
24.11.2002  11:05    &lt;DIR&gt;          usr
24.11.2002  08:43    &lt;DIR&gt;          var
               2 File(s)            823 bytes
               8 Dir(s)  18.758.246.400 bytes free

C:\cygwin>&gt;
</screen>

Keinen großen Unterschied macht die Darstellung im Dokument:

C:\cygwin>dir
 Volume in drive C has no label.
 Volume Serial Number is A09D-616F

 Directory of C:\cygwin

24.11.2002  08:43    <DIR>          .
24.11.2002  08:43    <DIR>          ..
24.11.2002  11:05    <DIR>          bin
24.11.2002  08:43                57 cygwin.bat
24.11.2002  11:25               766 cygwin.ico
24.11.2002  08:44    <DIR>          etc
24.11.2002  11:05    <DIR>          lib
24.11.2002  08:43    <DIR>          tmp
24.11.2002  11:05    <DIR>          usr
24.11.2002  08:43    <DIR>          var
               2 File(s)            823 bytes
               8 Dir(s)  18.758.246.400 bytes free

C:\cygwin>

Es gibt eine Reihe von Elementen zur Beschreibung von GUIs

Für die Teile einer echten GUI gibt es verschiedenste Elemente. Wenn der Benutzer eine Aktion auf einer grafischen Benutzeroberfläche ausführen möchte, so kann er auf Piktogramme (guiicon) oder Druckknöpfe (guibutton) klicken. Außerdem hat er die Möglichkeit eine Menüauswahl (menuchoice) zu treffen, indem man aus einem Menü (guimenu) über ein Untermenü (guisubmenu) einen Eintrag auswählt (guimenuitem). Dieser hat in der Regel eine Beschriftung (guilabel) und kann durch Drücken des eines Mausknopfes (mousebutton) betätigt werden. Für die fortgeschrittenen Nutzer gibt es oft eine Tastenkombination (shortcut), mit der man diesen Befehl ausführen kann.

Beispiel 2.40. Einige GUI-Befehle

<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<para>
  Sie bekommen einen leiseren Computer, wenn Sie unter
  Windows XP folgende Menüauswahl treffen: <menuchoice>
  <guimenu>Start</guimenu>
  <guimenuitem>Turn off computer<guimenuitem>
  </menucoice>.
  Wenn Sie dann noch mit der <mousebutton>linken Maustaste</mousebutton>
  auf das mit <guilabel>Turn off</guilabel> beschriftete Piktogramm 
  <guibutton>Netzsymbol</guibotton> klicken, ist Ihr Rechner bald leiser.
</para>

Sie bekommen einen leiseren Computer, wenn Sie unter Windows XP folgende Menüauswahl treffen:Start->Turn off computer. Wenn Sie dann noch mit der linken Maustaste auf das mit Turn off beschriftete Piktogramm Netzsymbol klicken, ist Ihr Rechner bald leiser.