<chapter id="help-system-user-manual">
<docinfo>
<date>02/10/2000</date>
<releaseinfo>1.94.00</releaseinfo>
</docinfo>
<title>Benutzerhandbuch zum KDE-Hilfe-System</title>
<anchor id="help">

<sect1 id="help-introduction">
<title>Das KDE-Hilfe-System</title>

<para>
Das KDE-Hilfe-System wurde daf&uuml;r entwickelt, sowohl die allgemeinen
Unix-Hilfe-Systeme (<application>man</application> und 
<application>info</application>) als auch die KDE-Dokumentationen
(<abbrev>HTML</abbrev>) einfach zug&auml;nglich zu machen. 
</para>

<para>
Alle KDE-Anwendungen der Basispakete sind dank des Dokumentationsteams
voll dokumentiert. Wenn Sie dabei helfen wollen, Dokumentationen zu schreiben,
wenden Sie sich bitte an den zust&auml;ndigen Koordinator Mike McBride
<email>mmcbride@ematic.com</email>. Es sind keine Vorkenntnisse erforderlich,
nur Enthusiasmus und Geduld. Wenn Sie helfen wollen, KDE-Dokumentation
in Ihre Sprache zu &uuml;bersetzen, wenden Sie sich an den &Uuml;bersetzungskoordinator
Eric Bischoff <email>ebisch@cybercable.tm.fr</email>.
Mehr Informationen, u.a. auch &uuml;ber die Koordinatoren f&uuml;r die verschiedenen
Sprachenteams erhalten Sie &uuml;ber die
<ulink url="http://i18n.kde.org">Internationalisierungs-Webseite</ulink>,
und im Abschnitt <link linkend="contact">Das KDE-Team kontaktieren</link>.
</para>
<note><para>
Anm. d. &Uuml;bersetzers: Wenn Sie dabei helfen wollen, die 
KDE-Dokumentation oder Anwendungen ins Deutsche zu &uuml;bersetzen, wenden Sie 
sich bitte an den Koordinator des deutschen Teams Thomas Diehl
<email>thd@kde.org</email> oder besuchen Sie unsere 
<ulink url="http://i18n.kde.org/teams/de">Webseite</ulink>.
</para></note>

<sect2 id="installation">
<title>Installation</title>

<para>Das &khelpcenter; ist ein integraler Bestandteil der KDE-Basisinstallation
und wird mit jeder Kopie von KDE installiert. Sie ist im Paket kdebase
enthalten und ist auf der <ulink url="ftp://ftp.kde.org/">KDE-FTP-Seite</ulink>
erh&auml;ltlich oder sie ist im Paket kdebase Ihrer Linux-Distribution enthalten.
</para>

</sect2>
</sect1>

<sect1 id="invoking-help">
<title>Die Hilfe aufrufen</title>

<para>Das &khelpcenter; kann auf mehrere Arten aufgerufen werden:</para>

<variablelist>
<varlistentry>
<term>Vom <guimenu>Hilfe</guimenu>-Men&uuml;</term>
<listitem><para>
Am gebr&auml;uchlichsten wird wohl der Aufruf von einer Anwendung aus sein.
W&auml;hlen Sie <menuchoice><guimenu>Hilfe</guimenu>
<guimenuitem>Inhalt...</guimenuitem></menuchoice>, um das Inhaltsverzeichnis
der Dokumentation zu dieser Anwendung angezeigt zu bekommen.
</para></listitem>
</varlistentry>

<varlistentry>
<term>Vom <guimenu>K</guimenu>-Men&uuml;</term>
<listitem><para>Klicken Sie auf das gro&szlig;e <guiicon>K</guiicon> in der 
Kontrollleiste und w&auml;hlen Sie dann den Eintrag
<guimenuitem>Hilfe</guimenuitem>, um das &khelpcenter; auf der Startseite
zu &ouml;ffnen.
</para></listitem>
</varlistentry>

