# Het handboek van &kfilereplace;

Emiliano
Gulmini

    emi_barbarossa@yahoo.it

&Sander.Koning;&Tom.Albers;Antoon Tolboom

    atolboo@casema.nl

2004
Emiliano Gulmini
&FDLNotice;
2004-08-09
1.0.0

&kfilereplace; is een hulpmiddel om tekenreeksen te zoeken en te vervangen.

KDE
KFileReplace
vervangen
zoeken
tekenreeks

## Inleiding

&kfilereplace; is an application used to search and replace a list of strings in a file tree. The strings may be literal or &qt;-like regular expressions. There are also other options to tune your search.

## &kfilereplace; gebruiken

&kfilereplace; als alleenstaande toepassing &kfilereplace; als alleenstaande toepassing

### De werkbalk

De werkbalk van &kfilereplace; zou er als volgt uit moeten zien: De werkbalk van &kfilereplace; De werkbalk van &kfilereplace;

Op de werkbalk ziet u de knoppen van de belangrijkste functies.

#### Werkbalkpictogrammen

New session

  Deze knop toont een sessie-dialoogvenster, waarin u diverse basisopties kunt instellen; als &kfilereplace; als alleenstaande toepassing draait dient u dit als eerste te doen.

Search only

  Deze knop start een zoeklus.

Vervangen

  Deze knop start een zoek&vervang-lus. Als een tekenreeks gevonden is, vervangt &kfilereplace; deze door een andere tekenreeks.

Simulated Replace

  Deze knop start een gesimuleerde zoek&vervang-lus. Er wordt niets daadwerkelijk vervangen.

Stoppen

  Deze knop stopt een actie.

Add Strings

  Met deze knop opent u het dialoogvenster Tekenreeksen toevoegen waarin u uw tekenreeksen kunt bewerken.

Delete Strings

  Met deze knop verwijdert u de geselecteerde tekenreeks (of de huidige, als er geen selectie is) uit de lijst.

Edit Strings

  Met deze knop bewerkt u een geselecteerde tekenreeks.

Delete List

  Deze knop verwijdert alle tekenreeksen uit de lijst.

Invert Strings

  Deze knop verwisselt een zoek- en een vervang-tekenreeks met elkaar, zodat u de zoek/vervang-operatie kunt terugdraaien.

Load String List

  Deze knop laadt een lijst van tekenreeksen opgeslagen in een xml-bestand met een extensie `kfr`.

Search in Subfolders

  Met deze knop kunt u recursief in de submappen van uw basismap zoeken en vervangen.

Make Backup Files

  Deze knop schakelt het maken van reservekopie-bestanden in.

Case-sensitive Search

  Deze knop schakelt hoofdlettergevoelig zoeken in.

Commands

  Deze opdracht schakelt de mogelijkheid tot het gebruiken van opdrachten in. Opdrachten zijn speciale tekenreeksen. Zie .

Regular expressions

  This button enables &qt;-like regular expressions.

### De resultatenlijst

De resultatenweergave van &kfilereplace;
De resultatenweergave van &kfilereplace;

The Results view shows the name of the files that contain the strings you have to retrieve (and replace), their path, their size, the number of strings found and the user id of the files. This view also provides the exact position of each match. You can also open a file by clicking with the &RMB; on an list entry that contains line and column position.

### De tekenreeksen-lijst

This is the Strings view: De tekenreeksweergave van &kfilereplace; De tekenreeksweergave van &kfilereplace;

The Strings view visualizes the list of strings you want search/replace. Please note that in search mode the Results view and the Strings view have a different layout.

### The New Session Dialog

The New Session dialog is used to setup the basic parameters needed by &kfilereplace; to work. It consists of two tabs, General and Advanced.

#### The General Tab

Het tabblad "Algemeen" van &kfilereplace;
Het tabblad "Algemeen" van &kfilereplace;

When you want to begin a new session the first step is to click on the New Session button. Then you must enter the base path and a sequence of shell-like wildcards to use as filter.

Dan kunt u wat nuttige opties instellen, zoals zoeken in alle submappen, een hoofdlettergevoelige zoekactie uitvoeren, opdrachten inschakelen en/of reguliere expressies Let op dat reguliere expressies en opdrachten de snelheidsprestatie verslechteren., een reservekopie maken van elk bestand vóór vervangen.

