# Le manuel de KFind

Miroslav
Flídr

    flidr@kky.zcu.cz

Martin
Hartig

    hartig@mathematik.uni-kl.de

Mark
Roberts

    mar2@scigen.co.uk

Version 0.4, 21 juin 1998

Ce manuel décrit KFind version 0.4

Le manuel de KFind

KDE
KFind
recherche de fichiers

## Introduction

Kfind cherche les fichiers correspondant à des critères de recherche à l'intérieur d'une hiérarchie de répertoires.

Souvent vous savez qu'un fichier est "là dans le coin", mais vous ne pouvez pas vous souvenir où exactement, même avec un bon effort. KFind est exactement l'outil qu'il vous faut pour résoudre ce genre de problèmes. Une fois que vous avez trouvé les fichiers cherchés, vous pouvez:

- les sauver,

- les détruire,

- changer leurs attributs,

- les archiver et/ou

- ouvrir le répertoire les contenant dans le gestionnaire de fichiers (Kfm).

J'espère que vous trouverez ce programme utile et j'apperecierai toutcommentaire ou suggestion.

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

## Installation

### Comment obtenir KFind

KFind fait partie du projet KDE http://www.kde.org. KFind peut être trouvé sur ftp://ftp.kde.org/pub/kde/, le site ftp principal du projet KDE. Là se trouvent également des liens vers les nombreux miroirs FTP disponibles.

### Configuration nécessaire

Pour compiler avec succès KFind, vous avez besoin des dernières versions de `libkdecore`et de `libkfm`. Toutes les bibliothèques nécessaires ainsi que KFind lui-même peuvent se trouver sur ftp://ftp.kde.org/pub/kde/.

### Compilation et installation

Kfind est normalement partie intégrante d'une distribution de KDE et en tant que telsera automatiquement installé avec les autres applications KDE lors du processus normald'installation de KDE.

Si vous avez toutefois besoin de compiler et installer KFind vous-même sur votre système,tapez les commandes suivantes dans le répertoire de base de la distribution de KFind:

    % ./configure% make% make install

Dans la mesure où KFind utilise `autoconf`, vous ne devriez pas avoir de problèmes à le compiler.Si vous deviez toutefois rencontrer des problèmes, veuillez les signaler aux listes de diffusion deKDE.

### Configuration

La configuration se fait normalement par l'intermédiaire du dialogue de Préférences; reportez-vous à la section "usage" de ce manuel pour plus de détails. Une description technique de la configuration de kfind suit pour ceux que ça intéresse:

Kfind lit les paramètres de configuration depuis un fichier de configuration (normalement`˜/.kde/share/config/kfindrc`).

Ce fichier contient des informations sur la sauvegarde des résultats de la recherche, les archives disponibles et d'autres paramètres de configuration; ces paramètres peuvent être édités via le dialogue de Préférences de `Kfind`.

Informations de base: Le fichier de configuration se compose de sections. Chaque section commence pas un titre entre crochets, par exemple `[Saving]` .

Les informations suivant l'en-tête se rapportent à un aspect spécifique du fonctionnement de `Kfind`.

Configuration de la sauvegarde: Le fichier de configuration contient le nom et le formatdu fichier à utiliser pour sauver les résultats de la recherche. Ces paramètres sont stockéscomme suit:

    [Saving]
    Format=HTML
    Filename=/root/resultat.html

Avec `Format` pouvant prendre les valeurs `HTML` ou `Plain Text`.

Configuration d'archivage: Les formats d'archives utilisables par `kfind` sontspecifiés dans la section `[Archiver Types]` de kfindrc comme suit:

    [Archiver Types]Archivers=tar;zip;zoo;

Chaque format est détaillé dans une section qui lui est propre:

    [tar]
    ExecOnCreate=tar cf %a -C %d %n
    ExecOnUpdate=tar uf %a -C %d %n
    Comment=Tar

La première ligne contient la commande à exécuter lorsqu'on crée une nouvelle archive et la secondesert à mettre à jour les archives existantes. La troisième est le commentaire utilisépour décrire le format d'archive dans le dialogue de Préférences. Des variables peuvent être utilisés dans ces commandes, et leur notation commence par un signe &percnt;.

Ci-dessous se trouve une liste des variables de ligne de commande autorisées:

`&percnt;a` Le nom complet de l'archive

`&percnt;f` Le nom de fichier normal

`&percnt;d` Le répertoire parent. Si l'argument donné est un fichier (et non un répertoire),alors cette variable désigne le répertoire contenant ce fichier.

`&percnt;n` Le nom du fichier. Si l'argument donné est un repertoire alors cette variabledésigne le nom de ce répertoire.

## Opérations de base à l'écran

Dans cette section on décrit brièvement l'interface utilisateur de Kfind.

La fenêtre de Kfind est divisée en trois zones: la barre d'outils, les paramètres de recherche, et la zone d'affichage. La zone d'affichage et la barre d'état ne sont visibles qu'après avoir reçu les résultats de la recherche.

