# Manuel de &kfilereplace;

## Introduction

&kfilereplace; est une application utilisée pour chercher et remplacer une liste de chaînes dans une arborescence de fichiers. Les chaînes peuvent être littérales, ou des expressions rationnelles de type &Qt;. Il y a également d'autres options pour affiner votre recherche.

## Utilisation de &kfilereplace;

&kfilereplace; en mode indépendant &kfilereplace; en mode indépendant

### La barre d'outils

La barre d'outils de &kfilereplace; devrait ressembler à ceci : Barre d'outils de &kfilereplace; Barre d'outils de &kfilereplace;

La barre d'outils vous montre les boutons des fonctionnalités principales.

### Icônes de barre d'outils

Personnaliser la session de recherche / remplacement

- Ce bouton montre une boîte de dialogue de session dans laquelle vous pouvez régler plusieurs options simples. Si &kfilereplace; fonctionne comme application autonome, vous devriez commencer par cliquer sur ce bouton.

Recherche

- Ce bouton démarre une boucle de recherche.

Simuler

- Ce bouton démarre une boucle de recherche simulée. Rien ne se passe réellement lorsque vous cliquez sur ce bouton.

Remplacer

- Ce bouton démarre une boucle de recherche et de remplacement. Lorsqu'une chaîne est trouvée, &kfilereplace; la remplace par une autre chaîne.

Arrêter

- Ce bouton arrête une opération.

Ajouter une chaîne

- Ce bouton ouvre la boîte de dialogue Insérer des chaînes de recherche / remplacement dans laquelle vous pouvez modifier votre liste de chaînes.

Effacer la chaîne

- Ce bouton efface de la liste la chaîne sélectionnée (ou l'actuelle s'il n'y a pas de sélection).

Modifier la chaîne sélectionnée

- Ce bouton modifie la chaîne sélectionnée.

Vider la liste des chaînes

- Ce bouton supprime toutes les chaînes de la liste.

Inverser la chaîne actuelle

- Ce bouton permute la chaîne cherchée avec la chaîne de remplacement, afin que vous puissiez annuler une opération de recherche et remplacement.

Charger la liste des chaînes à partir d'un fichier

- Ce bouton charge une liste de chaînes enregistrée dans un fichier xml avec une extension `kfr`.

Inclure les sous-dossiers

- Ce bouton vous permet de chercher / remplacer dans les sous-dossier de votre dossier de base.

Créer des fichiers de sauvegarde

- Ce bouton permet la génération de fichiers de sauvegarde.

Tenir compte de la casse

- Ce bouton active la recherche sensible à la casse.

Activer les commandes dans la chaîne de remplacement

- Ce bouton active les commandes. Les commandes sont des chaînes spéciales. voyez kfilereplace-commands.

Activer les expressions rationnelles

- Ce bouton active les expressions rationnelles dans le style &Qt;.

### La liste des résultats

Affichage des résultats de &kfilereplace; Affichage des résultats de &kfilereplace;

La vue des résultats affiche le nom des fichiers qui contiennent les chaînes que vous deviez trouver (et remplacer), leur emplacement, leur taille, le nombre de chaînes trouvées et l'identificateur de l'utilisateur des fichiers. La vue fournit également la position exacte de chaque correspondance. Vous pouvez également ouvrir un fichier en cliquant dessus avec le bouton droit de la souris sur un élément de la liste qui contient une position de ligne et de colonne.

### La liste des chaînes

Ceci est la vus des chaînes : Vue des chaînes de &kfilereplace; Vue des chaînes de &kfilereplace;

La vue des chaînes affiche la liste des chaînes que vous souhaitez chercher / remplacer. Notez qu'en mode recherche, la vue des résultats et la vue des chaînes ont des dispositions différentes.

### La boîte de dialogue « Trouver & Remplacer dans des fichiers »

La boîte de dialogue « Trouver & Remplacer dans des fichiers » est utilisée pour configurer les paramètres de base nécessaire au fonctionnement de &kfilereplace;. Elle est constituée de deux onglets, Général et Avancé.

#### L'onglet Général

L'onglet Général de &kfilereplace; L'onglet Général de &kfilereplace;

Lorsque vous souhaitez commencer une nouvelle session, la première étape consiste à cliquer sur le bouton Personnaliser la session de recherche / remplacement. Vous devez alors saisir l'emplacement de base et une séquence de caractères de remplacement (wildcards) de type shell.

Vous pouvez alors régler quelques options utiles, comme chercher dans les sous-dossiers, faire une recherche sensible à la casse, activer les commandes et / ou les expressions rationnelles

Notez que les expressions rationnelles et les commandes peuvent diminuer les performances

, faire des copies de sauvegarde de chaque fichier avant de remplacer.

Si vous souhaitez commencer à chercher, vous pouvez mettre une chaîne dans la boîte de recherche et appuyer sur Rechercher maintenant, sinon, laissez la boîte vide et appuyez sur Rechercher plus tard.

#### L'onglet Avancé

L'onglet Avancé de &kfilereplace; L'onglet Avancé de &kfilereplace;

L'onglet Avancé vous permet de configurer certaines options utiles pour restreindre la recherche à un sous-ensemble de votre arborescence de fichiers cible. Si vous ne souhaitez lancer &kfilereplace; que sur des fichiers dont la taille est comprise entre 10 kio et 100 kio, alors vous pouvez utiliser les options de taille. Il y a également une option sur la date qui restreint la recherche dans un domaine temporel. Une dernière option vous permet de chercher lis fichiers appartenant (ou n'appartenant pas) à un utilisateur particulier (ceci est peut-être plus utile pour les administrateurs système).