Als u wilt beginnen met zoeken, kunt u een tekenreeks in het zoekveld invoeren en de knop Nu zoeken kiezen, anders laat u het zoekveld leeg en kiest u Later zoeken.

#### The Advanced Tab

Het tabblad "Geavanceerd" van &kfilereplace;
Het tabblad "Geavanceerd" van &kfilereplace;

Op het tabblad Geavanceerd kunt u een aantal nuttige opties instellen om het zoeken te beperken tot een kleiner deel van uw bestandsboom. Als u &kfilereplace; alleen op bestanden wilt laten werken die een grootte hebben van 10 KB - 100 KB, kunt u de grootte-opties gebruiken. Er is ook een datumoptie die de zoekactie beperkt tot een bepaalde periode, en een laatste optie waarmee u alleen in bestanden kunt zoeken die (niet) van een bepaalde gebruiker zijn (dit kan nuttiger zijn voor systeembeheerders).

### The Options Dialog

Dit dialoogvenster bevat opties uit de werkbalk en extra opties die in sommige situaties handig kunnen zijn. U kunt het oproepen door Instellingen KFileReplace instellen... uit het hoofdmenu te kiezen.

#### Algemene opties

Deze opties zijn beschreven in de sectie Werkbalk. Het tabblad "Algemeen" van het venster "Opties" Het tabblad "Algemeen" van het venster "Opties"

#### Geavanceerde opties

Het tabblad "Geavanceerd" van het venster "Opties" Het tabblad "Geavanceerd" van het venster "Opties" Bestanden niet tonen als er geen tekenreeksen zijn gevonden of vervangen Stop bij het zoeken bij de eerste vindplaats Symbolische koppelingen volgen Verborgen bestanden en mappen negeren toont alleen de bestanden die met sommige tekenreeksen overeenkomen. Dit versnelt het zoeken. &kfilereplace; stopt als het een overeenkomende tekenreeks vindt, en gaat door met zoeken voor andere tekenreeksen of gaat door met het volgende bestand als u naar slechts één tekenreeks zoekt. als een bestand een koppeling is naar een ander, zoek dan in het echte bestand. als verborgen bestanden of mappen gevonden worden, negeer deze.

### The Add Strings Dialog

&kfilereplace;'s Add Strings dialog
&kfilereplace;'s Add Strings dialog

Dit dialoogvenster wordt gebruikt om een lijst met tekenreeksen in te voegen en te bewerken. U hoeft slechts een lijst voor alleen zoeken of voor zoeken en vervangen in te voegen, en kunt dan met de twee mini-editors uw tekst invoeren. Met de pijlknoppen kunt u paren tekenreeksen toevoegen of verwijderen. Als u klaar bent, klikt u OK.

## Mogelijkheden van &kfilereplace;

Dit hoofdstuk biedt informatie over een aantal nuttige mogelijkheden van &kfilereplace;

### Uw tekenreekslijst opslaan

Als u een lijst met tekenreeksen wilt hergebruiken kunt u deze in een `xml`-bestand opslaan. Hiertoe kiest u uit de menubalk Zoeken/vervangen Tekenreeksen Tekenreeksen in bestand opslaan. Als u een lijst opslaat wordt een eenvoudig `xml`-bestand met de extensie `kfr` aangemaakt. Om een `kfr`-bestand te laden, kiest u uit de menubalk Zoeken/vervangen Tekenreeksen Tekenreeksen uit bestand laden. Het werkelijke bestand ziet er als volgt uit:

    <?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
    >

Als u een vorig formaat gebruikt, kunt u met de hand uw bestand bijwerken door het aan te passen aan het bovenstaande schema. U kunt ook het bestand dat in het oude formaat geschreven is inladen en het opnieuw met &kfilereplace; opslaan zoals hierboven uitgelegd.

### Hoe een eenvoudig rapport aan te maken

U kunt een rapport aanmaken door Zoeken/vervangen Resultaten Rapportbestand maken uit het hoofdmenu te kiezen. Een rapport is een map die een `xml`- en een `css`-bestand bevat. Rapporten kunnen nuttig zijn om een eenvoudig logboek van uw handelingen bij te houden. De rapportagemogelijkheid van &kfilereplace; De rapportagemogelijkheid van &kfilereplace;

### Hoe reguliere expressies te gebruiken

