Handbok Filersättning
2
1 Inledning 5
2 Att använda Filersättning 6
2.1 Verktygsraden . . . 6
2.2 Resultatlistan . . . 8
2.3 Stränglistan . . . 8
2.4 Dialogrutan Sök och ersätt i filer . . . 8
2.4.1 Fliken Allmänt . . . 9
2.4.2 Fliken Avancerat . . . 10
2.5 Dialogrutan Alternativ . . . 10
2.5.1 Allmänna alternativ . . . 10
2.5.2 Avancerade alternativ . . . 11
2.6 Dialogrutan Infoga söknings- eller ersättningssträngar . . . 12
3 Funktioner i Filersättning 13 3.1 Hur din stränglista kan sparas . . . 13
3.2 Hur en enkel rapport kan skapas . . . 14
3.3 Hur reguljära uttryck används . . . 14
3.4 Hur originalfiler kan skyddas . . . 14
3.5 Hur en fil kan öppnas . . . 15
3.6 Kommandon . . . 15
4 Tack till och licens 16
A Installation och kompilering 17
Sammanfattning
Filersättning är ett verktyg för sökning och ersättning av strängar.
Kapitel 1
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.
Handbok Filersättning
Kapitel 2
Att använda Filersättning
2.1 Verktygsraden
Verktygsraden i Filersättning ska se ut så här:
6
Verktygsraden visar knappar för huvudfunktionerna. VERKTYGSRADENS IKONER
Anpassa sök- eller ersättningssession
Den här knappen visar ettsessionsdialogfönster, där du kan ange flera grundläggande al- ternativ. Om Filersättning körs som fristående program, ska du klicka på den här knappen som det första steget.
Sök
Den här knappen startar en sökning.
Simulera
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.
Ersätt
Den här knappen startar en sök- och ersättning. När en sträng har hittats, ersätter Filersätt- ning den med en annan sträng.
Stoppa
Den här knappen stoppar en åtgärd.
Lägg till sträng
Den här knappen öppnar dialogrutanLägg till strängardär du kan redigera din lista med strängar.
Ta bort sträng
Den här knappen tar bort den markerade strängen från listan (eller den aktuella om ingen är markerad).
Redigera vald sträng
Den här knappen redigerar en markerad sträng.
Töm stränglista
Den här knappen tar bort alla strängar från listan.
Invertera nuvarande sträng
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 från fil
Den här knappen laddar enstränglistasom är sparad i en XML-fil med filändelsen kfr.
Inkludera underkataloger
Den här knappen låter dig söka och ersätta rekursivt i baskatalogens underkataloger.
Handbok Filersättning
Skapa säkerhetskopior
Den här knappen aktiverar att skapa filer försäkerhetskopiering.
Skiftlägeskänslig
Den här knappen aktiverar skiftlägeskänslig sökning.
Aktivera kommandon i ersättningssträngar
Den här knappen aktiverar kommandomöjligheten. Kommandon är specialsträngar. Se Av- snitt3.6.
Aktivera reguljära uttryck
Den här knappen aktiverarQt™-liknande reguljära uttryck.
2.2 Resultatlistan
Resultatvyn visar namnet på filerna som innehåller strängarna du måste hämta (och ersätta), de- ras 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 ge- nom att klicka på posten i listvyn som innehåller rad och kolumnposition med höger musknapp.
2.3 Stränglistan
Det här är strängvyn:
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.
2.4 Dialogrutan Sök och ersätt i filer
Dialogrutan Sök och ersätt i filer 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.
8
2.4.1 Fliken Allmänt
När du vill börja en ny session är det första steget att klicka påknappen Sök och ersätt i filer.
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 underkatalo- ger, göra en skiftlägeskänslig sökning, aktivera kommandon och/eller reguljära uttryck1, 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.
1Observera att reguljära uttryck och kommandon kan sänka prestanda.
Handbok Filersättning
2.4.2 Fliken Avancerat
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 inter- vallet 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).
2.5 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.
2.5.1 Allmänna alternativ
Dessa alternativ har beskrivits i avsnittetVerktygsraden.
10
2.5.2 Avancerade alternativ
Visa inte filen om inga strängar hittas eller ersätts: Visar bara filerna som matchar några av dina strängar. Det snabbar upp sökningen., Vid sökning, stoppa när första sträng hittas: 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., Följ symboliska länkar: Om en fil är en länk till en annan, sök då i den riktiga filen., Ignorera dolda filer och kataloger: Om dolda filer eller kataloger stöts på, ignorera dem.
Handbok Filersättning
2.6 Dialogrutan Infoga söknings- eller ersättningssträngar
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.
12
Kapitel 3
Funktioner i Filersättning
Det här kapitlet tillhandahåller information om några användbara funktioner i Filersättning.
3.1 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 fili menyraden. Själva filens ser ut så här:
<? xml v e r s i o n =" 1.0" ? >
< kfr >
< mode sea rch =" false "/ >
< replacement >
< o l d s t r i n g
> <![ CDATA [ S E A R C H _ S T R I N G _ 1 ]]
> </ oldstring >
< n e w s t r i n g
> <![ CDATA [ R E P L A C E _ S T R I N G _ 1 ]]
> </ newstring >
</ replacement >
< replacement >
< o l d s t r i n g
> <![ CDATA [ S E A R C H _ S T R I N G _ 2 ]]
> </ oldstring >
< n e w s t r i n g
> <![ CDATA [ R E P L A C E _ S T R I N G _ 2 ]]
> </ newstring >
</ replacement >
< replacement >
< o l d s t r i n g
> <![ CDATA [ S E A R C H _ S T R I N G _ N ]]
> </ oldstring >
< n e w s t r i n g
> <![ CDATA [ R E P L A C E _ S T R I N G _ N ]]
> </ newstring >
Handbok Filersättning
</ 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.
3.2 Hur en enkel rapport kan skapas
Du kan skapa en rapport genom att välja Sök eller ersätt → Resultat → Skapa rapportfil i me- nyraden. 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.
3.3 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 ut- tryck. 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är- liga, och det händer ofta att ‘om du vill lösa ett problem med ett reguljärt uttryck, har du två problem’.
3.4 Hur originalfiler kan skyddas
Om du inte vill att originalfilerna ska gå förlorade, kan du göra en kopia av dem innan sträng- ar 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 öppnainställ- ningsdialogrutan.
14
3.5 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 resultat- vyn och klicka med musens högerknapp. En sammanhangsberoende meny visas, där filen kan öppnas.
3.6 Kommandon
Antag att du vill ersätta meningen ‘Alice äventyr i underlandet’ medhela 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 knappenKommandoåt- gärdsom aktiverar kommandon, och starta ersättningen. Det finns också andra kommandon, se appendixBför en lista med alla.
Handbok Filersättning
Kapitel 4
Tack till och licens
KFileReplace. Program copyright 1999 av François Dupouxdupoux@dupoux.com, 2003 Andras Mantiaamantia@kde.org, 2004 Emiliano Gulminiemi_barbarossa@yahoo.it
UPPHOVSMÄN OCH UTVECKLARE AVKFILEREPLACE:
François Dupouxdupoux@dupoux.com Ursprunglig upphovsman
Andras Mantiaamantia@kde.org
Skalupphovsman, skapare av Kpart, bidragande utvecklare Emiliano Gulminiemi_barbarossa@yahoo.it
Nuvarande utvecklare, kodstädning och omskrivning
Dokumentation copyright 2004 Emiliano Gulminiemi_barbarossa@yahoo.it Översättning Stefan Asserhällstefan.asserhall@bredband.net
Den här dokumentationen licensieras under villkoren iGNU Free Documentation License.
Det här programmet licensieras under villkoren iGNU General Public License.
16
Bilaga A
Installation och kompilering
KFileReplace är en del av KDE-projektethttp://www.kde.org/.
KFileReplace finns i kdewebdev-paketet på ftp://ftp.kde.org/pub/kde/, KDE-projektets hu- vudsakliga FTP-plats.
För detaljerad information om hur man kompilerar och installerar KDE-program, seBygga KDE4 från källkod.
Eftersom KDE använder cmake bör du inte ha några problem med att kompilera programmet.
Skulle du stöta på problem, var snäll rapportera dem till KDE:s e-postlistor.
A.1 Krav
För att använda kommandot [$mathexp:ett_matematiskt_uttryck$] måste det matematis- ka verktyget bc (version 1.06 eller senare) installeras, skrivet av Philip A. Nelson (philnel- son@acm.org).
Handbok Filersättning
Bilaga B
Kommandon i Filersättning
[$datetime:iso$]: Kommandot returnerar aktuellt datum och aktuell tid med Qt™ ISO-format., [$datetime:local$]: Som ovan men med lokalt format., [$user:uid$]: Returnera användaridentifika- tion för aktuell användare., [$user:gid$]: Returnera gruppidentifikation för aktuell användare., [$user:loginname$]: Returnera inloggningsnamn för aktuell användare., [$user:fullname$]: Retur- nera fullständigt namn för aktuell användare., [$user:homedir$]: Returnera hemkatalog för aktuell användare., [$user:shell$]: Returnera skal för aktuell användare., [$loadfile:/min-sökväg/min-katalo g/min-fil$]: Returnera innehållet i filen min-fil., [$empty:$]: Returnera en tom sträng., [$random:E
TT_HELTAL$]: Returnera en slumptalssträng med ETT_HELTAL som ursprungligt frö., [$random:$]:
Som ovan, men utan ursprungligt frö., [$mathexp:bc-uttryck$]: Returnera resultatet av ett bc ver- sion 1.06 matematiskt uttryck.
18