# Handbok Filersättning

## Inledning

Filersättning är ett program som används för att utföra sökning och ersättning av en lista med strängar i ett filträd. Strängarna kan vara literaler eller Qt-liknande reguljära uttryck. Det finns också andra alternativ för att finjustera sökningar.

## Att använda Filersättning

Filersättning i dess fristående inkarnation. Filersättning i dess fristående inkarnation.

### Verktygsraden

Verktygsraden i Filersättning ska se ut så här: Filersättnings verktygsrad Filersättnings verktygsrad

Verktygsraden visar knappar för huvudfunktionerna.

### Verktygsradens ikoner

Ny session

- Den här knappen visar ett sessionsdialogfönster, där du kan ange flera grundläggande alternativ. Om Filersättning körs som fristående program, ska du klicka på den här knappen som det första steget.

Sök enbart

- Den här knappen startar en sökning.

Ersätt

- Den här knappen startar en sök- och ersättning. När en sträng har hittats, ersätter Filersättning den med en annan sträng.

Simulera ersätt

- Den här knappen startar en simulerad sök- och ersättning. Det händer egentligen ingenting när du klickar på den här knappen.

Stoppa

- Den här knappen stoppar en åtgärd.

Lägg till strängar

- Den här knappen öppnar dialogrutan Lägg till strängar där du kan redigera din lista med strängar.

Ta bort strängar

- Den här knappen tar bort den markerade strängen från listan (eller den aktuella om ingen är markerad).

Redigera strängar

- Den här knappen redigerar en markerad sträng.

Ta bort lista

- Den här knappen tar bort alla strängar från listan.

Invertera strängar

- Den här knappen byter en söksträng mot en ersättningssträng, så att du kan ångra sök- och ersättningar.

Ladda stränglista

- Den här knappen laddar en stränglista som är sparad i en XML-fil med filändelsen `kfr`.

Sök i underkataloger

- Den här knappen låter dig söka och ersätta rekursivt i baskatalogens underkataloger.

Skapa säkerhetskopior

- Den här knappen aktiverar att skapa filer för säkerhetskopiering.

Skiftlägeskänslig sökning

- Den här knappen aktiverar skiftlägeskänslig sökning.

Kommandon

- Den här knappen aktiverar kommandomöjligheten. Kommandon är specialsträngar. Se kfilereplace-commands.

Reguljära uttryck

- Den här knappen aktiverar QT-liknande reguljära uttryck.

### Resultatlistan

Filersättnings resultatvy Filersättnings resultatvy

Resultatvyn visar namnet på filerna som innehåller strängarna du måste hämta (och ersätta), deras sökväg, deras storlek, antalet strängar som hittats och filernas användaridentifikation. Vyn tillhandahåller också exakt position för matchande strängar. Du kan dessutom öppna en fil genom att klicka på posten i listvyn som innehåller rad och kolumnposition med höger musknapp.

### Stränglistan

Det här är strängvyn: Strängvyn i Filersättning Strängvyn i Filersättning

Strängvyn synliggör listan med strängar som du vill söka och ersätta. Observera att i sökläge har resultatvyn och strängvyn en annan layout.

### Dialogrutan Ny session

Dialogrutan Ny session används för att ställa in de grundläggande parametrarna som behövs av Filersättning för att fungera. Den består av två sidor, Allmänt och Avancerat.

#### Fliken Allmänt

Fliken Allmänt i Filersättning Fliken Allmänt i Filersättning

När du vill börja en ny session är det första steget att klicka på knappen Ny session. Därefter måste du skriva in bassökvägen och en följd av skalliknande jokertecken att använda som filter.

Därefter skulle du kunna ställa in några användbara alternativ, som sökning i alla underkataloger, göra en skiftlägeskänslig sökning, aktivera kommandon och/eller reguljära uttryck

Observera att reguljära uttryck och kommandon kan sänka prestanda.

, göra en säkerhetskopia av varje fil innan ersättning.

