# &kfilereplace;-håndbogen

Emiliano Gulmini

    emi_barbarossa@yahoo.it

&rune.laursen.role;
2004 Emiliano Gulmini
&FDLNotice;
2004-08-09
1.0.0

&kfilereplace; er et værktøj til at søge efter og erstatte strenge.

KDE KFileReplace erstat søg streng

## Indledning

&kfilereplace; er program til at søge efter og erstatte en liste af strenge i et filtræ. Strengene kan være bogstaver eller &Qt;-lignende regulære udtryk. Der er endda andre indstillinger hvormed du kan finindstille din søgning.

## At bruge &kfilereplace;

&kfilereplace; et øjebliksbillede af &kfilereplace; hvor den fremstår helt selvstændigt

&kfilereplace; et øjebliksbillede af &kfilereplace; hvor den fremstår helt selvstændigt

### Værktøjslinjen

&kfilereplace;s værktøjslinje ser sådan ud: &kfilereplace;s værktøjslinje

&kfilereplace;s værktøjslinje

Værktøjslinjen viser dig hovedfunktionernes funktioner.

Værktøjslinjeikoner

Ny session

  Denne knap viser en sessionsdialog hvori du kan ændre flere basale indstillinger. Hvis &kfilereplace; kører som et selvstændigt program bør du starte her for at starte en søgning.

Søg

  Denne knap starter en søge-løkke.

Erstat

  Denne knap starter en søg-&erstat-løkke. Når en streng er blevet fundet, erstatter &kfilereplace; den med en anden streng.

Simuleret erstatning

  Denne knap starter en simulering af en søg-& erstatnings-løkke. Der sker ikke noget når du klikker på den.

Stop

  Denne knap stopper operationen.

Tilføj strenge

  Denne knap åbner dialogen Tilføj strenge i hvilken du kan redigere dine strenge.

Slet strenge

  Denne knap sletter den valgte (eller den nuværende hvis der ingen er valgt) streng fra listen.

Redigér strenge

  Denne knap redigerer en valgt streng.

Slet liste

  Denne knap sletter alle strenge i listen.

Invertér strenge

  Denne knap skifter en søgestreng ud med en erstatningsstreng. På den måde kan du vende søg-/erstatnings-løkken om.

Indlæs strengliste

  Denne knap indlæser en strengliste gemt i en xml-fil med `kfr`-filendelsen.

Søg i undermapper

  Denne knap lader dig søge/erstatte rekursivt i undermapper i din basismappe.

Opret sikkerhedskopi af filer

  Denne knap aktiverer oprettelsen af sikkerhedskopier af filer.

Versalfølsom søgning

  Denne knap aktiverer versalfølsom søgning.

Kommandoer

  Denne knap aktiverer mulighed for kommandoer. Kommandoer er specielle strenge. Se afsnittet .

Regulære udtryk

  Denne knap aktiverer &Qt;-lignende regulære udtryk.

### Resultatliste

&kfilereplace;s Resultatvisning
&kfilereplace;s Resultatvisning

Resultat-visningen viser navnet på filerne der indeholder den streng du har fundet (og erstattet), filernes sti, deres størrelse, antallet af fundne strenge og filernes bruger-ID. Den eksakte placering af hver træffer vises også. Du kan åbne en fil ved at klikke med &RMB; på den indgang i listen der indeholder linje- og søjlepositionen.

### Strenglisten

Dette er Streng-visningen: &kfilereplace;s Strengvisning

&kfilereplace;s Strengvisning

Streng-visningen visualiserer listen af strenge du vil søge/erstatte. Bemærk at i hver tilstand vil Resultater-visningen og Streng-visningen have et forskelligt udseende.

### Dialogen Ny session

Dialogen Ny session bruges til at indstille de basale parametre der skal bruges for at &kfilereplace; virker. Den består af to dele, Generelt og Avanceret.

#### Generelt-fanebladet

&kfilereplace; Fanebladet Generelt
&kfilereplace; Fanebladet Generelt

Når du vil starte en ny session, er første skridt at klikke på Ny session-knappen. Så skal du indtaste stien og en sekvens af skalagtige jokertegn for at bruge dem som filter.

Så kan du sætte nogle nyttige indstillinger som søgning i alle undermapper, udføre versalfølsom søgning, aktivere kommandoer og/eller regulære udtryk