<varlistentry>
<term>Von der Kontrollleiste</term>
<listitem><para>Die Kontrollleiste (auch <application>Kicker</application>
genannt) enth&auml;lt standardm&auml;&szlig;ig ein Symbol, um das &khelpcenter; aufzurufen.
Es stellt einen rot-wei&szlig;en Rettungsring dar. Auch hier wird wieder die
Startseite angezeigt.
</para></listitem>
</varlistentry>

<varlistentry>
<term>Von der Befehlszeile</term>
<listitem><para>Das &khelpcenter; kann mit einer <abbrev>URL</abbrev> aufgerufen
werden, um eine bestimmte Datei anzuzeigen.
<abbrev>URL</abbrev>s k&ouml;nnen auch dazu benutzt werden, 
um <application>Info</application>- und <application>man</application>-Seiten 
aufzurufen. Folgende Beispiele zeigen, wie Sie das &khelpcenter; aufrufen k&ouml;nnen.
</para>

<variablelist>
<varlistentry>
<term>Die Hilfe-Seite einer KDE-Anwendung</term>
<listitem><para><command>khelpcenter
<option>help://<replaceable>kedit</replaceable></option></command></para>
<para>&ouml;ffnet die <application>KEdit</application>-Dokumentation am 
Inhaltsverzeichnis.
</para></listitem> <!-- LW: This doesn't seem to be working anymore -->
</varlistentry>

<varlistentry>
<term>Eine lokale Datei</term>
<listitem><para><command>khelpcenter
<option><replaceable>file:/usr/local/src/qt/html/index.html</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>Eine Man-Seite</term>
<listitem><para><command>khelpcenter
<option>man:/<replaceable>strcpy</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>Eine Info-Seite</term>
<listitem><para><command>khelpcenter <option>info:/<replaceable>"(gcc)G++ and
GCC"</replaceable></option></command></para></listitem>
</varlistentry>
</variablelist>

<para>Wenn Sie <command>khelpcenter</command> ohne Parameter aufrufen,
wird die Startseite angezeigt.
</para></listitem>
</varlistentry>

</variablelist>
</sect1>

<!-- Interface - Basics, using Konqueror -->
<sect1 id="interface-basics">
<title>Die Oberfl&auml;che des &khelpcenter;</title>

<para>Die Oberfl&auml;che des &khelpcenter; besteht aus zwei Teilen, eingebettet in
ein &konqueror;-Fenster. Die Benutzung der &konqueror;-Oberfl&auml;che macht die Navigation 
genauso einfach, als wenn Sie sich im Internet bewegen w&uuml;rden.
Zus&auml;tzlich enthalten die meisten Dokumentationen zus&auml;tzliche 
Navigationselemente, die es Ihnen erm&ouml;glichen entweder sequentiell 
(unter Benutzung der <guilabel>Vor</guilabel>- und 
<guilabel>Zur&uuml;ck</guilabel>-Verkn&uuml;pfungen) 
oder weniger strukturiert durch das Dokument zu gehen.
Verkn&uuml;pfungen k&ouml;nnen Sie zu einem anderen Teil des gleichen Dokuments oder zu 
einem anderen Dokument bringen. Au&szlig;erdem k&ouml;nnen Sie die Kn&ouml;pfe
<guiicon>Zur&uuml;ck</guiicon> (Pfeil nach links) oder <guiicon>Nach Vorne</guiicon> 
(Pfeil nach rechts) auf der Werkzeugleiste benutzen, um sich durch die 
Dokumente zu bewegen, die Sie in diesem Fenster angesehen haben.
</para>

<para>Der linke Teil des Fensters zeigt Ihnen den Inhalt der KDE-Hilfe und
der rechte Teil zeigt die Hilfedateien selbst an.
</para>

<sect2 id="contents-pane">
<title>Die <guilabel>Inhalt</guilabel>-Seite</title>

<para>Die <guilabel>Inhalt</guilabel>-Seite ist unterteilt in zwei Karteikarten,
eine die das <link linkend="contents-menu">Inhaltsverzeichnis</link> anzeigt,
das alle Informationen anzeigt, die in dem &khelpcenter; angezeigt werden k&ouml;nnen, und
eine zweite, in der Sie nach bestimmten Informationen <link linkend="search">
suchen</link> k&ouml;nnen.
</para>