Om du vill börja söka kan du skriva in en sträng i sökrutan och trycka på Sök nu. Lämna annars sökrutan tom och tryck på Sök senare.

#### Fliken Avancerat

Fliken Avancerat i Filersättning Fliken Avancerat i Filersättning

Fliken Avancerat låter dig ställa in några användbara alternativ för att begränsa sökningen till en delmängd av filträdet. Om du bara vill köra Filersättning för filer som har en storlek i intervallet 10 Kibyte till 100 Kibyte, skulle du kunna använda storleksalternativet. Det finns också ett datumalternativ som begränsar sökningen i tidshänseende, och ett sista alternativ som låter dig bara söka efter filer som ägs (eller inte ägs) av en viss användare (det kan vara mer användbart för systemadministratörer).

### Dialogrutan Alternativ

Dialogrutan innehåller alternativ som finns i verktygsraden och extra alternativ som kan vara praktiska i vissa fall. Du kan visa den genom att välja Inställningar Anpassa Filersättning i menyraden.

#### Allmänna alternativ

Dessa alternativ har beskrivits i avsnittet Verktygsraden. Fliken Allmänt i alternativfönstret Fliken Allmänt i alternativfönstret

#### Avancerade alternativ

Fliken Avancerat i alternativfönstret Fliken Avancerat i alternativfönstret

Visa inte filen om inga strängar hittas eller ersätts Vid sökning, stoppa när första sträng hittas Följ symboliska länkar Ignorera dolda filer och kataloger
- Visar bara filerna som matchar några av dina strängar. Det snabbar upp sökningen. &kfilereplace; stoppar när en matchande sträng hittas, och fortsätter att leta efter övriga strängar eller om du bara söker efter en sträng, fortsätter med nästa fil. Om en fil är en länk till en annan, sök då i den riktiga filen. Om dolda filer eller kataloger stöts på, ignorera dem.

### Dialogrutan Lägg till strängar

Dialogrutan Lägg till strängar i Filersättning Dialogrutan Lägg till strängar i Filersättning

Dialogrutan används för att infoga och redigera en lista med strängar. Du måste bara välja mellan att infoga en lista med bara söksträngar eller en sök- och ersättningslista, och därefter kan du lägga till texter med de två radeditorerna. Pilknapparna låter dig lägga till par av strängar eller ta bort dem. När du är klar, klicka på knappen Ok.

## Funktioner i Filersättning

Det här kapitlet tillhandahåller information om några användbara funktioner i Filersättning.

### Hur din stränglista kan sparas

Om du vill återanvända en lista med strängar kan du spara dem i en `xml`-fil. För att göra det välj alternativet Sök eller ersätt Strängar Spara stränglista till fil i menyraden. När du sparar en lista, skapas en enkel `xml`-fil med filändelsen `kfr`. För att ladda en `kfr`-fil, välj alternativet Sök eller ersätt Strängar Ladda stränglista från fil i menyraden. Själva filens ser ut så här:

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

Om du använder ett tidigare format kan du uppdatera din fil för hand genom att helt enkelt ändra den enligt metoden ovan. Som ett alternativ kan du ladda filen som är skriven med det gamla formatet och spara den igen med Filersättning på sättet som förklarats tidigare.

### Hur en enkel rapport kan skapas

Du kan skapa en rapport genom att välja Sök eller ersätt Resultat Skapa rapportfil i menyraden. En rapport är en katalog som innehåller en `xml`-fil och en `css`-fil. Rapporter kan vara användbara för att underhålla ett enkelt loggsystem för dina åtgärder. Rapportfunktionen i Filersättning Rapportfunktionen i Filersättning

### Hur reguljära uttryck används

Om du vill söka efter alla strängar som börjar med x, ht eller u och slutar med ml kan du skriva ett reguljärt uttryck som det här: `(x|ht|u)ml`. Infoga uttrycket i sökeditorn, klicka på knappen Ok, och aktivera slutligen reguljära uttryck genom att trycka på knappen Reguljärt uttryck. Observera att användning av reguljära uttryck gör att du kan utföra mycket komplicerade sökningar, men kostnaden kan vara lägre prestanda. Reguljära uttryck kan vara mycket besvärliga, och det händer ofta att om du vill lösa ett problem med ett reguljärt uttryck, har du två problem.

