<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="fr">
<bookinfo>
<title>Le manuel de KFind</title>
<authorgroup>
<author>
<firstname>Miroslav</firstname>
<surname>Flídr</surname>
<affiliation><address><email><ulink url="mailto:flidr@kky.zcu.cz">flidr@kky.zcu.cz</ulink></email></address></affiliation>
</author>
<author>
<firstname>Martin</firstname>
<surname>Hartig</surname>
<affiliation><address><email><ulink url="mailto:hartig@mathematik.uni-kl.de">hartig@mathematik.uni-kl.de</ulink></email></address></affiliation>
</author>
<author>
<firstname>Mark</firstname>
<surname>Roberts</surname>
<affiliation><address><email><ulink url="mailto:mar2@scigen.co.uk">mar2@scigen.co.uk</ulink></email></address></affiliation>
</author>
</authorgroup>
<date>Version 0.4, 21 juin 1998</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<revhistory>
<revision>
<revnumber></revnumber>
<date></date>
</revision>
</revhistory>
<abstract>
<para>Ce manuel décrit KFind version 0.4</para>
<para>Le manuel de KFind</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KFind</keyword>
<keyword>recherche de fichiers</keyword>
</keywordset>
</bookinfo>

<chapter id="Introduction">
<title>Introduction</title>

<para><emphasis remap="bf">Kfind</emphasis> cherche les fichiers correspondant à des critères de recherche à l'intérieur d'une hiérarchie de répertoires.</para>

<para>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. <emphasis remap="bf">KFind</emphasis> 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:
<itemizedlist>
<listitem>
<para>les sauver,</para>
</listitem>
<listitem>
<para>les détruire,</para>
</listitem>
<listitem>
<para>changer leurs attributs,</para>
</listitem>
<listitem>
<para>les archiver et/ou</para>
</listitem>
<listitem>
<para>ouvrir le répertoire les contenant dans le gestionnaire de fichiers (<emphasis remap="bf">Kfm</emphasis>).</para>
</listitem>
</itemizedlist>
</para>

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

<para><literal remap="tt">Miroslav Flídr</literal>
<ulink url="mailto:flidr@kky.zcu.cz">flidr@kky.zcu.cz</ulink>.</para>
</chapter>

<chapter id="Installation">
<title>Installation</title>

<sect1 id="comment-obtenir-kfind">
<title>Comment obtenir KFind</title>

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

<sect1 id="configuration-necessaire">
<title>Configuration nécessaire</title>

<para>Pour compiler avec succès KFind, vous avez besoin des dernières versions de <literal remap="tt">libkdecore</literal>et de <literal remap="tt">libkfm</literal>. Toutes les bibliothèques nécessaires ainsi que KFind lui-même
peuvent se trouver sur <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>.</para>
</sect1>

<sect1 id="compilation-et-installation">
<title>Compilation et installation</title>

<para><emphasis remap="bf">Kfind</emphasis> 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.</para>

<para>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:<screen> 
% ./configure% make% make install
</screen>
Dans la mesure où KFind utilise <literal remap="tt">autoconf</literal>, 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 de<emphasis remap="bf">KDE</emphasis>.</para>
</sect1>

<sect1 id="configuration">
<title>Configuration</title>

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

<para><emphasis remap="bf">Kfind</emphasis> lit les paramètres de configuration depuis un fichier de configuration
 (normalement<literal remap="tt">&tilde;/.kde/share/config/kfindrc</literal>).
 
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 <emphasis remap="bf">Préférences</emphasis> de <literal remap="tt">Kfind</literal>.</para>

<para><emphasis remap="bf">Informations de base:</emphasis> Le fichier de configuration se compose de sections.
Chaque section commence pas un titre entre crochets, par exemple <literal remap="tt">[Saving]</literal>
.</para>

<para>Les informations suivant l'en-tête se rapportent à un aspect spécifique du fonctionnement de
<literal remap="tt">Kfind</literal>.</para>

<para><emphasis remap="bf">Configuration de la sauvegarde:</emphasis> 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:<screen>[Saving]
Format=HTML
Filename=/root/resultat.html
</screen>

