# Das &khelpcenter-de;

## Handbuch zum &kde;-Hilfe-System

### Hilfe-System

Das Hilfe-System wurde dafür entwickelt, sowohl die allgemeinen &UNIX;-Hilfen (man und info) als auch die Dokumentationen für &plasma-workspaces; und aller Anwendungen (&XML;) einfach zugänglich zu machen.

Alle Anwendungen einschließlich der &plasma-workspaces; sind Dank der Anstrengungen des Dokumentationsteams dokumentiert. Falls Sie mit helfen möchten, die Dokumentation zu aktualisieren und zu verbessern, abonnieren Sie die Mailingliste des Dokumentationsteams oder schreiben an das Team unter der E-Mailadresse kde-doc-english@kde.org. Es werden keine Vorkenntnisse vorausgesetzt, nur Engagement und Durchhaltevermögen.

Falls Sie bei der Übersetzung der &kde;-Dokumentation in Ihre Muttersprache behilflich sein möchten, finden Sie weitere Informationen dazu, einschließlich der Koordinatoren für die einzelnen Sprachenteams, auf den Webseiten für die Lokalisierung (l10n) von &kde;.

#### Installation

Das &khelpcenter-de; ist ein integraler Bestandteil der &applications;. Dieses Programm finden Sie auf der Seite download.kde.org des &kde;-Projekts oder im Paket &khelpcenter; Ihrer Linux-Distribution.

### Die Hilfe aufrufen

Das &khelpcenter-de; kann auf mehrere Arten aufgerufen werden:

Vom Menü Hilfe

- Am gebräuchlichsten wird wohl der Aufruf von einer Anwendung aus sein. Wählen Sie F1 Hilfe Handbuch zu ..., um die Dokumentation zu dieser Anwendung angezeigt zu bekommen.

Vom Anwendungsstarter-Menü

- Klicken Sie auf das große K in der Kontrollleiste und wählen Sie dann den Eintrag Hilfe im Abschnitt Anwendungen oder tippen Sie `hilfe` ein und wählen dann Hilfe, um das &khelpcenter-de; mit der Startseite zu öffnen.

Von der Befehlszeile

- Das &khelpcenter-de; kann mit einer &URL; aufgerufen werden, um eine bestimmte Datei anzuzeigen. &URL;s können auch dazu benutzt werden, um info- und man-Seiten aufzurufen. Folgende Beispiele zeigen, wie Sie das &khelpcenter-de; aufrufen können.

  Die Hilfe-Seite einer Anwendung

- `khelpcenter` `help:/`kwrite``

  Öffnet die Dokumentation für &kwrite; auf der Inhaltsseite.

Eine lokale &URL;

- `khelpcenter` `file:/`usr/local/src/qt/html/index.html``

Eine Handbuch-Seite (man page)

- `khelpcenter` `man:/`strcpy``

Eine Info-Seite

- `khelpcenter` `info:/`gcc``

Wenn Sie `khelpcenter` ohne Parameter aufrufen, wird die Startseite angezeigt.

### Die Oberfläche des &khelpcenter-de;

Die Oberfläche von &khelpcenter-de; besteht aus zwei Informationsbereichen.

Werkzeugleiste und Menüs werden in menu-and-toolbar-ref genauer erklärt.

Dokumente beinhalten eigene Navigations-Elemente, um entweder sequentiell mit Hilfe von Weiter, Zurück und Zum Anfang oder mit Hilfe der Verknüpfungen (Hyperlinks) weniger strukturiert durchlesen.

Verknüpfungen verzweigen in einen anderen Teil des gleichen oder in ein anderes Dokument. Mit Hilfe der Knöpfe Zurück (Pfeil nach links) und Vorwärts (Pfeil nach rechts) in der Werkzeugleiste kann man sich auf einem bereits durchlaufenen Weg vorwärts und rückwärts bewegen.

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

#### Der Inhaltsbereich

