Mike
McBride
Jost
Schenck
Jürgen
Nagel

    JuergenNagel@web.de

Deutsche Übersetzung
2000-10-21
1.00.00
KDE
Kontrollzentrum
Hilfeindex
Index

# Hilfeindex

## Einleitung

KDE 2.0 wird mit einer umfangreichen Dokumentation für Anwendungen und Komponenten ausgeliefert. Es ist natürlich möglich, die einzelnen Hilfedokumente zu durchblättern, bis man die gewünschte Information findet. Das kann aber sehr zeitaufwändig sein. Um diese Aufgabe zu vereinfachen, enthält KDE eine Volltextsuche mit einem Programm namens ht://dig. Es funktioniert ähnlich wie Suchmaschinen im Internet, einige der Internetsuchmaschinen basieren sogar auf diesem Programm. Zur Benutzung klickt man im KDE Hilfezentrum auf "Suchen", tippt das gesuchte Wort ein und klickt auf den Knopf Suchen.

Bevor das Programm ht://dig verwendet werden kann, muss es zunächst auf dem System installiert sein und KDE muss für die Verwendung von ht://dig konfiguriert werden. Dieses Modul hilft bei der Konfiguration. Wenn ht://dig nicht installiert ist und nicht mit dem Betriebssystem ausgeliefert wurde, müssen sie ht://dig selbst besorgen. Auf der ht://dig Homepage findet man Informationen zum Herunterladen und installieren.

## Benutzung

Zwei wichtige Informationen muss KDE zur Verwendung der Volltextsuchmaschine haben:

- wo sich die ht://dig-Programme, die KDE für die Suche verwendet, befinden

- wo gescuht werden soll

### Die ht://dig-Programme

Drei Programme von ht://dig werden von KDE benötigt: `htdig`, `htsearch` und `htmerge`. Für jedes dieser Programme muss der vollständige Pfadname angegeben werden, also zum Beispiel: `/usr/bin/htdig`.

Wo sich diese Programm befinden hängt vom Betriebssystem und der Distribution ab. Wahrscheinliche Plätze sind:

- für `htdig` und `htmerge` das Verzeichnis `/usr/bin/` oder ein Verzeichnis wie `/usr/local/www/htdig/bin/`.

- für `htsearch` oft ein Unterverzeichnis names `cgi-bin`, also zum Beispiel `/usr/local/httpd/cgi-bin/`.

Man kann auch zum Beispiel den Befehl `whereis htdig` in einem Konsolenfenster eingeben, um die Position des Programms `htdig` zu bestimmen. Der Befehl `whereis` sucht die Zeichenkette in den Standardpfaden für ausführbare Dateien. Da sich aber Verzeichnisse wie `cgi-bin` oft nicht in den Standardpfaden befinden, können nicht alle Befehle so gefunden werden.

### Bereich und Suchpfade

In diesem Abschnitt kann man festlegen, welche Bereich der Dokumentation indiziert, also für die Suchmaschine verfügbar gemacht, werden sollen.

In der Gruppe Bereich können einige typische Ressourcen ausgewählt werden, also die KDE Hilfedateien und die Dateien, die von den Befehlen `man` und `info` verwendet werden. Anmerkung: einige davon können noch deaktiviert sein, weil die Unterstützung dafür noch nicht programmiert worden ist.

Wenn man eigene Hilfedateien hat, die auf diesem Wege verfügbar gemacht werden sollen, so ist das auch möglich. Zum Beispiel hat man eine HTML-Referenz unter `/home/jdoe/docs/selfhtml` installiert. Indem man diesen Pfad zur Liste Zusätzliche Suchpfade hinzufügt, macht man sie in der Volltextsuche verfügbar. Dazu klickt man auf Hinzufügen und ein Dialog erscheint, mit dessen Hilfe das zusätzliche Verzeichnis ausgewählt werden kann. Man wählt `/home/jdoe/docs/selfhtml` und klickt auf OK. Um einen zusätzlichen Suchpfad zu entfernen, wählt man ihn aus und klickt auf Löschen.

Die Änderungen für den Bereich und die zusätzlichen Suchpfade wirken sich erst aus, wenn man durch klicken auf Stichwortverzeichnis erstellen einen neuen Index erstellt hat.

### Spracheinstellungen

Man kann die gewünschte Sprache für die Hilfedateien im Listenfeld Spracheinstellungen festlegen.

## Abschnittsautor

Der Abschnitt wurde geschrieben von: Jost Schenck jost@schenck.de

Kleinere Aktualisierungen von: Mike McBride mpmcbride7@yahoo.com