Bemærk at regulære udtryk og kommandoer kan nedsætte søgehastigheden.

, udføre sikkerhedskopiering af filer før erstatning.

Hvis du vil starte en søgning, kan du indsætte en streng i søgefeltet og trykke på knappen Søg nu, ellers lad feltet være tomt og tryk på knappen Søg senere.

#### Fanebladet Avanceret

&kfilereplace; Fanebladet avanceret
&kfilereplace; Fanebladet Avanceret

Fanebladet Avanceret lader dig sætte nogle nyttige indstillinger til begrænsning af din søgning til et delmængde af dit målfiltræ. Hvis du vil køre &kfilereplace; kun på filer der ligger i størrelsesområdet 10KB-100KB, så kan du benytte størrelsesindstillingerne. Der er også en datoindstilling der lader dig begrænse søgningen efter filer indenfor et bestemt tidsrum. Den sidste indstilling lader dig søge på filer der ejes (eller ikke ejes) af en bestemt bruger (dette er sandsynligvis mest brugbart for systemadministratorer).

### Dialogen Indstillinger

Denne dialog indeholder indstillinger der findes i værktøjslinjen og ekstra indstillinger der kan være nyttige i nogle situationer. Du kan åbne den ved at vælge Opsætning Indstil KFileReplace...i i hovedmenuen.

#### Generelt

Disse indstillinger er allerede blevet præsenteret i afsnittet om Værktøjslinjen. Fanebladet Generelt i vinduet Indstillinger

Fanebladet Generelt i vinduet Indstillinger

#### Avancerede tilvalg

Fanebladet Avanceret i vinduet Indstillinger

Fanebladet Avanceret i vinduet Indstillinger

Vis ikke filer hvis ingen strenge bliver fundet eller erstattet Når der søges, stop ved første streng der findes Følg symbolske link Ignorér skjulte filer og mapper
- vidser kun de filer matcher nogle af dine strenge. Dette får søgningen til at gå hurtigere. &kfilereplace; vil stoppe når den finder en matchende streng, og vil fortsætte med at søge efter andre strenge eller,hvis du kun søger efter en streng, så vil den fortsætte til den næste fil. hvis en fil er et link til en anden, så søges i den rigtige fil. hvis skjulte filer eller mapper mødes, så ignoreres de.

### Dialogen Tilføj strenge

&kfilereplace;s Tilføj strenge-dialog
&kfilereplace;s Tilføj strenge-dialog

Denne dialog bruges til at indsætte og redigere en liste med strenge. Det er nemt at bruge den. Du skal bare vælge om du vil indsætte en søg-kun-liste eller en søg-og-erstat-liste og så i de to mini-editorer introducere din tekst. Knapperne med pile lader dig tilføje eller slette et par stenge, hvis du mener du har lavet en fejl. Når du er færdig skal du klikke på knappen OK.

## &kfilereplace; funktioner

Dette kapitel giver information om nogle nyttige muligheder i &kfilereplace;.

### Sådan gemmer du en strengliste

Når du vil genbruge en liste af strenge, kan du gemme den i en `xml`-fil. Dor at gøre dette skal du i menulinjen vælge Søg/Erstat Strenge Gem strengliste til fil. Når du gemmer en liste oprettes der en simpel `xml`-fil med filendelsen `kfr`. For at indlæse en `kfr`-fil, vælger du i menulinjen Søg/Erstat Strenge Indlæs strengliste fra fil. Filen ser således ud:

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

hvis du bruger et ældre format kan du manuelt opdatere dine filer ved tilpasse dem til ovennævnte system. Alternativt kan du indlæse filen der er gemt i det gamle format og gemme den igen med &kfilereplace;, på samme måde som forklaret før.

### Sådan oprettes en simpel rapport

Du kan oprette en rapport ved at vælge Søg/Erstat Resultater Opret rapportfil fra hovedmenuen. En rapport består af en mappe med en `xml`-fil og en `css`-fil. Rapporter er nyttige til at vedligeholde et simpelt log-system over dine operationer. &kfilereplace;s Rapportfacilitet

&kfilereplace;s Rapportfacilitet

### Sådan bruger du regulære udtryk

