# Das KFind-Handbuch

Miroslav
Flídr

    flidr@kky.zcu.cz

Martin
Hartig

    hartig@mathematik.uni-kl.de

Mark
Roberts

    mar2@scigen.co.uk

Version 0.4, 21. Juni 1998

Dieses Handbuch beschreibt die KFind-Version 0.4

Deutsches Handbuch zu Kfind

KDE
Kfind
deutsch

## Einführung

KFind sucht im Dateisystem Dateien nach wählbaren Kriterien.

Häufig sucht man eine Datei und kennt nur noch Bruchteile des Dateinamens, aber kann sich beim besten Willen nicht mehr erinnern, wo denn nun diese Datei gespeichert war. KFind ist dann genau das richtige Werkzeug dafür. Nachdem die Datei(en) gefunden wurden, können sie:

- `gesichert,`

- `gelöscht,`

- `die Eigenschaften geändert,`

- `einem Archiv hinzugefügt werden.`

- `Oder es kann ein Fenster des Dateimanagers (Kfm) in diesem Verzeichnis geöffnet werden.`

Ich hoffe, Sie finden das Programm nützlich. Ich freue mich über Verbesserungsvorschläge und Kommentare.

`Miroslav Flídr` flidr@kky.zcu.cz.

## Installation

### Wie Sie KFind bekommen

KFind ist Teil des KDE Projekts http://www.kde.org. Sie finden KFind auf ftp://ftp.kde.org/pub/kde/, dem hauptsächlichen FTP-Bereich des KDE-Projekts. Darüber hinaus wird das KDE-Projekt auf zahlreichen FTP-Servern gespiegelt.

### Anforderungen

Um KFind erfolgreich kompilieren zu können, benötigen Sie mindestens die neuesten Versionen von `libkdecore` und `libkfm`. Alle benötigten Programmbibliotheken, wie auch KFind selbst, finden Sie auf ftp://ftp.kde.org/pub/kde/.

### Kompilierung und Installation

KFind ist üblicherweise ein integraler Bestandteil der KDE-Versionen und wird daher automatisch mit anderen KDE-Anwendungen installiert. Sofern Sie KFind selbst kompilieren und installieren wollen, erfolgt dies auf die übliche Weise im Verzeichnis der KFind Quelldateien:

    % ./configure
    % make
    % make install

KFind benutzt `autoconf`, daher sollten keine Probleme auftreten. Sofern doch Fehlerhinweise erscheinen, berichten Sie diese bitte an die KDE Mailinglisten.

### Konfiguration

Die Konfiguration erfolgt üblicherweise über den Menüpunkt `Einstellungen`, vgl. den dortigen Hilfetext. Für weiter Interessierte nachfolgend eine technische Beschreibung der Konfiguration:

KFind liest seine Konfigurationsparameter aus der entsprechenden Datei (üblich `˜/.kde/share/config/kfindrc`).

Diese Datei enthält Informationen über das Speichern von Suchergebnissen, verfügbaren Archivprogrammen und anderen Parametern; diese Parameter können teilweise im Kfind `Einstellungen`-Dialog verändert werden

Allgemeine Information: die Datei besteht aus Abschnitten. Jeder Abschnitt beginnt mit einem Titel in eckigen Klammern z.B.: `Saving&rsqb;`

Informationen nach dem Titel beeinflussen spezielle Aspekte des KFind Verhaltens.

Sicherungs-Konfiguration: Das Format und der Dateiname zur Speicherung des Suchergebnisses werden festgelegt. Diese Parameter werden folgendermaßen definiert:

    &lsqb;Saving&rsqb;
    Format=HTML
    Filename=/root/result.html

Das Format kann als `HTML` oder `Plain Text` definiert werden.

Archivierungs-Konfiguration: Archivierungsprogramme werden in kfindrc unter `&lsqb;Archiver Types&rsqb;` festgelegt:

    &lsqb;Archiver Types&rsqb;
    Archivers=tar;zip;zoo;

Jedes Archivierungsprogramm wird mit einem eigenen Eintrag spezifiziert:

    &lsqb;tar&rsqb;
    ExecOnCreate=tar cf %a -C %d %n
    ExecOnUpdate=tar uf %a -C %d %n
    Comment=Tar

Die erste Zeile enthält das Kommando zum Anlegen eines neuen Archivs und die zweite Zeile das Kommando zur Ergänzung eines bestehenden Archivs. Die dritte Zeile enthält den Kommentar zur Beschreibung im `Einstellungen` Dialog. Variablen können in den Befehlen mit einem vorangehenden Prozentzeichen (&percnt;) benutzt werden.

Liste der erlaubten Variablen:

`&percnt;a` Der komplette Name des Archivs

`&percnt;f` Der normale Dateiname

`&percnt;d` Das übergeordnete Verzeichnis. Ist das Argument eine Datei (und kein Verzeichnis), dann wird das Verzeichnis benutzt, in dem sich die Datei befindet.

`&percnt;n` Der Name der Datei. Ist das Argument ein Verzeichnis, dann ist dies der Name des Verzeichnisses.

## Das Programmfenster

In diesem Abschnitt erfolgt eine kurze Beschreibung des KFind Programmfensters.

Das KFind Fenster ist in drei Bereiche aufgeteilt: `Werkzeugleiste, Suchparameter-Dialog und Ergebnisanzeige`. Ergebnisanzeige und Teile der Werkzeugleiste sind erst nach erzielten Suchergebnissen verfügbar.