<sect3 id="contents-menu">
<title>Das <guilabel>Inhalt</guilabel>sverzeichnis</title>

<para>Das <guilabel>Inhalt</guilabel>sverzeichnis enth&auml;lt standardm&auml;&szlig;ig
folgende Eintr&auml;ge:
</para>

<variablelist>
<varlistentry>
<term><guilabel>Einf&uuml;hrung</guilabel></term>
<listitem><para>Willkommen bei KDE - Eine Einf&uuml;hrung in das
K Desktop Environment.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Einf&uuml;hrung in KDE</guilabel></term>
<listitem><para>Eine Kurzanleitung f&uuml;r KDE. Enth&auml;lt eine F&uuml;hrung durch die
KDE-Oberfl&auml;che und spezielle Hilfe und Tipps, um besser mit KDE zu arbeiten.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>KDE-Benutzerhandbuch</guilabel></term>
<listitem><para>Das KDE-Benutzerhandbuch gibt eine ausf&uuml;hrliche 
Einf&uuml;hrung in KDE, inklusive Installation, Konfiguration, Anpassung
an die eigenen Bed&uuml;rfnisse und nat&uuml;rlich in die Benutzung.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Programm-Handb&uuml;cher</guilabel></term>
<listitem><para>
Handb&uuml;cher zu KDE-Anwendungen. Alle KDE-Anwendungen haben Dokumentationen in
<abbrev>HTML</abbrev>. Dieser Abschnitt listet alle KDE-Dokumentationen mit
einer kurzen Beschreibung und einer Verkn&uuml;pfung zur vollen
Dokumentation des Programms auf.
</para>
<para>
Die Anwendungen werden in einer Baumstruktur dargestellt, die gleich aufgebaut
ist wie die Struktur des <guimenu>K</guimenu>-Men&uuml;s. Das soll es Ihnen 
einfacher machen, die gew&uuml;nschte Anwendung zu finden.
</para></listitem> 
</varlistentry>

<varlistentry>
<term>Unix-Handbuchseiten</term>
<listitem><para>
Unix-Handbuchseiten (man-Seiten) sind das traditionelle Format f&uuml;r Dokumentationen
unter Unix. Die meisten Programme auf Ihrem System werden eine solche
besitzen. Au&szlig;erdem existieren Handbuchseiten zu Programmierfunktionen
und Dateiformaten.
</para></listitem>
</varlistentry>

<varlistentry>
<term>Infoseiten durchsuchen</term>
<listitem><para>TeXinfo-Dokumentation wird von vielen GNU-Anwendungen
benutzt, inklusive <application>gcc</application> (der C/C++-Compiler),
<application>emacs</application>, und vielen anderen.</para></listitem>
</varlistentry>

<varlistentry>
<term>Die KDE-FAQ</term>
<listitem><para>H&auml;ufig gestellte Fragen &uuml;ber KDE und ihre Antworten.
</para></listitem>
</varlistentry>

<varlistentry>
<term>KDE im Web</term>
<listitem><para>
Verkn&uuml;pfungen zu KDE im Web, z.B. die offizielle KDE-Webseite
aber auch andere n&uuml;tzliche Seiten.
</para></listitem>
</varlistentry>

<varlistentry>
<term>Kontakt-Informationen</term>
<listitem><para>Informationen dar&uuml;ber, wie man mit den KDE-Entwicklern
Kontakt aufnimmt und wie man KDE-Mailinglisten abonniert.
</para></listitem>
</varlistentry>

<varlistentry>
<term>KDE unterst&uuml;tzen</term>
<listitem><para>Wie man helfen kann.</para></listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="search">
<title>Die <guilabel>Suchen</guilabel>-Karteikarte</title>

<para>
Um die Suchfunktion nutzen zu k&ouml;nnen, muss das Programm 
<application>ht://dig</application> installiert sein.
Die Optionen f&uuml;r den Suchindex k&ouml;nnen Sie konfigurieren bzw. den Suchindex 
erstellen k&ouml;nnen Sie im <application>KDE-Kontrollzentrum</application>, 
oder indem Sie auf den Knopf <guibutton>Stichwortverzeichnis 
aktualisieren</guibutton> dr&uuml;cken.
Hier erhalten Sie auch detaillierte Dokumentation &uuml;ber den Suchindex.
</para>