Avec <literal remap="tt">Format</literal> pouvant prendre les valeurs <literal remap="tt">HTML</literal> ou <literal remap="tt">Plain Text</literal>.</para>

<para><emphasis remap="bf">Configuration d'archivage:</emphasis> Les formats d'archives utilisables par <literal remap="tt">kfind</literal> sontspecifiés dans la section <literal remap="tt">[Archiver Types]</literal> de <emphasis remap="it">kfindrc</emphasis> comme suit:<screen>[Archiver Types]Archivers=tar;zip;zoo;
</screen>
</para>

<para>Chaque format est détaillé dans une section qui lui est propre:
<screen>[tar]
ExecOnCreate=tar cf %a -C %d %n
ExecOnUpdate=tar uf %a -C %d %n
Comment=Tar
</screen>
</para>

<para>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 <emphasis remap="bf">Préférences</emphasis>.
Des variables peuvent être utilisés dans ces commandes, et leur notation commence par un signe &percnt;.</para>

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

<para><literal remap="tt">&percnt;a</literal> Le nom complet de l'archive</para>

<para><literal remap="tt">&percnt;f</literal> Le nom de fichier normal</para>

<para><literal remap="tt">&percnt;d</literal> 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.</para>

<para><literal remap="tt">&percnt;n</literal> Le nom du fichier. Si l'argument donné est un repertoire alors cette variabledésigne le nom de ce répertoire.</para>
</sect1>
</chapter>

<chapter id="Oprationsdebaselcran">
<title>Opérations de base à l'écran</title>

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

<para>La fenêtre de <emphasis remap="bf">Kfind</emphasis> 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.</para>

<sect1 id="barre-d-outils">
<title>Barre d'outils</title>

<para><variablelist>
<varlistentry>
<term>Lancer la recherche</term>
<listitem>
<para>Démarre une nouvelle recherche en utilisant les critères spécifiés en paramètres.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Nouvelle recherche</term>
<listitem>
<para>Efface les résultats et redémarre une nouvelle recherche.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Arrêter la recherche</term>
<listitem>
<para>Stoppe l'exécution du processus de recherche.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ouvrir</term>
<listitem>
<para>Demande à <emphasis remap="bf">Kfm</emphasis> de démarrer l'application liée par défaut au fichier sélectionné.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ajouter à l'archive...</term>
<listitem>
<para>Ajoute le fichier sélectionné à l'archive choisie.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Supprimer</term>
<listitem>
<para>Efface les fichiers sélectionnés et demande à <emphasis remap="bf">Kfm</emphasis> d'actualiser l'affichage du répertoire.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Propriétés</term>
<listitem>
<para>Affiche les attributs du fichier sélectionné.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ouvrir le dossier conteneur</term>
<listitem>
<para>Demande à <emphasis remap="bf">Kfm</emphasis> d'ouvrir le dossier contenant le fichier sélectionné.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Enregistrer les résultats</term>
<listitem>
<para>Sauve les résultats de la recherche dans le fichier spécifié dans le dialogue <emphasis remap="bf">Options-&gt;Preferences</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Aide</term>
<listitem>
<para>Affiche la documentation de <emphasis remap="bf">KFind</emphasis>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Quitter</term>
<listitem>
<para>Sort de KFind.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="dialogue-des-parametres-de-la-recherche">
<title>Dialogue des paramètres de la recherche</title>

<para>Ce dialogue est le principal composant de <literal remap="tt">KFind</literal>. Il sert à spécifierles paramètres de recherche. Il y a trois groupes de paramètres de recherche:</para>

<para><variablelist>
<varlistentry>
<term>Nom et emplacement</term>
<listitem>
<para>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:
<itemizedlist>
<listitem><para>? remplace tout caractère isolé</para></listitem>
<listitem><para>* remplace toute séquence de caractères</para></listitem>
<listitem><para>&lsqb; ] remplace un ensemble défini de caractères, par exemple &lsqb;a-zA-Z0-9]
remplace les majuscules, les minuscules et les chiffres.</para></listitem>
<listitem><para>\  remplace un alphanumérique ou un point</para></listitem>
</itemizedlist>