### Barre d'outils

Lancer la recherche

  Démarre une nouvelle recherche en utilisant les critères spécifiés en paramètres.

Nouvelle recherche

  Efface les résultats et redémarre une nouvelle recherche.

Arrêter la recherche

  Stoppe l'exécution du processus de recherche.

Ouvrir

  Demande à Kfm de démarrer l'application liée par défaut au fichier sélectionné.

Ajouter à l'archive...

  Ajoute le fichier sélectionné à l'archive choisie.

Supprimer

  Efface les fichiers sélectionnés et demande à Kfm d'actualiser l'affichage du répertoire.

Propriétés

  Affiche les attributs du fichier sélectionné.

Ouvrir le dossier conteneur

  Demande à Kfm d'ouvrir le dossier contenant le fichier sélectionné.

Enregistrer les résultats

  Sauve les résultats de la recherche dans le fichier spécifié dans le dialogue Options->Preferences.

Aide

  Affiche la documentation de KFind.

Quitter

  Sort de KFind.

### Dialogue des paramètres de la recherche

Ce dialogue est le principal composant de `KFind`. Il sert à spécifierles paramètres de recherche. Il y a trois groupes de paramètres de recherche:

Nom et emplacement

  Cet onglet sert à indiquer le nom du fichier à rechercher. Ce nom de fichier est entré dansune liste déroulante et peut contenir les jokers suivants:

  - ? remplace tout caractère isolé

  - * remplace toute séquence de caractères

  - &lsqb; ] remplace un ensemble défini de caractères, par exemple &lsqb;a-zA-Z0-9] remplace les majuscules, les minuscules et les chiffres.

  - \ remplace un alphanumérique ou un point

  La liste déroulante garde une trace des noms entrés. Le bouton Parcourir... permet de spécifierle répertoire où la recherche aura lieu. La case à cocher Inclure les sous-dossiers indique sila recherche doit avoir lieu dans les sous-répertoires.
Date de modification

  Cet onglet permet de chercher les fichiers créés ou modifiés à l'intérieur d'une période donnée.

Avancé

  Cet onglet permet des recherches de fichiers de types donnés, par exemple des documents Postscript, des images JPEG ou des sons WAV.

### Zone d'affichage

La zone d'affichage contient les résultats du processus de recherche. Après qu'un fichier ait été sélectionné, les fonctions d'ouverture, d'archivage, de suppression, d'affichage des propriétés etd'ouverture du dossier contenant sont activées. Le double clic provoque l'exécution.

## Les éléments de menu

### Fichier

Les fonctions suivantes sont disponibles depuis le menu Fichier:

Ouvrir

  Cette option demande à kfm d'ouvrir le fichier couramment sélectionné, en utilisant le lien par défaut; par exemple les programmes seront exécutés, les fichiers de textedémarreront l'éditeur de texte, etc. Cette action peut également être accomplie en double-cliquant sur le nom de fichier dans la liste des fichiers trouvés.

Ajouter à l'archive

  Ajoute le fichier sélectionné à une archive.

Supprimer

  Supprime le fichier sélectionné.

Propriétés

  Permet d'éditer les propriétés du fichier sélectionné.

Ouvrir le dossier conteneur

  Ouvre le dossier contenant le fichier sélectionné dans une fenêtre du gestionnaire de fichiers (KFM).

Enregistrer la recherche

  Sauve la liste des fichiers sélectionnés.

Quitter

  Sort de `Kfind` .

### Edition

Les éléments de ce menu sont inactivés.

### Options

Depuis ce menu vous pouvez lancer le dialogue de préférences. Le premier ongletdu dialogue de préférences permet de choisir le nom et le format du fichier où les résultats de la recherche sont rangés. Le second onglet montre les types de fichierdisponibles et les détails concernant les archiveurs.

Enregistrement

  Indique le nom du fichier où seront rangés les résultats de la recherche.Le nom par défaut est `.kfind-results.html` dans le répertoire personnel de l'utilisateur. Si un autre nom est choisi, on peut spécifier le format des résultats. HTML et Texte (.txt) sont les formats actuellement supportés.

Archiveurs

  Cet onglet permet l'affichage (et dans le futur, probablement l'édition)des définitions associées à l'archivage déclenché par la fonction Ajouter à l'archive....

### Aide

Permet l'affichage d'informations sur KFind ainsi que la documentation de KFind.

## Conclusion

### Developpeurs

Miroslav Flídr

  E-Mail: flidr@kky.zcu.cz

Mario Weilguni;

  E-Mail: mweilguni@kde.org

### Auteurs

Miroslav Flídr

  E-Mail: flidr@kky.zcu.cz

Martin Hartig

  E-Mail: hartig@mathematik.uni-kl.de

Mark Roberts

  E-Mail: mar2@scigen.co.uk

Eric Bischoff

  - Editeur E-mail: ebisch@cybercable.tm.fr

Eric Bischoff

  - Traduction françaiseE-mail: ebisch@cybercable.tm.fr