<para>
Im Folgenden soll davon ausgegangen werden, dass Sie den Suchindex schon
erstellt haben.
</para>

<para>
Die Hilfe-Dateien zu durchsuchen sollte intuitiv machbar sein.
Geben Sie die gew&uuml;nschten Suchbegriffe ein, w&auml;hlen Sie die gew&uuml;nschten 
Optionen und dr&uuml;cken Sie auf den Knopf <guibutton>Suchen</guibutton>.
Das Ergebnis wird Ihnen im rechten Teil des Hilfe-Fensters angezeigt.
</para>

<para>Die verf&uuml;gbaren Optionen sind:</para>

<variablelist>
<varlistentry>
<term><guilabel>Methode</guilabel></term>
<listitem><para>
W&auml;hlen Sie hier, wie mehrere Worte gesucht werden sollen. Wenn Sie 
<guilabel>und</guilabel> w&auml;hlen, werden nur Seiten angezeigt, die alle
gesuchten Worte beinhalten. 
<guilabel>Oder</guilabel> sucht Seiten, die mindestens eines der 
gesuchten Worte enthalten und <guilabel>Boolscher Ausdruck</guilabel> 
erlaubt Ihnen eine Kombination dieser beiden Optionen zu benutzen.
</para>
<para>Bei Boolschen Ausr&uuml;cken k&ouml;nnen Sie die Schl&uuml;sselworte 
<literal>AND</literal>, <literal>OR</literal> und <literal>NOT</literal> 
benutzen, um komplexe Suchen zu bewerkstelligen.
Einige Beispiele:</para>
<variablelist>
<varlistentry>
<term><userinput>Katze AND Hund</userinput></term>
<listitem><para>Sucht nach Seiten, die beide Begriffe 
<userinput>Katze</userinput> und <userinput>Hund</userinput> enthalten.
Seiten, die nur eines der beiden W&ouml;rter enthalten, werden nicht angezeigt.
</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>Katze NOT Hund</userinput></term>
<listitem><para>
Sucht nach Seiten, die zwar <userinput>Katze</userinput> enthalten, aber 
nicht das Wort <userinput>Hund</userinput>
</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>Katze OR (Hund NOT Nase)</userinput></term>
<listitem><para>
Sucht nach Seiten, die <userinput>Katze</userinput>, 
und nach Seiten, die <userinput>Hund</userinput> aber nicht
<userinput>Nase</userinput> enthalten.  Seiten, die 
<userinput>Katze</userinput> und <userinput>Nase</userinput> enthalten,
w&uuml;rden angezeigt aber Seiten, die alle drei Worte enthalten, nicht.
</para></listitem> 
</varlistentry>
</variablelist>

<para>
Wenn Ihre Suchanfragen nicht die gew&uuml;nschten Ergebnisse liefern, pr&uuml;fen Sie
sorgf&auml;ltig, ob Sie nicht den falschen Suchbegriff mit einem 
<literal>NOT</literal> oder einer verirrten Klammer ausgeschlossen haben.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Max. Treffer</guilabel></term>
<listitem><para>
Legt fest, wieviele Suchergebnisse maximal angezeigt werden.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Format</guilabel></term>
<listitem><para>
Legen Sie fest, ob Sie nur eine kurze Verkn&uuml;pfung zur gefundenen
Seite haben wollen, oder ob eine l&auml;ngere Zusammenfassung angezeigt haben wollen.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Sortieren</guilabel></term>
<listitem><para>
Legt fest, ob die Suchergebnisse nach der <guilabel>Bewertung</guilabel> 
(wie genau Ihre Suchanfrage zugetroffen hat), Alphabetisch nach dem 
<guilabel>Titel</guilabel> oder nach dem <guilabel>Datum</guilabel>
sortiert werden sollen.
Wenn Sie das Auswahlk&auml;stchen <guilabel>Umgekehrt anordnen</guilabel>
aktivieren, wird die Sortierung der Suchergebnisse umgekehrt.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Stichwortverzeichnis aktualisieren</guilabel></term>
<listitem><para>
Hier k&ouml;nnen Sie das Stichwortverzeichnis aktualisieren, um neu 
hinzugekommene Dokumente hinzuzuf&uuml;gen oder wenn Sie das Gef&uuml;hl haben, dass
das Verzeichnis nicht komplett oder besch&auml;digt ist.
</para></listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