La liste déroulante garde une trace des noms entrés.  Le bouton <emphasis remap="bf">Parcourir...</emphasis> permet de spécifierle répertoire où la recherche aura lieu. La case à cocher <emphasis remap="bf">Inclure les sous-dossiers</emphasis> indique sila recherche doit avoir lieu dans les sous-répertoires.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Date de modification</term>
<listitem>
<para>Cet onglet permet de chercher les fichiers créés ou modifiés à l'intérieur d'une période donnée.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Avancé</term>
<listitem>
<para>Cet onglet permet des recherches de fichiers de types donnés, par exemple des documents
Postscript, des images JPEG ou des sons WAV.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="zone-d-affichage">
<title>Zone d'affichage</title>

<para>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.</para>
</sect1>
</chapter>

<chapter id="Leslmentsdemenu">
<title>Les éléments de menu</title>

<sect1 id="fichier">
<title>Fichier</title>

<para>Les fonctions suivantes sont disponibles depuis le menu Fichier:
<variablelist>
<varlistentry>
<term>Ouvrir</term>
<listitem>
<para>Cette option demande à <emphasis remap="bf">kfm</emphasis> 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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ajouter à l'archive</term>
<listitem>
<para>Ajoute le fichier sélectionné à une archive. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Supprimer</term>
<listitem>
<para>Supprime le fichier sélectionné.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Propriétés</term>
<listitem>
<para>Permet d'éditer les propriétés du fichier sélectionné.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Ouvrir le dossier conteneur</term>
<listitem>
<para>Ouvre le dossier contenant le fichier sélectionné dans une fenêtre du gestionnaire de fichiers (KFM).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Enregistrer la recherche</term>
<listitem>
<para>Sauve la liste des fichiers sélectionnés.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Quitter</term>
<listitem>
<para>Sort de <literal remap="tt">Kfind</literal>
.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="edition">
<title>Edition</title>

<para>Les éléments de ce menu sont inactivés.</para>
</sect1>

<sect1 id="options">
<title>Options</title>

<para>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.</para>

<para><variablelist>
<varlistentry>
<term>Enregistrement</term>
<listitem>
<para>Indique le nom du fichier où seront rangés les résultats de la recherche.Le nom par défaut est <literal remap="tt">.kfind-results.html</literal> 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. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Archiveurs</term>
<listitem>
<para>Cet onglet permet l'affichage (et dans le futur, probablement l'édition)des définitions associées à l'archivage déclenché par la fonction <emphasis remap="it">Ajouter à l'archive...</emphasis>.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="aide">
<title>Aide</title>

<para>Permet l'affichage d'informations sur KFind ainsi que la documentation de KFind.</para>
</sect1>
</chapter>

<chapter id="Conclusion">
<title>Conclusion</title>

<sect1 id="developpeurs">
<title>Developpeurs</title>

<para><variablelist>
<varlistentry>
<term>Miroslav Fl&iacute;dr</term>
<listitem>
<para><ulink url="mailto:flidr@kky.zcu.cz">E-Mail: flidr@kky.zcu.cz</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mario Weilguni;</term>
<listitem>
<para><ulink url="mailto:mweilguni@kde.org">E-Mail: mweilguni@kde.org</ulink></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="auteurs">
<title>Auteurs</title>

<para><variablelist>
<varlistentry>
<term>Miroslav Fl&iacute;dr</term>
<listitem>
<para><ulink url="mailto:flidr@kky.zcu.cz">E-Mail: flidr@kky.zcu.cz</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Martin Hartig</term>
<listitem>
<para><ulink url="hartig@mathematik.uni-kl.de">E-Mail: hartig@mathematik.uni-kl.de</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mark Roberts</term>
<listitem>
<para><ulink url="mailto:mar2@scigen.co.uk">E-Mail: mar2@scigen.co.uk</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Eric Bischoff</term>
<listitem>
<para>- Editeur
<ulink url="mailto:ebisch@cybercable.tm.fr">E-mail: ebisch@cybercable.tm.fr</ulink></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Eric Bischoff</term>
<listitem>
<para>- Traduction française<ulink url="mailto:ebisch@cybercable.tm.fr">E-mail: ebisch@cybercable.tm.fr</ulink></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