Als u elke tekenreeks wilt zoeken die begint met x, ht of u en eindigt met ml, kunt u een reguliere expressie schrijven als: `(x|ht|u)ml`. Voeg deze expressie in in de zoekeditor, klik OK en schakel reguliere expressies in door de knop Reguliere expressie in te schakelen. Let op dat het gebruik van reguliere expressies u erg gecompliceerde zoekacties biedt, maar dat dit een prestatievermindering kost. Reguliere expressies kunnen erg lastig zijn, en vaak geldt als u een probleem wilt oplossen met een reguliere expressie, heeft u twee problemen.

### Hoe originele bestanden te beschermen

Als u uw originele bestanden niet wilt verliezen, kunt u een kopie van ze maken voordat u de tekenreeksen vervangt. Nadat u uw tekenreeksen hebt ingevoerd, en voordat u het vervangingsproces start, schakelt u hiervoor de knop Reservekopie in. Als u de extensie van de reservekopiebestanden wilt aanpassen opent u het dialoogvenster Opties.

### Hoe een bestand te openen

If you want to open a file that matches some of your strings, you have to select a line in the result view and click on it with the &RMB;. A context menu will appear from which you can open the file. If you use &kfilereplace; embedded in &quantaplus;, you can open the file directly in it at the specified line and column.

### Commands

Stel dat u de tekst Alice in Wonderland wilt vervangen door het gehele bestand waarin de tekst van Carrolls boek staat. Dat wilt u waarschijnlijk niet met de hand doen, wat u wilt is een opdracht die dit voor u doet. Kies dus de knop Toevoegen, kies Zoek- en vervangmodus en voer de volgende tekenreeksen in: als zoekterm `Alice in Wonderland` en als vervangtekenreeks `[$loadfile:/het-pad-naar-mijn-map/mijn-map/mijn-bestand$]`in de vervangings mini-editor. Kies OK, en als u teruggekeerd bent in het hoofdvenster van &kfilereplace; schakelt u de knop Opdrachtactie in die de opdrachten inschakelt, en start u de vervangactie. Er zijn meer opdrachten beschikbaar, zie voor een overzicht.

## Dankbetuiging en licentie

&kfilereplace;. Programma copyright 1999 door François Dupoux dupoux@dupoux.com 2003 Andras Mantia amantia@kde.org 2004 Emiliano Gulminiemi_barbarossa@yahoo.it

### Auteurs en onderhouders van &kfilereplace;:

François Dupoux dupoux@dupoux.com

  Originele auteur

Andras Mantia amantia@kde.org

  Shell-auteur, maker van KPart, mede-onderhouder

Emiliano Gulmini emi_barbarossa@yahoo.it

  Onderhoud, opschonen & herschrijven van de code

Documentatie copyright © 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

&meld.fouten;&vertaling.sander;&nagelezen.tom;

Nagelezen door Antoon Tolboom

&underFDL; &underGPL;

## Installation

### How to install &kfilereplace;

&kfilereplace; is currently part of &kdewebdev; package, so, in order to install it, you have to get a copy of &kdewebdev;. Note that if you are using a &kde; installation provided by your OS vendor, probably you already have &kdewebdev; installed; in this case, you can use &kfilereplace; either by opening &quantaplus; Web editor, or by calling it directly (unless you have an old &kde; version). Else you can download the &kdewebdev; package from the Internet: please refer to &kdewebdev; home site for more information.

### Vereisten

Om de opdracht [$mathexp:wiskundige_uitdrukking$] te kunnen gebruiken heeft u het wiskundige gereedschap &bc; nodig (versie 1.06 of hoger) van Philip A. Nelson (philnelson@acm.org).

## Opdrachten van &kfilereplace;

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:/mijn-pad/mijn-map/mijn-bestand$] [$empty:$] [$random:GEHEEL_GETAL$] [$random:$] [$mathexp:bc-uitdrukking$] this command return the current date and time in &qt; ISO format. zoals boven maar in lokaal formaat. retourneer het UID van de huidige gebruiker. retourneer het GID van de huidige gebruiker. retourneer de aanmeldnaam van de huidige gebruiker. retourneer de volledige naam van de huidige gebruiker. retourneer de persoonlijke map van de huidige gebruiker. retourneer de shell van de huidige gebruiker. retourneer de inhoud van het bestand mijnbestand. retourneer de lege tekenreeks. retourneer een willekeurig getal met GEHEEL_GETAL als het eerste zaadgetal. als boven, maar zonder eerste zaadgetal. retourneer het resultaat van een wiskundige uitdrukking volgens &bc; v1.06

&documentation.index;