<sect2 id="man-and-info">
<title>Die <application>Man</application> und <application>Info</application>
Abschnitte</title>

<para>
Man-Seiten sind die Standard-Unix-Handb&uuml;cher und werden seit vielen Jahren
auf vielen Betriebsystem benutzt. Sie sind sehr ausf&uuml;hrlich und die beste
Anlaufstelle, um Informationen &uuml;ber die meisten Linux-Befehle und -Anwendungen
zu erhalten.
</para>

<para>
Die Man-Seiten sind jedoch nicht perfekt. Sie tendieren dazu, zu ausf&uuml;hrlich 
zu sein, aber auch sehr technisch. Geschrieben von Entwicklern und f&uuml;r
Entwickler. In machen F&auml;llen macht sie das f&uuml;r viele Benutzer unverst&auml;ndlich.
Trotzdem sind sie die beste Quelle f&uuml;r fundierte Information &uuml;ber die meisten
Kommandozeilen-Programme und oft genug sind sie die einzige Quelle.
</para>

<para>
Wenn Sie sich je gefragt haben, was die Nummer bedeutet, wenn jemand schreibt
man(1) o.&auml;.: Sie gibt den Abschnitt an, in welchen sich das Thema befindet.
Das &khelpcenter; benutzt diese Nummern, um die Man-Seiten in ihre zugeordneten
Abschnitte einzuteilen. Dies macht es f&uuml;r Sie wesentlich einfacher, die
gew&uuml;nschte Information zu finden.
</para>

<para>
Au&szlig;erdem sind noch die Info-Seiten verf&uuml;gbar. Diese wurden als Ersatz
f&uuml;r die Man-Seiten entworfen. Die Betreuer mancher Anwendungen aktualisieren
nicht mehr l&auml;nger die Man-Seite. Wenn also eine Man- und eine Info-Seite
f&uuml;r eine Anwendung vorhanden sind, dann wird wahrscheinlich die Info-Seite
die aktuellere sein.
</para>

<sect3 id="navigation">
<title>Navigation in <application>Info</application>-Seiten</title>

<para>Info-Dokumente sind hierarchisch angeordnet, wobei jede Seite ein Knoten
genannt wird. Alle Info-Dokumente haben einen 
<guilabel>Top</guilabel>-Knoten, z.B. die Einleitungsseite.
Sie kommen jederzeit zum <guilabel>Top</guilabel>-Knoten zur&uuml;ck, indem
Sie auf <guilabel>Top</guilabel> klicken.</para>

<para><guibutton>Zur&uuml;ck</guibutton> & <guibutton>Vor</guibutton> 
werden dazu benutzt um zur vorherigen oder n&auml;chsten Seite in der gleichen
Hierarchie-Ebene zu kommen.
</para>

<para>
Wenn Sie auf einen Men&uuml;punkt in einem Dokument dr&uuml;cken, kommen Sie auf eine
tiefere Ebene in der Hierarchie. Sie kommen auf eine h&ouml;here Ebene, indem Sie
<guibutton>Hoch</guibutton> klicken.</para>

<!-->
<para>Man is treated similarly to info, with the section index being the Top
node and each man page on the level below.  Man entries are one page long.</para>
<-->
</sect3>
</sect2>
</sect1>

<sect1 id="credits">
<title>Mitwirkende und Lizenzen</title>

<para>&khelpcenter;</para>

<para>Urspr&uuml;nglich wurde die KDE-Hilfe von Matthias Elter 
<email>me@kde.org</email> entwickelt.</para>
<para>Der derzeitige Betreuer ist Matthias Hoelzer-Kluepfel
<email>mhk@kde.org</email></para>

&underFDL;
&underGPL;

</sect1>
</chapter>