Der Bereich Inhalt von &khelpcenter-de; wird im linken Teil des Fensters angezeigt. Die Fensterunterteilung kann man verschieben, um die Inhalte jeder der zwei Bereiche vollständig und bequem lesen zu können.

Die Inhaltseite ist in drei Karteikarten unterteilt, eine, die alle verfügbaren Hilfeinformationen des &khelpcenter-de; in einer Bauansicht anzeigt, und eine zweite, die das &kde;-Glossar von Begriffen enthält. Auf der dritten Karteikarte können Sie die Such-Einstellungen anpassen.

##### Die Karteikarte Inhalt

Die Karteikarten Inhalt enthält standardmäßig folgende Einträge in der obersten Ebene der Baumansicht:

Grundlagen

- Die Grundlagen enthalten eine Einführung zu vielen Funktionen der &plasma-workspaces; und &applications; und beschreibt häufig vorkommende Aufgaben, die in vielen Anwendungen ausgeführt werden können.

Handbuch zu Plasma

- Das Handbuch zu &plasma; ist die Dokumentation zu den &plasma-workspaces;.

Online-Hilfe

- Eine Seite mit Verknüpfungen zu Online-Hilfen und zusätzlichen Informationen, die von der &kde;-Gemeinschaft zur Verfügung gestellt werden.

Programmhandbücher

- Handbücher zu &kde;-Anwendungen. Alle &kde;-Anwendungen haben Dokumentationen in &XML;, die zu HTML konvertiert wird. Dieser Abschnitt listet alle &kde;-Dokumentationen mit einer kurzen Beschreibung und einer Verknüpfung zur vollen Dokumentation des Programms auf.

  Die Anwendungen werden in einer Baumstruktur dargestellt, die gleich aufgebaut ist wie die Struktur des K-Menüs. Das soll es Ihnen einfacher machen, die gewünschte Anwendung zu finden.

Die Einträge für Systemeinstellungen-Module

- Listet die Verknüpfungen zu den Handbüchern der verschiedenen Module in den &systemsettings; oder von Modulen für &konqueror;, Dateiverwaltung und Browser auf.

Infozentrum-Module

- Enthält die Verknüpfungen zu den Handbüchern der verschiedenen Infozentrum-Module.

Ein-/Ausgabemodule

- Enthält die Verknüpfungen zu den Handbüchern der verschiedenen Ein-/Ausgabemodule (KIO-Module).

Unix-Hilfeseiten

- &UNIX;-Hilfeseiten (man-Seiten) sind das traditionelle Format für Dokumentationen unter &UNIX;. Die meisten Programme auf Ihrem System werden eine solche besitzen. Außerdem existieren Handbuchseiten zu Programmierfunktionen und Dateiformaten.

Scrollkeeper

- Zusätzliche Dokumentation für Nicht-&kde;-Programme, die auf Ihrem System installiert ist.

Infoseiten durchsehen

- TeXinfo-Dokumentation wird von vielen &GNU;-Anwendungen benutzt, inklusive gcc (der C/C++-Compiler), emacs, und vielen anderen.

##### Die Karteikarte Such-Einstellungen

Suchen in Hilfedateien ist ziemlich intuitiv, geben Sie das Wort, nach dem Sie suchen möchten, in das Textfeld ein, wählen Sie mögliche Einstellungen und drücken Sie Suchen. Die Ergebnisse werden dann im rechten Teil des Fensters angezeigt.

Bei der Suche wird die Groß- und Kleinschreibung nicht beachtet. Suchen Sie also nach Kurzbefehl, dann werden Fundstellen mit kurzbefehl ebenfalls angezeigt.

Die Auswahlmöglichkeiten sind:

Methode

- Stellen Sie hier ein, wie nach mehreren Wörtern gesucht werden soll. Mit der Methode und werden nur Ergebnisse angezeigt, wenn alle Suchbegriffe in der Seite enthalten sind. Mit oder werden Ergebnisse für Seiten angezeigt, in denen einer der Suchbegriffe enthalten ist.

  Zeigt eine Suche nicht die erwarteten Ergebnisse, prüfen Sie sorgfältig, ob Sie nicht den falschen Begriff mit einer falschen Einstellung verwenden.