### La boîte de dialogue des options

Cette boîte de dialogue contient les options qui se trouvent dans la barre d'outils et des options supplémentaires qui sont utiles dans certaines situations. Vous pouvez les appeler en choisissant Configuration Configurer KFileReplace... dans le menu principal.

#### Options générales

Ces options ont été présentées dans la section Barre d'outils. L'onglet Général de la fenêtre des options L'onglet Général de la fenêtre des options

#### Options avancées

L'onglet Avancé de la fenêtre des options L'onglet Avancé de la fenêtre des options

Ne pas afficher un fichier si aucune chaîne y est remplacée ou trouvée Lors de la recherche, s'arrêter lorsque la première chaîne est trouvée Suivre les liens symboliques Ignorer les fichiers et dossiers cachés
- n'affiche que les fichiers qui correspondent à certaines de vos chaînes. Ceci va accélérer la recherche &kfilereplace; s'arrêtera lorsqu'une chaîne est trouvée, et continuera à chercher d'autres chaînes, ou, si vous ne cherchez qu'une chaîne, il continuera avec le fichier suivant. Si un fichier est un lien vers un autre fichier, alors la recherche s'effectue sur le fichier réel. Si des fichiers ou des dossiers cachés sont rencontrés, ils seront ignorés.

### La boîte de dialogue « Insérer des chaînes de recherche / remplacement »

La boîte de dialogue « Insérer des chaînes de recherche / remplacement » de &kfilereplace; La boîte de dialogue « Insérer des chaînes de recherche / remplacement » de &kfilereplace;

Cette boîte de dialogue est utilisée pour insérer et modifier une liste de chaînes. Vous avez juste à insérer soit une liste de recherche uniquement, soit une liste de recherche / remplacement, puis, avec les deux mini-éditeurs, saisir votre texte. Les boutons fléchés vous permettent d'ajouter ou de supprimer des paires de chaînes. Lorsque vous avez terminé, cliquez sur Ok.

## Caractéristiques de &kfilereplace;

Ce chapitre décrit quelques caractéristiques utiles de &kfilereplace;.

### Comment enregistrer votre liste de chaînes

Lorsque vous souhaitez réutiliser une liste de chaînes, vous pouvez l'enregistrer dans un fichier `xml`. Pour ceci, choisissez Chercher / Remplacer Chaîne Enregistrer la liste des chaînes dans un fichier dans la barre de menus. Lorsque vous enregistrez une liste, un simple fichier `xml` avec l'extension `kfr` est créé. Pour charger un fichier `kfr`, choisissez Chercher / Remplacer Chaîne Charger la liste des chaînes à partir d'un fichier dans la barre de menus. Le fichier réel ressemble à ceci :

    <?xml version="1.0" ?>
    <kfr>
            <mode search="false"/>
            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_1]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_1]]
    ></newstring>
            </replacement>
            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_2]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_2]]
    ></newstring>
            </replacement>

            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_N]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_N]]
    ></newstring>
            </replacement>

    </kfr
    >

Si vous utilisez un format précédent, vous pouvez mettre à jour manuellement votre fichier simplement en le modifiant en suivant le schéma ci-dessus. Vous pouvez également le charger le fichier écrit dans l'ancien format et l'enregistrer de nouveau avec &kfilereplace; de la façon expliquée précédemment.

### Comment créer un rapport simple