### Hur originalfiler kan skyddas

Om du inte vill att originalfilerna ska gå förlorade, kan du göra en kopia av dem innan strängar ersätts. Du måste bara infoga strängarna, och innan ersättningen startas måste du trycka på knappen Säkerhetskopia. Om du vill anpassa filändelsen för säkerhetskopiorna öppna inställningsdialogrutan.

### Hur en fil kan öppnas

Om du vill öppna en fil som matchar några av strängarna, måste du markera en rad i resultatvyn och klicka med musens högerknapp. En meny visas, och därefter behöver du bara välja ett alternativ i den. Observera att om du använder Filersättning inbäddad i &quantaplus; kan du direkt öppna filen på angiven rad och kolumn.

### Kommandon

Antag att du vill ersätta meningen Alice äventyr i underlandet med hela filen som innehåller Carrolls roman. Du vill troligen inte göra det för hand, utan vad du behöver är ett kommando som gör det åt dig. Klicka alltså på knappen Lägg till, välj Sök- och ersättningsläge och infoga följande strängar: `Alice äventyr i underlandet` i sökeditorn och strängen `[$loadfile:`/sökväg-till-min-katalog/min-katalog/min-fil`$]` i ersättningseditorn. Klicka på knappen Ok, och när du är tillbaka i Filersättnings huvudfönster, ändra knappen Kommandoåtgärd som aktiverar kommandon, och starta ersättningen. Det finns också andra kommandon, se available-commands för en lista med alla.

## Tack till och licens

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

## Upphovsmän och utvecklare av &kfilereplace;:

François Dupoux dupoux@dupoux.com

- Ursprunglig upphovsman

Andras Mantia amantia@kde.org

- Skalupphovsman, skapare av Kpart, bidragande utvecklare

Emiliano Gulmini emi_barbarossa@yahoo.it

- Nuvarande utvecklare, kodstädning och omskrivning

Dokumentation copyright 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

Översättning Stefan Asserhäll stefan.asserhall@comhem.se

&underFDL; &underGPL;

## Installation

### Hur man installerar Filersättning

Filersättning är i själva verket en del av paketet &kdewebdev;, så för att installera det måste du skaffa en kopia av &kdewebdev;. Observera att om du använder en &kde;-installation som tillhandahålls av din operativsystemleverantör, har du troligen redan installerat &kdewebdev;. Om så är fallet, kan du antingen använda Filersättning genom att öppna webbeditorn &quantaplus; eller genom att starta det direkt (om du inte har en gammal version av &kde;). Om inte kan du ladda ner paketet &kdewebdev; från Internet. Titta på Hemsidan för &kdewebdev; för mer information.

### Krav

För att använda kommandot [$mathexp:`ett_matematiskt_uttryck`$] måste det matematiska verktyget &bc; (version 1.06 eller senare) installeras, skrivet av Philip A. Nelson (philnelson@acm.org).

## Kommandon i Filersättning

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:`/min-sökväg/min-katalog/min-fil`$] [$empty:$] [$random:`ETT_HELTAL`$] [$random:$] [$mathexp:`bc-uttryck`$]
- Kommandot returnerar aktuellt datum och aktuell tid med &qt; ISO-format. Som ovan men med lokalt format. Returnera användaridentifikation för aktuell användare. Returnera gruppidentifikation för aktuell användare. Returnera inloggningsnamn för aktuell användare. Returnera fullständigt namn för aktuell användare. Returnera hemkatalog för aktuell användare. Returnera skal för aktuell användare. Returnera innehållet i filen min-fil. Returnera en tom sträng. Returnera en slumptalssträng med ETT_HELTAL som ursprungligt frö. Som ovan, men utan ursprungligt frö. Returnera resultatet av ett &bc; version 1.06 matematiskt uttryck.

&documentation.index;