Hvis du vil søge efter hver eneste streng der starter med x, ht eller u og som slutter med ml, kan du skrive et regulært udtryk sådan her `(x|ht|u)ml`. Indsæt dette udtryk i søgeeditoren, klik på knappen OK og aktiver til sidst regulære udtryk ved at trykke på Regulært udtryk-knappen. Bemærk at brug af regulære udtryk lader dig foretage meget komplicerede søgninger, til gengæld kan man opleve et stort hastighedstab. Regulære udtryk kan være svare og det er ofte sådan at hvis du vil løse et problem med et regulært udtryk, står du med to problemer.

### Sådan beskyttes originalfiler

Hvis du ikke vil miste dine originale filer kan du oprette en kopi af dem før du erstatter strengene. Efter du har indsat dine strenge, og før du starter erstatningsprocessen, skal du aktivere knappen Opret sikkerhedskopier. Hvis du vil tilpasse sikkerhedskopiernes fil-endelser skal du åbne dialogen Indstillinger.

### Sådan åbner du en fil

Hvis du vil åbne en fil der matcher nogle af dine strenge, skal du vælge en linje i resultatvisningen og klikke med &RMB;. Derefter dukker en sammenhængsmenu op hvorfra du kan åbne filen. Bruger du &kfilereplace; indlejret i &quantaplus;, kan du åbne filen direkte ved den angivede linje og søjle.

### Kommandoer

Forestil dig du vil erstatte sætningen Alice i Eventyrland med hele filen der indeholder Carrolls roman.. Det ønsker du ikke at gøre manuelt så i stedet har du behov for en kommando der kan gøre det for dig. Du klikker derfor på knappen Tilføj og vælger Søge- og erstatningstilstand og indsætter følgende strenge: `Alice i eventyrland` i søgeeditoren og strengen `[$loadfile:/stientilminmappe/minmappe/minfil$]` i erstatningseditoren. Klik på knappen OK. Tilbage i &kfilereplace;s hovedvindue, trykker du på knappen Aktivér kommandoer i erstatningsstreng, der aktiverer kommandoerne og så starter du erstatningsprocessen. Andre kommander kan du læse om i hvor du også finder en hel liste over kommandoer.

## Medvirkende og licens

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

&kfilereplace;-forfattere og vedligeholdere:

François Dupoux dupoux@dupoux.com

  Oprindelig forfatter

Andras Mantia amantia@kde.org

  Skal-forfatter, KPart-forfatter, co-vedligeholder

Emiliano Gulmini emi_barbarossa@yahoo.it

  Nuværende vedligeholder kodeoprydder & omskrivning

Dokumentationsophavsret © 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

&rune.laursen.credit; &underFDL; &underGPL;

## Installation

### Sådan installerer du &kfilereplace;

&kfilereplace; er i øjeblikket en del af &kdewebdev;-pakken, så for at installere det skal du først hente en kopi af &kdewebdev;. Bemærk at hvis du bruger en &kde;-installation der kommer fra din operativsystem-leverandør, har du sandsynligvis allerede&kdewebdev; installeret. I så fald kan du bruge &kfilereplace; enten ved at åbne &quantaplus; webudviklingsværktøjet, eller ved at køre programmet direkte (med mindre du har en gammel udgave af &kde;). Hvis du ikke har den kan du hente &kdewebdev;-pakken fra &kdewebdev;-hjemmesiden hvor du også kan få mere information.

### Krav

For at bruge kommandoen [$mathexp:some_math_expression$] skal du installere &bc; matematikværktøjet (version 1.06 eller nyere) skrevet af Philip A. Nelson (philnelson@acm.org).

## &kfilereplace; commands

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:/my-path/my-directory/my-file$] [$empty:$] [$random:ET_HELT_TAL$] [$random:$] [$mathexp:bc-expression$]
- denne kommando returnerer dagens dato og tidspunkt i &Qt; ISO-format. ligesom ovenfor men i lokalt format. returnerer UID for nuværende bruger. returnerer GID for nuværende bruger. returner brugernavn for nuværende bruger. returnerer det fulde navn for nuværende bruger. returnerer hjemmemappen for nuværende bruger. returnerer skallen for nuværende bruger. returnerer indholdet af my-file-filen. returnerer den tomme streng. returnerer en tilfældig talstreng ved brug af ET_HELT_TAL som oprindelig kilde. ligesom ovenfor men uden en oprindelig kilde. returnerer resultatet af et &bc; v1.06 matematisk udtryk.

&documentation.index;