Vous pouvez créer un rapport en choisissant Chercher / Remplacer Résultats Créer un fichier de rapport depuis le menu principal. Un rapport est un dossier contenant un fichier `xml` et un fichier `css`. Les rapports peuvent être utiles pour maintenir un journal simple de vos opérations. Les rapports de &kfilereplace; Les rapports de &kfilereplace;

### Utilisation des expressions rationnelles

Si vous souhaitez chercher toutes les chaînes qui commencent par x, ht ou u, et qui se terminent par ml, vous pouvez utiliser une expression rationnelle comme ceci : `(x|ht|u)ml`. Insérez cette expression dans l'éditeur, cliquez sur Ok, et activez les expressions rationnelles en appuyant sur le bouton Expressions rationnelles. Veuillez noter que l'utilisation des expressions rationnelles vous permettent de faire des recherches très compliquées, mais au prix d'une dégradation des performances. Les expressions rationnelles peuvent être très difficiles, et il est souvent vrai que si vous souhaitez résoudre un problème, avec une expression rationnelle, alors vous avez deux problèmes.

### Protéger les fichiers d'origine

Si vous ne souhaitez pas perdre vos fichiers originaux, vous pouvez en faire une copie avant de remplacer les chaînes. Après avoir inséré les chaînes, et avant de commencer le processus de remplacement, vous devez basculer le bouton Créer des fichiers de sauvegarde. Si vous voulez personnaliser l'extension des fichiers de sauvegarde, ouvrez la boîte de dialogue des options

### Comment ouvrir un fichier ?

si vous voulez ouvrir un fichier qui correspond à une ou plusieurs de vos chaînes, vous devez choisir une ligne dans la vue des résultats et cliquer dessus avec le bouton droit de la souris. Un menu contextuel apparaîtra, dans lequel vous pouvez ouvrir le fichier.

### Commandes

Supposons que vous souhaitiez remplacer la phrase Alice au pays des merveilles par le fichier entier qui contient la nouvelle de Carroll. Vous ne souhaitez probablement pas le faire à la main. Ce dont vous avez besoin est une commande qui le fasse à votre place. Cliquez sur le bouton Ajouter, choisissez Mode recherche et remplacement et insérez la chaîne suivante : `Alice au pays des merveilles` dans la zone de recherche et la chaîne `[$loadfile:`/emplacement/de/mon/dossier/mon-fichier`$]` dans la zone de remplacement. Cliquez sur Ok. Lorsque vous revenez dans la fenêtre principale de &kfilereplace;, activez le bouton Activer les variables dans les chaînes de remplacements, qui active les commandes, et démarrez le processus de remplacement. Il y a également d'autres commandes. Voyez available-commands

## Remerciements et licence

&kfilereplace;. Programme sous copyright 1999 par François Dupoux dupoux@dupoux.com, 2003 Andras Mantia amantia@kde.org, 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

## Les auteurs et mainteneurs de &kfilereplace;

François Dupoux dupoux@dupoux.com

- Auteur Original

Andras Mantia amantia@kde.org

- Auteur de la ligne de commande, créateur du module KPart, Co-mainteneur

Emiliano Gulmini emi_barbarossa@yahoo.it

- Mainteneur actuel, nettoyeur et rédacteur de code

Documentation sous copyright 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

Traduction française par &LudovicGrossard;.

&underFDL; &underGPL;

## Compilation et installation

&install.intro.documentation; &install.compile.documentation;

### Prérequis

Afin d'utiliser la commande [$mathexp:`expression_mathématique`$], vous devez installer l'outil mathématique &bc; (version 1.06 ou plus récente) écrit par Philip A. Nelson (philnelson@acm.org).

## Les commandes de &kfilereplace;

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:`/mom-emplacement/mon-dossier/mon-fichier`$] [$empty:$] [$random:`UN_NOMBRE_ENTIER`$] [$random:$] [$mathexp:`bc-expression`$]
- Cette commande renvoie la date et l'heure actuelles au format ISO &Qt;. comme ci-dessus, mais au format local. renvoie l'UID de l'utilisateur actuel. renvoie le GID de l'utilisateur actuel. renvoie l'identifiant de l'utilisateur actuel. renvoie le nom complet de l'utilisateur actuel. renvoie le dossier personnel de l'utilisateur actuel. renvoie le shell de l'utilisateur actuel. renvoie le contenu lu fichier mon-fichier. renvoie une chaîne vide. renvoie une chaîne contenant des nombres aléatoires un utilisant UN_NOMBRE_ENTIER comme graine initiale. comme ci-dessus, mais sans graine initiale. renvoie le résultat d'une expression mathématique &bc; v1.06

&documentation.index;