Max. Ergebnisse

- Legt die maximale Anzahl der Ergebnisse der Suche zurück.

Bereichsauswahl

- Hiermit können Sie die Bereiche auswählen, in denen gesucht werden soll. Als Voreinstellung sind die üblichen Bereiche ausgewählt, mit Benutzerdefiniert könne Sie einzelne Bereiche zur Suche wählen.

#### Die Man und Info Abschnitte

Man-Seiten sind die Standard-&UNIX;-Handbücher und werden seit vielen Jahren auf vielen Betriebssystemen benutzt. Sie sind sehr ausführlich und die beste Anlaufstelle, um Informationen über die meisten &UNIX;-Befehle und -Anwendungen zu erhalten. Wenn RTFM geschrieben wird, wird oft auf diese Handbücher Bezug genommen.

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

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

Außerdem sind noch die Info-Seiten verfügbar. Diese wurden als Ersatz für die Handbuchseiten entworfen. Die Betreuer mancher Anwendungen aktualisieren nicht mehr länger die Handbuchseite. Wenn also eine Handbuch- und eine Info-Seite für eine Anwendung vorhanden sind, dann wird wahrscheinlich die Info-Seite die aktuellere sein. Falls es sich um ein &GNU;-Programm handelt ist die Wahrscheinlichkeit groß, dass man eine Info-Seite aber keine Handbuchseite dazu findet.

##### Navigation in Info-Seiten

Info-Dokumente sind hierarchisch angeordnet, wobei jede Seite ein Knoten genannt wird. Alle Info-Dokumente haben einen Top-Knoten, ⪚ die Einleitungsseite. Sie kommen jederzeit zum Top-Knoten zurück, indem Sie auf Top klicken.

Zurück & Vor werden dazu benutzt um zur vorherigen oder nächsten Seite in der gleichen Hierarchie-Ebene zu kommen.

Wenn Sie auf einen Menüpunkt in einem Dokument drücken, kommen Sie auf eine tiefere Ebene in der Hierarchie. Sie kommen auf eine höhere Ebene, indem Sie Hoch klicken.

Handbuchseiten werden ähnlich zu Info-Seiten mit einem Abschnittsindex, der die verfügbaren Handbuchseiten auflistet, und den tatsächlichen Seiten eine Ebene tiefer angezeigt. Handbuchseiten sind eine Seite lang.

#### Das &kde;-Glossar

Das Glossar stellt eine schnelle Nachschlagemöglichkeit für Definitionen zu ungewohnten Worten dar. Diese beinhalten sowohl &kde;-spezifischen Programme und Technologien wie auch allgemeine &UNIX;-Fachbegriffe.

Im linken Bereich ist eine Baumansicht mit den zwei Auswahlmöglichkeiten Alphabetisch und Nach Thema sichtbar. Beide enthalten die gleichen Einträge in unterschiedlicher Sortierung.

Während man sich durch die Baumstruktur bewegt, werden die Einträge im rechten Bereich des Fensters angezeigt.

#### Die Menüs und die Werkzeugleiste

&khelpcenter-de; hat eine übersichtliche Oberfläche, damit man sich nicht auf das Hilfeprogramm konzentrieren muss und so seine gesamte Aufmerksamkeit auf die eigentlichen Inhalte des Hilfeprogramms lenken kann.

Folgende Symbole sind in der Werkzeugleiste verfügbar:

#### Werkzeugleistensymbole

Inhaltsverzeichnis

- Springt zur Startseite des &khelpcenter-de;s.

Zurück

- Geht zur zuletzt betrachteten Seite zurück. Klicken Sie auf das Häkchen recht neben dem Symbol, dann wird eine Liste aller bereits betrachteten Seiten angezeigt. Wählen Sie aus dieser Liste eine Seite aus, um direkt dorthin zu gehen.