### Werkzeugleiste

Suche starten

  Startet eine neue Suche mit den Suchparametern aus dem Parameter-Dialog.

Neue Suche

  Löscht bisherige Suchergebnisse und startet mit neuen Parametern.

Suche abbrechen

  Beendet den aktuell laufenden Suchprozeß.

Öffnen

  läßt Kfm die ausgewählte Datei mit dem dafür vorgesehenen Programm starten.

Zum Archiv hinzufügen

  Fügt die ausgewählte Datei dem gewählten Archiv hinzu.

Löschen

  Löscht ausgewählte Datei und aktualisiert die Kfm-Anzeige.

Eigenschaften

  Zeigt die Eigenschaften der ausgewählten Datei.

Öffnen des entsprechenden Verzeichnisses

  Kfm öffnet das Verzeichnis, in dem sich die ausgewählte Datei befindet.

Suchergebnisse speichern

  Speichert die Suchergebnisse in der Datei gemäß `Einstellungen->Optionen` Dialog.

Hilfe

  Zeigt die KFind Dokumentation.

Beenden

  Beendet KFind.

### Suchparameter-Dialog

Dieser Dialog ist der Hauptteil von KFind. Hier werden die speziellen Parameter in drei möglichen Gruppen für die Suche festgelegt:

Name und Pfad

  Der Dialog gibt den Dateinamen an, nach dem gesucht wird. Der Dateiname wird in die Eingabebox eingegeben und kann folgende Jokerzeichen beinhalten:

  - ? bedeutet beliebiges Zeichen

  - * bedeutet beliebige Zeichenfolge

  - &lsqb; &rsqb; Zeichen liegt innerhalb eines definierten Bereichs z.B. &lsqb;a-zA-Z0-9&rsqb;

  - \ Zeichen ist alphanumerisch oder ein Punkt

  Die Eingabebox erinnert sich an bisherige Eingaben. Der Knopf `Auswählen` dient zur Festlegung des Verzeichnisses, in welchem die Suche startet. Ob Unterverzeichnisse in die Suche einbezogen werden, legt das entsprechende Kontrollfeld fest.

Änderungsdatum

  Dieser Dialog erlaubt die Eingrenzung der zu suchenden Dateien nach Erstellungs- bzw. Änderungsdatum (auch Zeiträume).

Erweitert

  Dieser Dialog erlaubt die Suche nach bestimmten Dateitypen z.B. PostScript-Dokumenten, JPEG- oder WAV-Dateien.

### Ergebnisanzeige

Hier werden die Suchergebnisse dargestellt. Nach Anklicken einer Datei können die Funktionen `Öffnen, Zum Archiv hinzufügen, Löschen, Eigenschaften oder Öffnen des entsprechenden Verzeichnisses` genutzt werden. Doppelklicken führt die Datei aus.

## Die Menü-Einträge

### Datei

Folgende Funktionen stehen hier bereit:

Öffnen

  Diese Option öffnet über kfm die ausgewählte Datei mit den Standardeinstellungen, d.h. Programmdateien werden ausgeführt, Textdateien in den Texteditor geladen etc. Diese Aktion kann auch durch Doppelklick auf die Datei veranlaßt werden.

Zum Archiv hinzufügen

  Fügt die ausgewählte Datei dem gewählten Archiv hinzu.

Löschen

  Löscht die ausgewählte Datei.

Eigenschaften

  Anzeige und Möglichkeit der Änderung von Eigenschaften der Datei.

Öffnen des entsprechenden Verzeichnisses

  Öffnet das Verzeichnis, welches die ausgewählte Datei enthält, in einem Dateimanager-(KFM)-Fenster

Suchergebnisse speichern

  Speichert die Liste der gefundenen Dateien.

Beenden

  Beendet KFind

### Bearbeiten

Die Einträge in diesem Menü sind deaktiviert.

### Einstellungen

Aus diesem Menü wird der Einstellungsdialog aufgerufen. Hier wird festgelegt, in welche Datei und mit welchem Format die Suchergebnisse gespeichert werden. Auf der zweiten Karteikarte erscheinen die Archivprogramme und verfügbaren Dateitypen.

Speichern

  Hier wird die Datei zur Speicherung der Suchergebnisse festgelegt. Standard ist `.kfind-results.html` im Persönlichen Verzeichnis. Sofern ein andere Datei gewählt wird, kann das Format für die gespeicherten Ergebnisse festgelegt werden. Aktuell stehen hierzu `HTML` bzw. `Textdatei (.txt)` zur Verfügung.

Archivprogramme

  Anzeige der Archivprogramme und der zugeordneten Dateitypen. Ebenfalls werden die Befehlsfolgen zur Erstellung bzw. Ergänzung eines Archivs dargestellt. Bisher sind die Anzeigefunktionen implementiert (ändern evtl. zukünftig).

### Hilfe

Informationen über KFind und Zugang zur Dokumentation.

## Epilog

### Autoren

Miroslav Flídr

  Autor Email: flidr@kky.zcu.cz

Martin Hartig

  Email: hartig@mathematik.uni-kl.de

Mark Roberts

  Email: mar2@scigen.co.uk

Eric Bischoff

  Redaktion Email: ebisch@cybercable.tm.fr

Werner Müller

  Deutsche Übersetzung Email: werner.mueller@okay.net

Thomas Diehl

  Redaktion der deutschen Übersetzung Email: th.diehl@gmx.net