Emiliano Gulmini Översättare: Stefan Asserhäll
2
Innehåll 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 A.1 Krav.............................................. 17 B Kommandon i Filersättning 18
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. 5
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 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 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ättning 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 dialogrutan Lägg till strängar dä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 en stränglista som ä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. 7
Skapa säkerhetskopior Den här knappen aktiverar att skapa filer för sä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 Avsnitt 3.6. Aktivera reguljära uttryck Den här knappen aktiverar Qt -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), 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. 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 underkataloger, göra en skiftlägeskänslig sökning, aktivera kommandon och/eller reguljära uttryck 1, 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. 1 Observera att reguljära uttryck och kommandon kan sänka prestanda. 9
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 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). 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 avsnittet Verktygsraden. 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. 11
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 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 > 13
</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 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. 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 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. 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ä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. 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 resultatvyn 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 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 appendix B för en lista med alla. 15
Kapitel 4 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@bredband.net Den här dokumentationen licensieras under villkoren i GNU Free Documentation License. Det här programmet licensieras under villkoren i GNU General Public License. 16
Bilaga A Installation och kompilering KFileReplace är en del av KDE-projektet http://www.kde.org/. KFileReplace finns i kdewebdev-paketet på ftp://ftp.kde.org/pub/kde/, KDE-projektets huvudsakliga FTP-plats. För detaljerad information om hur man kompilerar och installerar KDE-program, se Bygga 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 matematiska verktyget bc (version 1.06 eller senare) installeras, skrivet av Philip A. Nelson (philnelson@acm.org). 17
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ändaridentifikation 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$]: Returnera 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 version 1.06 matematiskt uttryck. 18