Nach vorne

- Geht eine Seite vorwärts. Dieses Symbol ist nur dann aktiviert, wenn man bereits das Symbol Zurück verwendet hat.

Kopieren

- Kopiert den Text in die Zwischenablage, damit er in einer anderen Anwendung eingefügt werden kann.

Suchen

- Sucht ein oder mehrere Worte auf der gerade angezeigten Seite.

Größere Schrift verwenden

- Vergrößert die Schriftgröße im rechten Teil des Fensters.

Kleinere Schrift verwenden

- Verkleinert die Schriftgröße im rechten Teil des Fensters. Das Symbol ist nur aktiv, falls die Schrift vorher vergrößert wurde.

Die Menüs enthalten folgende Einträge:

Datei

- &Ctrl;P Datei Drucken

- Druckt den Inhalt der gerade angezeigten Seite. Handbücher im PDF-Format finden Sie auf der &kde;-Dokumentationsseite.

&Ctrl;Q Datei Beenden

- Schließt und beendet das &khelpcenter-de;

Bearbeiten

- &Ctrl;C Bearbeiten Kopieren

- Kopiert den markierten Text in die Zwischenablage.

&Ctrl;A Bearbeiten Alles auswählen

- Wählt den gesamten Text der aktuellen Seite aus.

&Ctrl;F Bearbeiten Suchen ...

- Sucht ein oder mehrere Worte auf der aktuellen Seite.

Ansicht

- Ansicht Kodierung festlegen

- Ändert die Kodierung der aktuellen Seite. Normalerweise ist die Einstellung Standard passend, aber falls Probleme bei der Darstellung von Seiten in anderen Sprachen als Englisch auftreten, ist es erforderlich, die richtige Kodierung mit diesem Menü einzustellen.

Gehe zu

- &Alt;Pos1 Gehe zu Inhaltsverzeichnis

- Springt zur Startseite des &khelpcenter-de;s.

&Ctrl;Bild auf Gehe zu Vorige Seite

- Geht zur vorigen Seite der aktuellen Dokumentation

&Ctrl;Bild ab Gehe zu Nächste Seite

- Geht zur nächsten Seite der aktuellen Dokumentation

&Alt;Pfeil links Gehe zu Zurück

- Geht zur vorher angezeigten Seite zurück.

&Alt;Pfeil rechts Gehe zu Nach vorne

- Falls man mit dem Symbol oder dem Menü-Eintrag zurück gegangen ist, kann man den gleichen Weg wieder vorwärts beschreiten.

Lesezeichen

- &Ctrl;B Lesezeichen Lesezeichen hinzufügen

- Fügt ein Lesezeichen für die aktuelle Seite hinzu, der Seitentitel wird an da Menü Lesezeichen angehängt. Benutzen Sie die Aktion Lesezeichen löschen im Kontextmenü eines Eintrags, um ihn zu entfernen.

Lesezeichen Neuer Lesezeichenordner

- Öffnet den Dialog Neuer Ordner, in dem Sie neue Einträge für Untermenüs zum Lesezeichenmenü.

Einstellungen

- Einstellungen Schriften festlegen ...

- Ermöglicht das Einstellen der Schriftart und -größe des &khelpcenter-de;s.

Zusätzlich hat &khelpcenter-de; die bekannten &kde;-Einträge im Menü Einstellungen und Hilfe, weitere Informationen dazu finden Sie in den Abschnitten über die Menüs Einstellungen und Hilfe der &kde;-Grundlagen.

### Danksagungen und Lizenz

&khelpcenter;

Ursprünglich wurde die KDE-Hilfe von &Matthias.Elter; &Matthias.Elter.mail; entwickelt

Derzeitiger Betreuer ist &Cornelius.Schumacher;&Cornelius.Schumacher.mail;

Übersetzung: Matthias Kiefer matthias.kiefer@gmx.de

&underFDL; &underGPL;