KFileReplace"> tdewebdev"> bc"> ]> &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 <guilabel >Ny session</guilabel > 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. <guilabel >Generelt</guilabel >-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 <guilabel >Avanceret</guilabel > &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 <guilabel >Indstillinger</guilabel > 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ætningIndstil 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 <guilabel >Tilføj strenge</guilabel > &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/ErstatStrengeGem 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/ErstatStrengeIndlæ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/ErstatResultaterOpret 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 &tdewebdev;-pakken, så for at installere det skal du først hente en kopi af &tdewebdev;. Bemærk at hvis du bruger en &kde;-installation der kommer fra din operativsystem-leverandør, har du sandsynligvis allerede&tdewebdev; 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 &tdewebdev;-pakken fra &tdewebdev;-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;