>&kde; gibt eine Ordnerhierarchie vor, die sowohl von der &kde;-Umgebung, als auch von allen &kde;-Programmen benutzt wird. &kde; speichert alle zu &kde; gehörigen Dateien grundsätzlich in einer festgelegten Struktur. </para>
<para
>In der Voreinstellung verwendet &kde; zwei Ordnerbäume:</para>
<itemizedlist>
<listitem
><para
>Einen auf Systemebene (zum Beispiel <filename class="directory"
>/opt/kde3</filename
>.</para
></listitem>
<listitem
><para
>Einen auf Benutzerebene im Persönlichen Ordner eines jeden Benutzers (üblicherweise <filename class="directory"
>. (Dies ist eine Eigenart von &SuSE;, andere Distributionen verwenden auch <filename class="directory"
>/usr</filename
> oder <filename class="directory"
>/usr/kde3</filename
></para
></listitem>
<listitem
><para
><filename class="directory"
>/etc/opt/kde3</filename
>. (Dies wurde von &SuSE; hinzugefügt).</para
></listitem>
</itemizedlist>
<para
>Wenn Sie das KIOSK Admin Tool v0.7 oder neuer installiert haben, können Sie mit dem folgenden Befehl überprüfen, welche Ordnerbäume benutzt werden: <userinput
>&kde; und die &kde;-Programme suchen in allen &kde;-Ordnerbäumen nach Dateien. Die Ordnerbäume werden nach einer Rangfolge durchsucht. Gibt es eine Datei in mehreren Ordnerbäumen, wird die Datei im letzten Ordnerbaum verwendet. Normalerweise hat der Ordnerbaum im Persönlichen Ordner die höchste Priorität. In diesem werden auch alle Änderungen gespeichert.</para>
<informalexample>
<para
>&zb; werden Informationen über den <literal
>text/plain</literal
> &MIME;-Typ in den folgenden Dateien gesucht:</para>
>Einrichtungsdateien werden etwas anders verarbeitet. Gibt es mehrere Einrichtungsdateien mit gleichem Namen in den Ordnerbäumen, so wird ihr Inhalt zusammengefasst. Maßgebend ist dafür die Rangfolge der Ordnerbäume. Wenn in zwei Dateien der gleiche Schlüssel definiert ist, wird der Wert des Schlüssels aus der Datei mit der höchsten Priorität benutzt.</para>
<informalexample
><para
>Wenn zum Beispiel die folgenden beiden Dateien mit diesen Inhalt vorhanden sind:</para>
>Nun können Benutzerprofile Benutzern oder &UNIX;-Gruppen zugeordnet werden.</para
>
<para
>Um das staff-Profil allen Benutzern der &UNIX;-Gruppe staff_members zuzuweisen, fügen Sie das folgende in <filename
>/etc/kde-user-profile</filename
> hinzu:</para>
<programlisting
>[General]
groups=staff_members
[Groups]
staff_members=staff
</programlisting>
<para
>Sie können auch ein Profil für einen einzelnen Benutzer erstellen:</para>
<programlisting
>[Users]
bastian=staff
</programlisting>
</sect1>
<sect1 id="directory-layout-revisited">
<title
>Nochmal zum Ordnerlayout</title>
<para
>Jeder von &kde; benutzte Ordnerbaum hat eine feste Struktur. Ordner, die für einen Ordnerbaum ohne Bedeutung sind oder einfach nicht verwendet werden, müssen nicht zwingend vorhanden sein. Zum Beispiel befinden Sich die Ordner für temporäre Dateien üblicherweise nur unterhalb von <filename class="directory"
>. Wenn eine Sitzung beendet wird, speichern Anwendungen Ihren Status in diesem Ordner. Die Dateinamen setzen sich aus dem Programmnamen und einer Nummer zusammen. Die Sitzungsverwaltung <command
>ksmserver</command
> speichert Referenzen zu diesen Nummern in der Datei <filename
>ksmserverrc</filename
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/doc/HTML</filename
></term>
<listitem
><para
>Dieser Ordner enthält die Dokumentationen zu &kde;-Programmen. Die Dokumentationen sind kategorisiert in Sprache und Programm zu dem sie gehören. In jedem Ordner finden sich üblicherweise zumindest zwei Dateien: <filename
>index.docbook</filename
>, welche die Dokumentation im unformatierten DocBook-Format enthält, und <filename
>index.cache.bz2</filename
>, die die gleiche Dokumentation als <command
>bzip2</command
>-komprimiertes &HTML; enthält. Die &HTML;-Version wird von &khelpcenter; benutzt. Falls die &HTML;-Version fehlen sollte, wird &khelpcenter; die formatierte Dokumentation aus der DocBook-Version erzeugen, aber das ist ein sehr zeitintensiver Vorgang.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/icons</filename
></term>
<listitem
><para
>In diesem Ordner werden Symbole abgelegt. Die Symbole sind sortiert nach Thema, Größe und Kategorie.un</para
></listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/mimelnk</filename
></term>
<listitem
><para
>In diesem Ordner befinden sich die <literal role="extension"
>.desktop</literal
>-Dateien, die Informationen über &MIME;-Typen enthalten. &kde; verwendet &MIME;-Typen um Dateitypen zu bestimmen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/services</filename
></term>
<listitem
><para
>In diesem Ordner befinden sich die <literal role="extension"
>.desktop</literal
>-Dateien, die Dienste beschreiben. Dienste sind so ähnlich wie Programme, werden aber üblicherweise von Programmen anstatt von Benutzer gestartet. Dienste erscheinen nicht im &kde;-Menü.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/servicetypes</filename
></term>
<listitem
><para
>Dieser Ordner enthält die <literal role="extension"
>.desktop</literal
>-Dateien, die Diensttypen beschreiben. Ein Diensttyp repräsentiert üblicherweise eine bestimmte Programmierschnittstelle. Programme und Dienste beschreiben in ihren <literal role="extension"
>.desktop</literal
>-Dateien, welche Diensttypen sie verwenden.</para
> </listitem
></varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/sounds</filename
></term>
<listitem
><para
>Dieser Ordner enthält Audiodateien.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/templates</filename
></term>
<listitem
><para
>Dieser Ordner enthält Vorlagen zum Erstellen von Dateien verschiedenster Arten. Eine Vorlage besteht aus einer <literal role="extension"
>.desktop</literal
>-Datei, die die Datei beschreibt und eine Referenz auf eine Datei im Unterordner <filename class="directory"
>.source</filename
> enthält. Die Vorlagen in diesem Ordner erscheinen im Menü <guimenu
>Neu erstellen ...</guimenu
> auf der Arbeitsfläche und im Dateibrowser. Wenn ein Benutzer eine Vorlage aus dem Menü auswählt, wird die entsprechende Quelldatei kopiert.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename class="directory"
>share/wallpapers</filename
></term>
<listitem
><para
>Dieser Ordner enthält Bilder, die Sie als Bildschirmhintergrund verwenden können.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="host-specific-directories">
<title
>Rechner-spezifische Ordner</title
>
<para
>Es gibt drei Rechner-spezifische Ordner, die normalerweise zu anderen Ordner verlinkt sind. Wenn die Ordner nicht schon existieren, werden mit dem Kommando <command
>lnusertemp</command
> die folgenden Verknüpfungen und Ordner erzeugt:</para>
> von jedem beschreibbar sind, ist es möglich, das die obigen Ordner bereits existieren und einem anderen Benutzer gehören. In diesem Fall erzeugt <command
>lnusertemp</command
> einen neuen Ordner mit einem alternativen Namen und setzt die Verknüpfung auf diesen Ordner.</para>
</sect1>
<sect1 id="configuration-files">
<title
>Einrichtungsdateien</title
> <para
>&kde; benutzt ein einfaches, textbasiertes Format für alle Einrichtungsdateien. Es besteht aus Schlüssel/Wert-Paaren die in Gruppen angeordnet sind. Alle &kde; Einrichtungsdateien benutzen die <acronym
>UTF</acronym
>-8 Kodierung für Texte außerhalb des ASCII-Bereiches.</para>
<para
>Der Beginn einer Gruppe wird von einem Gruppennamen zwischen eckigen Klammern angezeigt. Alle darauf folgenden Schlüssel/Wert-Paare gehören zu dieser Gruppe. Die Gruppe ist zuende, wenn entweder eine neue Gruppe startet oder das Dateiende erreicht wurde. Einträge am Kopf der Datei ohne voranstehende Gruppe gehören zur Standardgruppe.</para>
<informalexample
><para
>Das folgende Beispiel zeigt eine Einrichtungsdatei mit zwei Gruppen. Die erste Gruppe enthält die Schlüssel <varname
>LargeCursor</varname
> und <varname
>SingleClick</varname
>, die zweite Gruppe enthält die Schlüssel <varname
>Show hidden files</varname
> und <varname
>Sort by</varname
>:</para>
<programlisting
>[KDE]
LargeCursor=false
SingleClick=true
</programlisting>
<programlisting
>[KFileDialog Settings]
Show hidden files=false
Sort by=Name
</programlisting>
</informalexample>
<para
>Einträge einer Gruppe enthalten Schlüssel/Wert-Paare getrennt von einem Gleichheitszeichen. Der Schlüssel darf Leerzeichen enthalten und kann Optionen in eckigen Klammern enthalten. Der Teil hinter dem Gleichheitszeichen ist der Wert zu dem Schlüssel. Leerzeichen um das Gleichheitszeichen werden ignoriert, ebenso wie folgende Leerzeichen nach dem Wert. Kurzgesagt, das Format ist:</para>
<programlisting
><replaceable
>Schlüssel</replaceable
>=<replaceable
>Wert</replaceable
>
</programlisting>
<para
>Wenn ein Wert führende Leerzeichen haben soll, so erreicht man diese mit einem linksgerichteten Schrägstrich und einem folgenden <quote
>s</quote
>.</para>
<para
>Es gibt noch weitere Codes mit linksgerichteten Schrägstrichen; hier eine vollständige Liste: <itemizedlist>
<listitem
><para
><token
>\s</token
> kann als Leerzeichen benutzt werden.</para>
</listitem>
<listitem
><para
><token
>\t</token
> kann als Tabulator benutzt werden.</para>
</listitem>
<listitem
><para
><token
>\r</token
> kann als Wagenrücklaufzeichen benutzt werden.</para>
</listitem>
<listitem
><para
><token
>\n</token
> kann als Zeilenvorschubzeichen benutzt werden.</para>
</listitem>
<listitem
><para
><token
>\\</token
> kann als linksgerichteter Schrägstrich benutzt werden.</para>
</listitem>
</itemizedlist
></para>
<informalexample
><para
>Im folgenden Beispiel beginnt der Wert <varname
>Caption</varname
> mit zwei Leerzeichen, während der Wert <varname
>Description</varname
> aus drei Zeilen besteht. Zeilenvorschübe in der Backslash-Notation werden zum trennen mehrerer Zeilen benutzt.</para>
<programlisting
>[Preview Image]
Caption=\s My Caption
Description=This is\na very long\ndescription.
</programlisting>
</informalexample>
<para
>Leere Zeilen in Einrichtungsdateien werden einfach ignoriert, genauso wie Zeilen, die mit einem Doppelkreuz beginnen (<quote
>#</quote
>). Das Doppelkreuz kann zum Beispiel für Kommentare in Einrichtungsdateien benutzt werden. Wenn die Einrichtungsdatei allerdings von einem &kde;-Programm benutzt wird, so werden die Kommentare nicht beibehalten.</para>
<para
>Es können sich mehrere Einrichtungsdateien mit dem selben Namen im Unterordner <filename class="directory"
>share/config</filename
> der verschiedenen &kde;-Ordnerbäume befinden. In dem Fall werden die Inhalte aller gefundenen Dateien Schlüssel für Schlüssel kombiniert. Falls sich der gleiche Schlüssel in der gleichen Gruppe in mehreren Dateien befinden sollte, so wird der Wert von dem Schlüssel genommen, der aus dem Ordnerbaum mit der höchsten Priorität stammt. Einrichtungsdateien unter <filename class="directory"
> haben immer die höchste Priorität. Falls ein Schlüssel einer bestimmten Gruppe innerhalb einer Datei mehrfach vorkommt, so wird der letzte Eintrag verwendet.</para>
>Um Benutzer davon abzuhalten, eine Voreinstellung zu überschreiben, können Einstellungen als nicht überschreibbar markiert werden. Dies geht individuell, per Gruppe oder per Datei. Ein individueller Eintrag kann gesperrt werden, indem man <userinput
>[$i]</userinput
> hinter den Schlüssel einfügt. Beispiel: <programlisting
>Color[$i]=blue
</programlisting>
</para>
<para
>Eine Gruppe lässt sich sperren, indem man <userinput
>[$i]</userinput
> hinter den Gruppennamen schreibt: <programlisting
>[MyGroup][$i]
</programlisting>
</para>
<para
>Um die gesamte Datei vor dem Übergehen der Werte zu schützen, beginnen Sie die Datei mit <userinput
>Um dynamischere Werte zu erhalten, kann man so genannte <quote
>Shell Ersetzungen</quote
> benutzen. Damit ist es möglich, einen Wert aus einer Umgebungsvariable auszulesen oder durch die Ausgaben einen Programms zu ersetzen. Um Shell Ersetzungen nutzen zu können, muss der jeweilige Schlüssel mit dem Parameter <token
>[$e]</token
> versehen werden. Die ersetzte Form wird üblicherweise nach der ersten Benutzung als Text in die benutzerdefinierte Einrichtungsdatei gespeichert. Um dies zu verhinden, kann man den Schlüssel zusätzlich sperren, indem man <token
>[$ei]</token
> benutzt. Natürlich kann der Benutzer dann den Wert nicht mehr selber festlegen.</para>
<informalexample>
<para
>Im folgenden Beispiel wird der Wert des Schlüssels <varname
>Host</varname
> durch die Ausgabe des Programms <command
>hostname</command
> festgelegt. Diese Einstellung ist zusätzlich gesperrt, um sicherzustellen, dass diese Einstellung immer dynamisch bestimmt wird.</para>
<para
>Der Wert für den Schlüssel <varname
>Email</varname
> wird zusammengesetzt aus den Werten der Umgebungsvariablen $<envar
>USER</envar
> und $<envar
>HOST</envar
>. Wenn <systemitem class="username"
>joe</systemitem
> auf <systemitem class="systemname"
>joes_rechner</systemitem
> angemeldet ist, so ist das Ergebnis also <literal
>joe@joes_rechner</literal
>. Diese Einstellung ist nicht gesperrt.</para>
<programlisting
>[Mail Settings]
Host[$ie]=$(hostname)
Email[$e]=${USER}@${HOST}
</programlisting>
</informalexample>
<para
>Die meisten Schlüssel können mit einem Sprachcode indexiert werden. In dem Fall wird die vom Benutzer ausgewählte Sprache verwendet, um den korrekten Wert aufzufinden. Falls die Standardsprache (Amerikanisches Englisch) ausgewählt ist, wird der Schlüssel ohne Index herangezogen.</para>
<informalexample>
<para
>Im folgenden Beispiel ist der Wert von <varname
>Caption</varname
> abhängig von der Sprache des Benutzers. Falls der Benutzer Französisch ausgewählt hat (Ländercode <literal
>fr</literal
>), ist der Wert des Schlüssels <quote
>Ma Légende</quote
>. In allen anderen Fällen ist der Wert <quote
>My Caption</quote
>.</para>
<programlisting
>[Preview Image]
Caption=My Caption
Caption[fr]=Ma Légende
</programlisting>
</informalexample>
<informalexample>
<para
>Im folgenden Beispiel ist der Wert von <varname
>Caption</varname
> abhängig von der Sprache des Benutzers. Falls der Benutzer Französisch ausgewählt hat (Ländercode <literal
>fr</literal
>), ist der Wert des Schlüssels <quote
>Ma Légende</quote
>. In allen anderen Fällen ist der Wert <quote
>My Caption</quote
>.</para>
<programlisting
>[Preview Image]
Caption=My Caption
Caption[fr]=Ma Légende
</programlisting>
</informalexample>
<para
>Im allgemein sind die möglichen Einträge in Einrichtungsdateien von &kde; nicht dokumentiert. Mit &kde; 3.2 wurde damit begonnen, diesen Nachteil zu ändern. Unter <filename class="directory"
> können Dateien liegen, die eine formale Beschreibung der möglichen Einträge einer Einrichtungsdatei enthalten. Diese werden (falls vorhanden) von dem &kde; Einrichtungsdatei-Editor benutzt.</para>
<informalexample>
<para
>Hier ist ein Beispiel für eine &XML;-Einrichtungsdatei: <programlisting
><markup>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE kcfg SYSTEM "http://www.kde.org/standards/kcfg/1.0/kcfg.dtd">
<kcfg>
<kcfgfile name="korganizerrc"/>
<group name="General">
<entry type="Bool" key="Auto Save">
<label>Enable automatic saving of calendar</label>
>. In den meisten Fällen wird das Skript vom Displaymanager aufgerufen (&tdm;), sobald der Benutzer sich angemeldet hat. Es gibt zwei sehr wichtige Zeilen in diesem Skript:</para>
> zu starten. Die Sitzungsverwaltung bestimmt die Laufzeit einer Sitzung. Wenn dieser Prozess beendet wird, ist der Benutzer abgemeldet.</para>
</sect2>
</sect1>
<sect1 id="background-processes">
<title
>Hintergrundprozesse</title>
<para
>Alle &kde; Hintergrundprozesse sind Benutzer-spezifisch: anders als System-Daemons werden sie nicht unter mehreren Benutzern geteilt. Sie sind sowohl einmalig pro Benutzer, als auch einmalig pro X-Server. Diese Prozesse sind:</para>
> angegebene Programm. Dies ist normalerweise <command
>kcminit</command
> und <command
>knotify</command
>.</para>
</sect2>
<sect2 id="dcopserver">
<title
><command
>dcopserver</command
></title>
<para
><command
>kdcopserver</command
> ist ein Daemon, der die Kommunikation von &kde;-Prozessen untereinander ermöglicht (&DCOP;). &DCOP;-Funktionen sind von der Shell aus mit dem Kommando <command
>dcop</command
> erreichbar. &DCOP; ist essentiell für alle &kde;-Programme.</para>
<para
>Einige verwandte Dateien:</para>
<variablelist>
<varlistentry>
<term
><filename
>$<envar
>HOME</envar
>/.DCOPserver_$<envar
>HOSTNAME</envar
>_$<envar
>DISPLAY</envar
></filename
></term>
<listitem
><para
>Zum Beispiel <filename
>.DCOPserver_linux__0</filename
>. Kontrolliert von $<envar
>DCOPAUTHORITY</envar
>
></para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename
>/tmp/.ICE-unix/dcop<replaceable
>pid</replaceable
>-<replaceable
>zahl</replaceable
></filename
></term>
<listitem
><para
>Zum Beispiel <filename
>dcop7634-1069677856</filename
>. Dies ist die Datei, auf die die obige Datei <filename
>DCOPserver</filename
> zeigt.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><filename
>$<envar
>HOME</envar
>/.ICEauthority</filename
></term>
<listitem
><para
>Autorisationsinformationen die von $<envar
>ICEAUTHORITY</envar
> kontrolliert werden.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="kcminit">
<title
>kcminit</title>
<para
><command
>kcminit</command
> startet die Initialisierungsdienste während dem Startvorgang. Initialisierungsdienste sind in den .desktop-Dateien von Programmen oder Diensten mit dem Schlüssel <varname
>Initialisierungsdienste werden üblicherweise zum Initalisieren von Hardware basierend auf benutzerdefinierten Einstellungen benutzt.</para>
<para
><userinput
><command
>kcminit <option
>--list</option
></command
></userinput
> zeigt Ihnen alle Initialisierungsdienste an und <userinput
><command
>kcminit <replaceable
>dienst</replaceable
></command
></userinput
> kann zum expliziten Start eines Dienstes verwendet werden. Dies kann &zb; bei der Fehleranalyse hilfreich sein, falls ein Dienst Probleme beim Start bereitet.</para>
> ist das Durchreichen von Audio-Benachrichtigungen an den Sound-Server. Es werden auch andere Benachrichtigungsmethoden unterstütz.</para>
</sect2>
</sect1>
<sect1 id="ksmserver">
<title
>KSMServer</title>
<para
><command
>ksmserver</command
> ist die Sitzungsverwaltung von &kde;. Beim Start lädt die Sitzungsverwaltung verschiedene Autostart-Programme und stellt Programme aus vorigen Sitzungen wieder her. Autostart-Programme werden durch <literal role="extension"
> öffnet automatisch alle Dateien die in diesem Ordner gespeichert sind, inklusive Dokumente, Binärdateien oder Programm in der Form von <literal role="extension"
>.desktop</literal
>-Dateien.</para>
<para
>Die &kde; Sitzungsverwaltung stellt auch eine der vorherigen Sitzungen wieder her. Eine Sitzung besteht aus Programmen und Programm-spezifischen Informationen, die den Status eines Programms zum Zeitpunkt beschreiben, als die Sitzung beendet wurde. Sitzungen werden in der Datei <filename
>ksmserverrc</filename
> gespeichert, die wieder Referenzen auf die Programm-spezifischen Informationen enthält. Diese Informationen werden unter <filename class="directory"
> nicht gesetzt ist. Diese Variable zeigt auf den Basisordner von &kde;. Dadurch ist es &kde; möglich, die Datendateien wie Symbole, Menüs und Bibltiotheken aufzufinden.</para>
> und kann mehrere durch Komma getrennte Ordner-Einträge enthalten, in denen &kde; nach seinen Daten sucht. Dies kann sinnvoll sein, wenn Sie einige Programme in einem anderen Präfix als &kde; installieren möchten bzw. müssen.</para
>(Seit &kde; 3.2) Wird automatisch beim &kde; Startvorgang gesetzt und wird z. B. von &konqueror; genutzt, um festzustellen, ob das Programm nach dem Beenden im Speicher gehalten werden soll (für zukünftige Nutzung) oder nicht. (&tdesu; benutzt diesen Mechanismus ebenfalls, und er kann auch zur Fehlersuche nützlich sein.)</para>
>Ermöglicht Ihnen, einen anderen Pfad als <filename class="directory"
>/var/tmp</filename
> für &kde;s temporäre variable Dateien zu verwenden.</para>
</listitem>
</varlistentry>
<varlistentry
><term
>$<envar
>XDG_DATA_HOME</envar
></term
><listitem
><para
>(Seit &kde; 3.2) Gibt den Basisordner an, in dem Benutzer-spezifische Datendateien gespeichert werden sollen. Die Voreinstellung ist <filename class="directory"
>$<envar
>HOME</envar
>/.local/share</filename
>.</para>
</listitem>
</varlistentry>
<varlistentry
><term
>$<envar
>XDG_DATA_DIRS</envar
></term
><listitem
><para
>(Seit &kde; 3.2) Gibt in einer Rangfolge zusätzlich zu <filename class="directory"
>$<envar
>XDG_DATA_HOME</envar
></filename
> weitere Basisordner für Benutzer-spezifische Datendateien an. Die Voreinstellung ist <literal
> und Profilen hinzu. Wird für <literal role="extension"
>.desktop</literal
>- und <literal role="extension"
>.directory</literal
>-Menüdateien benutzt. <literal role="extension"
>.desktop</literal
>-Dateien unter <filename class="directory"
>$<envar
>XDG_DATA_DIRS</envar
>/applications</filename
> und <literal role="extension"
>.directory</literal
>-Dateien unter $XDG_DATA_DIRS/desktop-directories. </para>
</listitem>
</varlistentry>
<varlistentry
><term
>$<envar
>XDG_CONFIG_HOME</envar
></term
><listitem
><para
>(Seit &kde; 3.2) Gibt den Basisordner an, unter dem Benutzer-spezifische Einrichtungsdateien gespeichert werden sollen. Die Voreinstellung ist <filename class="directory"
>$<envar
>HOME</envar
>/.config</filename
>.</para>
</listitem>
</varlistentry>
<varlistentry
><term
>$<envar
>XDG_CONFIG_DIRS</envar
></term
><listitem
><para
>(Seit &kde; 3.2) Gibt in einer Rangfolge weitere Basisordner an, in denen Einrichtungsdateien zusätzlich zu $<envar
>XDG_CONFIG_HOME</envar
> gesucht werden. Die Voreinstellung ist <filename class="directory"
>Die unterstützten &MIME;-Typen, wird nicht auf der Arbeitsfläche genutzt.</para>
</callout>
<callout arearefs="co-exec"
><para
>Der auszuführende Befehl</para>
</callout>
<callout arearefs="co-icon"
><para
>Das Symbol. Aus dem Symbol-Design oder der gesamte Pfad.</para>
</callout>
<callout arearefs="co-terminaloptions"
><para
>Wird nur verwendet, wenn ein Terminal benutzt wird.</para>
</callout>
<callout arearefs="co-path"
><para
>Der Arbeitsordner für den Befehl</para>
</callout>
<callout arearefs="co-type"
><para
>Typinformationen</para>
</callout>
<callout arearefs="co-terminal"
><para
>Benutzen Sie hier einen wahren Wert, wenn ein Terminal benötigt wird (Textprogramm).</para>
</callout>
<callout arearefs="co-x-kde-startupnotify"
><para
>Zeigt einen hüpfenden Cursor während dem Startvorgang an.</para>
</callout>
<callout arearefs="co-x-dcop-servicetype"
><para
>Wurde das Programm korrekt gestartet? Entfernen Sie dies, falls das nicht funktioniert.</para>
</callout>
<callout arearefs="co-categories"
><para
>Kategorien für das &kde;-Menü, wird nicht auf der Arbeitsfläche benutzt.</para>
</callout>
</calloutlist>
</sect2>
<sect2 id="desktop-icons-exec">
<title
>Die <varname
>Exec</varname
>-Option in <literal role="extension"
>.desktop</literal
>-Dateien</title>
<para
>Nach dem eigentlich Kommando können Sie zahlreiche Platzhalter angeben, die durch echte Werte ersetzt werden, wenn das Programm gestartet wird: <variablelist>
<varlistentry>
<term
>%f</term
> <listitem
><para
>Ein einfacher Dateiname; wird &zb; benutzt, wenn eine Datei oder ein Symbol auf eine Verknüpfung gezogen wird.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%F</term>
<listitem
><para
>Eine Dateiliste; wird von Programmen benutzt, die mehrere Dateien gleichzeitig öffnen können.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%u</term>
<listitem
><para
>Eine einzelne Adresse (URL), falls das Programm mit &FTP;, oder &HTTP;-Adressen umgehen kann.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%U</term>
<listitem
><para
>Eine Liste von Adressen (&URL;s). Allerdings werden erst die angegebenen Dateien heruntergeladen und dann die lokale Datei an das Programm übergeben!</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%d</term>
<listitem
><para
>Der Ordner der zu öffnenden Datei. Dies ist nützlich, wenn das Programm die Datei im aktuellen Arbeitsordner erwartet.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%D</term>
<listitem
><para
>Eine Ordnerliste, nicht sonderlich nützlich.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%i</term
>
<listitem
><para
>Das Symbol. Ist das selbe wie die Option <option
>--icon</option
>. Das &kde;-Programm wird das Symbol aus der Zeile <varname
>Icon</varname
>= in der Fensterleiste anzeigen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%m</term>
<listitem
><para
>Das Minisymbol; eine Altlast.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%c</term
>
<listitem
><para
>Der Titel; ist das selbe wie die Option <option
>--caption</option
>. Das &kde;-Programm wird den Titel aus der Zeile <varname
>Name</varname
>= in der Fensterleiste anzeigen.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<informalexample>
<para
>Beispiele: <segmentedlist>
<segtitle
><varname
>Exec</varname
>-Zeile</segtitle>
<segtitle
>Ausgeführtes Kommando</segtitle>
<seglistitem
><seg
>ksirc %i</seg
><seg
><command
>ksirc --icon ksirc</command
></seg>
</seglistitem>
<seglistitem
><seg
>cd %d; kedit $(basename %f)</seg
><seg
><command
>cd /tmp; kedit file.txt</command
></seg>
</seglistitem>
</segmentedlist>
</para>
</informalexample>
<!--Dont' know what this refers to: -->
<!--See What's This (Shift-F1) in Properties Dialog-->
</sect2>
<sect2 id="desktop-icons-devices">
<title
>Geräte</title>
<para
>Verknüpfungen zu Geräten benutzen <literal role="extension"
>.desktop</literal
>-Dateien: Neu erstellen ... -> Gerät </para>
</sect2>
<sect2 id="where-to-define">
<title
>Definieren der Arbeitsflächensymbole</title>
<para
>Es gibt mehrere Stellen, an denen Arbeitsflächensymbole definiert werden können: <itemizedlist>
> hält einen Zwischenspeicher der Menüstruktur und der Informationen über alle verfügbare Programme vor. Sie können die Datenbank mit dem Kommando <userinput
> und Untermenüs (Symbole, Namen): <filename class="directory"
>~/.local/share/desktop-directories/</filename
>. Das KIOSK Admin Werkzeug benutzt &kmenuedit; und kopiert die gemachten Änderungen dann nachträglich in Profil- oder Systemweite Ordner. </para>
</sect2>
</sect1>
<!-- This section might be redundant. If it isn't, it needs some screenies -->
<sect1 id="kde-panel">
<title
>Die &kde;-Kontrollleiste</title>
<para
>Die &kde; Kontrollleiste ist auch unter dem Namen &kicker; bekannt. Sie ist modular aufgebaut und enthält die folgenden Komponenten: <itemizedlist>
<listitem
><para
>Miniprogramme</para
></listitem>
<listitem
><para
>Programmknöpfe</para
></listitem>
<listitem
><para
>Spezialknöpfe</para
></listitem>
</itemizedlist>
</para>
<para
>In der Voreinstellung enthält die Kontrollleiste diese Miniprogramme: <itemizedlist
> <listitem
><para
>Arbeitsflächenumschalter - zeigt virtuelle Arbeitsflächen an</para
></listitem
> <listitem
><para
>Fensterleiste</para
></listitem
> <listitem
><para
>Systembereich</para
></listitem
> <listitem
><para
>Uhr</para
></listitem
> </itemizedlist
> und die folgenden Spezialknöpfe: <itemizedlist>
<listitem
><para
>Das &kde;-Menü</para
></listitem>
<listitem
><para
>Der Knopf Arbeitsfläche anzeigen</para
></listitem>
</itemizedlist>
</para>
<para
>Es werden (abhängig vom verfügbaren Platz) noch weitere Programmknöpfe hinzugefügt: <itemizedlist>
<listitem
><para
>Der Knopf Persönlicher Ordner</para
></listitem>
<listitem
><para
>Der Knopf Webbrowser</para
></listitem>
<listitem
><para
>Der Knopf Mail-Programm</para
></listitem>
</itemizedlist>
</para>
</sect1>
<sect1 id="file-associations">
<title
>Dateizuordnungen</title>
<para
>Mit Dateizuordnungen werden bestimmte Dateitypen einem oder mehreren Programmen zugeordnet. Der Typ einer Datei wird mit Hilfe seines &MIME;-Typs bestimmt. Die &kde; bekannten &MIME;-Typen befinden sich in <filename class="directory"
> gespeichert. Um die gleichen Einstellungen für mehrere Benutzer zu verwenden, speichern Sie die Änderungen in einem Profilordner oder dem globalen &kde; Einrichtungsordner.</para>
</informalexample>
</sect1>
</chapter>
<chapter id="locking-down-kde">
<title
>&kde;-Einstellungen sperren</title>
<sect1 id="how-it-works-the-basics">
<title
>Wie es funktioniert - die Grundlagen</title>
<para
>&kde;s Möglichkeiten zum Sperren von Einstellungen drehen sich um diese Optionen:</para>
<itemizedlist>
<listitem
><para
><link linkend="immutable-configuration-options"
>Einstellungen nicht überschreibbar machen</link
></para
></listitem>
<listitem
><para
><link linkend="action-restrictions"
>Bestimmte Aktionen verbieten</link
></para
></listitem>
<listitem
><para
><link linkend="url-restrictions"
>Zugang zu bestimmten Adressen (URLs) verbieten</link
></para
></listitem>
<listitem
><para
><link linkend="configuration-modules"
>Zugang zu bestimmten Einrichtungs-Modulen verbieten</link
></para
></listitem>
</itemizedlist>
</sect1>
<sect1 id="immutable-configuration-options">
<title
>Nicht überschreibbare Einstellungen</title>
<subtitle
>&kde;-Einstellungen sperren</subtitle>
<para
>Nicht überschreibbare Einstellungen ermöglichen dem Systemverwalter, Voreinstellungen zu vergeben, die vom Benutzer nicht geändert werden können.</para>
<para
>Bereits bestehende Einstellungen des Benutzers werden ignoriert, sobald die globale Einstellung als nicht überschreibbar markiert wird.</para>
<para
>Einstellungen können sowohl pro Eintrag, als auch pro Gruppe oder Einrichtungsdatei gesperrt werden.</para>
<para
>Wenn eine Datei oder Gruppe gesperrt ist, sind alle darin enthaltenen Einstellungen gesperrt, selbst diese, für die der Systemverwalter keine Voreinstellung festgelegt hat.</para>
<note
><para
>Die Unterstützung für solche gesperrten Einstellungen kann in den Programmen verschieden sein. Auch wenn ein Benutzer nicht die Möglichkeit hat, eine Einstellung permanent zu speichern, so kann es dennoch möglich sein, ein Änderung temporär in einem Dialog vorzunehmen.</para
></note>
</sect1>
<sect1 id="action-restrictions">
<title
>Unterbinden bestimmter Aktionen</title>
<para
>&kde;-Programme sind nach dem Aktionen-Prinzip aufgebaut. Aktionen können auf verschiedenste Arten und Weisen ausgeführt werden; üblicherweise über die Menüleiste, eine der Werkzeugleisten oder über einen Kurzbefehl. <action
>Dokument speichern</action
> ist ein Beispiel für eine Aktion. Wenn Sie den internen Aktionsnamen eines Programms kennen, so können Sie diese verbieten. Wenn eine Aktion gesperrt wurde, erscheint sie nicht mehr im Menü oder der Werkzeugleiste. Der Interne Name für <action
>Dokument Speichern</action
> ist &zb; <option
>action/file_save</option
>. Das Grundgerüst zum Sperren bietet Ihnen aber auch eine Methode zum abstrakten Sperren von Funktionen an. Ein Beispiel dafür ist die Restriktion <option
>shell_access</option
>, wodurch grundsätzlich der Zugriff auf eine &UNIX;-Shell unterbunden wird.</para>
<example>
<title
>Zugriff auf Shells unterbinden</title>
<para
>Um den Zugriff auf eine Kommandozeile zu unterbinden, können Sie die Restriktion <option
>shell_access</option
> aktivieren. Fügen Sie dazu das Folgende zu <filename
>kdeglobals</filename
> hinzu: </para
>
<screen
>[KDE Action Restrictions]
shell_access=false</screen>
<para
>Da diese Änderung auch die &kde;-Menüs und die verfügbaren Programme betrifft, muss eine Aktualisierung der sycoca-Datenbank erzwungen werden:</para>
>Legt fest, ob OpenGL-Bildschirmschoner benutzt werden können.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><option
>manipulatescreen_screensavers</option
></term>
<listitem
><para
>Bildschirmschoner zulassen, die nicht den gesamten Bildschirm verdecken.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="url-restrictions">
<title
>Adressen-Restriktionen</title>
<para
>Es gibt drei Arten von Sperren, die auf Adressen angewandt werden können:</para>
<variablelist>
<varlistentry>
<term
>list</term>
<listitem
><para
>Legt fest, ob das Auflisten von Ordnerinhalten erlaubt ist.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>open</term>
<listitem
><para
>Legt fest, ob bestimmte Adressen geöffnet werden dürfen.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Redirect</term>
<listitem
><para
>Legt fest, ob durch eine Adresse eine weitere Adresse aufgerufen werden darf, automatisch oder über eine Verknüpfung.</para
></listitem>
</varlistentry>
</variablelist>
<para
>Die Regeln werden in Ihrer Definitionsreihenfolge geprüft. Die letzte passende Regel auf eine Adresse legt fest, ob der Zugriff gewährt wird oder nicht.</para>
<para
>Die folgenden Regeln sperren das Öffnen von http- und https-Adressen außerhalb der Domäne <systemitem class="domainname"
>Die folgende Regel sorgt dafür, dass Benutzer keine Dateien mehr außerhalb ihrer Persönlichen Ordner öffnen können:</para>
<screenco
><areaspec>
<area id="local_rule1" coords="3"/>
<area id="local_rule2" coords="4"/>
<area id="local_rule3" coords="5"/>
</areaspec>
<screen
>[KDE URL Restrictions]
rule_count=3
rule_1=open,,,,file,,,false
rule_2=open,,,,file,,$HOME,true
rule_3=open,,,,file,,$TMP,true</screen
></screenco>
<calloutlist>
<callout arearefs="local_rule1"
><para
><option
>rule_1</option
> verbietet das Öffnen jeglicher lokaler Dateien.</para
></callout>
<callout arearefs="local_rule2"
><para
><option
>rule_2</option
> erlaubt wiederum das Öffnen von Dateien unter dem Persönlichen Ordner des Benutzers.</para
></callout>
<callout arearefs="local_rule3"
><para
><option
>rule_2</option
> erlaubt das Öffnen von Dateien in &kde;s temporärem Ordner des jeweiligen Benutzers. Dies ist notwendig, weil &kde;-Programme oftmals eine Datei erst im temporären Ordner ablegen und dann von dort aus öffnen.</para
></callout>
</calloutlist>
<para
>Die Redirect-Option legt fest, ob Dokumente von einem bestimmten Ort auf einen anderen Ort verweisen dürfen (automatisch oder via Verknüpfung). Ein Satz an Voreinstellungen ist aus Sicherheitsgründen bereits festgelegt. Zum Beispiel darf ein Dokument im Internet nicht auf lokale Dateien verweisen.</para>
<para
>Wenn wir beispielsweise dem Intranet-Server <systemitem class="systemname"
>www.mycompany.com</systemitem
> erlauben möchten, auf lokale Dateien zu verweisen, dann fügen Sie diese Regel hinzu:</para>
>Anstatt ein Protokoll anhand seines Namens zu bestimmen, können Sie auch eine Protokollgruppe angeben. Zu diesem Zweck wurden die folgenden Protokollgruppen definiert:</para>
<variablelist>
<varlistentry>
<term
>:local</term>
<listitem
><para
>Protokolle, die auf lokal gespeicherte Daten zugreifen, wie zum Beispiel file:/, man:/, fonts:/, floppy:/</para
></listitem>
</varlistentry>
<varlistentry>
<term
>:internet</term>
<listitem
><para
>Übliche Internetprotokolle wie http und ftp</para
></listitem>
</varlistentry>
</variablelist>
<para
>Informationen zu Protokollen sind in <literal role="extension"
>Die :local-Protokolle können auf alle weiteren Protokolle verweisen</para
></listitem>
<listitem
><para
>Es ist immer erlaubt, auf ein :internet-Protokoll zu verweisen</para
></listitem>
<listitem
><para
>Nicht alle Protokolle gehören zu einer Gruppe, fish:/ zum Beispiel.</para
></listitem>
</itemizedlist>
</sect1>
<sect1 id="configuration-modules">
<title
>Die Einrichtungsmodule</title>
<para
>&kde; benutzt Einrichtungsmodule um die verschiedenen Bereich von &kde; anzupassen. Einrichtungsmodule erscheinen im &kcontrolcenter;, in einem Einrichtungsdialog oder in beiden.</para>
<informalexample>
<para
>Das Proxy-Einrichtungsmodul zum Beispiel erscheint sowohl im &kcontrolcenter; als auch im Dialog <guilabel
>Konqueror einrichten ...</guilabel
>.</para>
<para
>Individuelle Einrichtungsmodule können mit dem Kommando <command
>Verbindung zu einer entfernten Arbeitsfläche</title>
<para
>Mit freigegebenen Arbeitsflächen ist es entfernten Benutzern möglich, die Arbeitsfläche des aktuellen Benutzers zu sehen und sogar zu übernehmen. Dem entfernten Benutzer muss eine Einladung gesendet werden. Diese Einladung kann mit einem Passwort geschützt sein. Dies ist &zb; für die technische Unterstützung oder für Systemverwalter nützlich, um Zugriff auf die Arbeitsfläche zu erhalten. Auf diese Weise ist die Fehleranalyse möglich, oder man kann einen Benutzer bei bestimmten Vorgängen leichter anleiten.</para>
<para
>Zur Arbeitsflächenfreigabe gehören zwei Programme: &krfb; (&kde; remote frame buffer, ein VNC-Server) und &krdc; (&kde; remote desktop connection, ein VNC-Client).</para>
<para
>Mit &krfb; ist es jedem Benutzer möglich, eine Einladung zur Übernahme der Arbeitsfläche auszusprechen. Eine Einladung erzeugt automatisch ein Einmal-Passwort, mit dem der Empfänger der Einladung eine Verbindung zur Arbeitsfläche herstellen kann. Dieses Passwort ist in der Voreinstellung nur ein einziges Mal gültig und läuft nach einer Stunde ab, wenn es nicht benutzt wurde.</para>
<para
>Die eingehenden Verbindungen werden vom kded-Modul kinetd verwaltet. Verwenden Sie das Kommando <userinput
><command
>dcop</command
> kded kinetd services</userinput
>, um zu sehen, ob kinetd läuft. &krfb; wartet normalerweise an Port 5900 auf eingehende Verbindungen. Wenn eine neue Verbindung eingeht, erscheint ein Bestätigungsdialog.</para>
<!-- TODO: Write a bit more here, with a walk through maybe? -->
</sect1>
<sect1 id="kde-diy">
<title
>Der &kde; Heimwerker - Bauen Sie Ihre eigenen Werkzeuge</title>
<sect2 id="dcop">
<title
>DCOP</title>
<para
>Desktop COmmunication Protocol, <acronym
>DCOP</acronym
>, ist ein Mechanismus zur Kommunikation von &kde;-Programmen untereinander. <acronym
>DCOP</acronym
> ermöglicht einem Benutzer, mit derzeit laufenden Programmen zu interagieren. &kde; bringt zwei Programme zum Umgang mit <acronym
>DCOP</acronym
> mit: <application
>dcop</application
>, ein Kommandozeilenprogramm, und <application
>kdcop</application
>, ein graphisches Programm. </para>
<para
>Einige Hinweise für die Anwendung des Befehls <command
>Der &kde; Heimwerker - Bauen Sie Ihre eigenen Werkzeuge</subtitle>
<para
>Sie können &kde;-Dialoge in Ihren eigenen Skripten benutzen und damit die leistungsfähigen &UNIX;-Shell-Skripte mit der Einfachheit von &kde; verbinden.</para>
<screen
><userinput
><command
>kdialog</command
> <option
>--msgbox 'Sie haben eine neue E-Mail!'</option
></userinput
></screen>
<screen
><userinput
><command
>kdialog</command
> <option
>--title 'Neue E-Mail'</option
> <option
>--msgbox 'Sie haben eine neue E-Mail!'</option
></userinput
></screen>
<para
>Die Überschrift <application
>KDialog</application
> kann mit der Option <option
>--caption</option
> ersetzt werden.</para>
<screen
><userinput
><command
>kdialog</command
> <option
>--title 'Neue Mail'</option
> <option
>--msgbox 'Sie haben eine neue Mail!'</option
> <option
>--dontagain myfile:mykey</option
></userinput
></screen>
<para
>Dadurch wird gespeichert, ob der Dialog erneut angezeigt werden soll. Dazu werden die folgenden Zeilen in <filename
>--sorry 'Das Netzwerk ist nicht erreichbar!'</option
> oder <command
>kdialog</command
> <option
>--error 'Die Mailbox lässt sich nicht öffnen!'</option
> benutzen.</para>
<para
>Es ist auch möglich, Dialog mit einer Ja/Nein-Antwort anzeigen zu lassen.</para>
<screen
><command
>kdialog</command
> <option
>--yesno 'Möchten Sie eine Verbindung
mit dem Internet?'</option
> <command
>echo</command
> <returnvalue
>$?</returnvalue
></screen>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Rückgabewert</entry>
<entry
>Bedeutung</entry>
</row>
</thead>
<tbody>
<row
><entry
>0</entry
><entry
>Ja, Ok, Fortsetzen</entry
></row>
<row
><entry
>1</entry
><entry
>Nein</entry
></row>
<row
><entry
>2</entry
><entry
>Abbrechen</entry
></row>
</tbody>
</tgroup>
</informaltable>
<para
>Speichern Sie das Ergebnis in einer Variablen, wenn Sie das Ergebnis nicht direkt weiterverwenden, denn der nächste Befehl weist ?$ einen neuen Wert zu. Sie können dafür aber auch die Option <option
>--dontagain</option
> verwenden, damit wird die Auswahl des Benutzers gespeichert und bei den nächsten Aufrufen des Befehls zurückgegeben, ohne den Dialog wieder anzuzeigen.</para>
<para
>Weitere Optionen sind:</para>
<variablelist>
<varlistentry>
<term
><option
>--warningyesno</option
></term>
<listitem>
<para
>wie <option
>--yesno</option
> aber mit einem anderen Symbol</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--warningcontinuecancel</option
></term>
<listitem
><para
>Mit den Knöpfen <guibutton
>Fortsetzen</guibutton
> und <guibutton
>Abbrechen</guibutton
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--warningyesnocancel</option
></term>
<listitem
><para
>Mit den Knöpfen <guibutton
>Ja</guibutton
>, <guibutton
>Nein</guibutton
> und <guibutton
>Abbrechen</guibutton
>. Zum Beispiel:</para>
<screen
><command
>kdialog</command
> <option
>--warningyesnocancel 'Wollen Sie
die Änderungen speichern?'</option
></screen>
</listitem>
</varlistentry>
</variablelist>
<screen
><command
>kdialog</command
> <option
>--inputbox "Geben Sie Ihren Namen ein:" "Ihr Name"</option
></screen>
<para
>Das Ergebnis wird auf stdout ausgegeben. Um es in eine Variable zu schreiben, können Sie dies benutzen: <userinput
>name=$(kdialog --inputbox "Geben Sie Ihren Namen ein:" "IhrName")</userinput
>. Das letzte Argument ist optional, es wird benutzt, um dem Textfeld einen Vorgabewert zu geben.</para>
<screen
><userinput
><varname
>Passwort</varname
>=$(<command
>kdialog</command
> <option
>--password "Geben Sie Ihr Passwort ein:"</option
>)</userinput
></screen>
<para
>Die Option <option
>--dontagain</option
> wird zusammen mit <option
>--inputbox</option
> oder <option
>--password</option
> nicht beachtet.</para>
<para
>Es gibt zwei Dialoge, in denen der Benutzer einen Eintrag aus einer Liste wählen kann:</para>
<variablelist>
<varlistentry>
<term
><option
>--menu</option
></term>
<listitem>
<para
>Der Benutzer kann einen einzelnen Eintrag aus einer Liste wählen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><option
>--checklist</option
></term>
<listitem>
<para
>Der Benutzer kann einen oder mehrere Einträge aus einer Liste wählen.</para>
</listitem>
</varlistentry>
</variablelist>
<screen
><userinput
><varname
>city</varname
>=$(<command
>kdialog</command
> <option
>--menu "Wählen Sie eine Stadt" a London b Madrid c Paris d Berlin</option
>)</userinput
></screen>
<para
><varname
>$city</varname
> gibt den Wert <returnvalue
>a</returnvalue
>, <returnvalue
>b</returnvalue
>, <returnvalue
>c</returnvalue
> oder <returnvalue
>d</returnvalue
> zurück.</para>
<screen
><userinput
><varname
>city</varname
>=$(<command
>kdialog</command
> <option
>--checklist "Wählen Sie Städte aus" a London off b Madrid on c Paris on d Berlin off</option
>)</userinput
></screen>
<para
>Madrid und Paris sind bereits ausgewählt. Das Ergebnis mit der Auswahl von Madrid und Paris ist <returnvalue
>"b"</returnvalue
> <returnvalue
>"c"</returnvalue
>.</para>
<para
>Wenn Sie als Option <option
>--separate-output</option
> hinzufügen, wird <returnvalue
>b</returnvalue
> und <returnvalue
>c</returnvalue
> jeweils in einer eigenen Zeile ausgegeben, damit ist die Weiterbearbeitung der Rückgabewerte einfacher.</para>
