<para>&tdefilereplace; 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. </para>
<para>Denne knap viser en <link linkend="tdefilereplace-the-project-dialog">sessionsdialog</link> hvori du kan ændre flere basale indstillinger. Hvis &tdefilereplace; kører som et selvstændigt program bør du starte her for at starte en søgning.</para>
<para>Denne knap indlæser en <link linkend="tdefilereplace-the-kfr-file">strengliste</link> gemt i en xml-fil med <literal role="extension">kfr</literal>-filendelsen.</para>
<para><guilabel>Resultat</guilabel>-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.</para>
<para><guilabel>Streng</guilabel>-visningen visualiserer listen af strenge du vil søge/erstatte. Bemærk at i hver tilstand vil <guilabel>Resultater</guilabel>-visningen og <guilabel>Streng</guilabel>-visningen have et forskelligt udseende.</para>
<para>Dialogen <guilabel>Ny session</guilabel> bruges til at indstille de basale parametre der skal bruges for at &tdefilereplace; virker. Den består af to dele, <guilabel>Generelt</guilabel> og <guilabel>Avanceret</guilabel>. </para>
<para>Når du vil starte en ny session, er første skridt at klikke på <link linkend="tdefilereplace-the-toolbar"><guiicon>Ny session</guiicon>-knappen</link>. Så skal du indtaste stien og en sekvens af skalagtige jokertegn for at bruge dem som filter.</para>
<para>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 <footnote id="performancewarning"><para>Bemærk at regulære udtryk og kommandoer kan nedsætte søgehastigheden.</para></footnote>, udføre sikkerhedskopiering af filer før erstatning.</para>
<para>Hvis du vil starte en søgning, kan du indsætte en streng i søgefeltet og trykke på knappen <guibutton>Søg nu</guibutton>, ellers lad feltet være tomt og tryk på knappen <guibutton>Søg senere</guibutton>.</para>
<para>Fanebladet <guilabel>Avanceret</guilabel> 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 &tdefilereplace; 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).</para>
<para>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 <menuchoice><guimenu>Opsætning</guimenu><guimenuitem>Indstil KFileReplace...i</guimenuitem></menuchoice> i hovedmenuen. </para>
<seg>vidser kun de filer matcher nogle af dine strenge. Dette får søgningen til at gå hurtigere.</seg>
<seg>&tdefilereplace; 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.</seg>
<seg>hvis en fil er et link til en anden, så søges i den rigtige fil.</seg>
<seg>hvis skjulte filer eller mapper mødes, så ignoreres de.</seg>
<para>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 <guibutton>OK</guibutton>.</para>
<para>Når du vil genbruge en liste af strenge, kan du gemme den i en <literal role="extension">xml</literal>-fil. Dor at gøre dette skal du i menulinjen vælge <menuchoice><guimenu>Søg/Erstat</guimenu><guisubmenu>Strenge</guisubmenu><guimenuitem>Gem strengliste til fil</guimenuitem></menuchoice>. Når du gemmer en liste oprettes der en simpel <literal role="extension">xml</literal>-fil med filendelsen <literal role="extension">kfr</literal>. For at indlæse en <literal role="extension">kfr</literal>-fil, vælger du i menulinjen <menuchoice><guimenu>Søg/Erstat</guimenu><guisubmenu>Strenge</guisubmenu><guimenuitem>Indlæs strengliste fra fil</guimenuitem></menuchoice>. Filen ser således ud:</para>
<para>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 &tdefilereplace;, på samme måde som forklaret før.</para>
<para>Du kan oprette en rapport ved at vælge <menuchoice><guimenu>Søg/Erstat</guimenu><guisubmenu>Resultater</guisubmenu><guimenuitem>Opret rapportfil</guimenuitem></menuchoice> fra hovedmenuen. En rapport består af en mappe med en <literal role="extension">xml</literal>-fil og en <literal role="extension">css</literal>-fil. Rapporter er nyttige til at vedligeholde et simpelt log-system over dine operationer. <screenshot>
<para>Hvis du vil søge efter hver eneste streng der starter med <quote>x</quote>, <quote>ht</quote> eller <quote>u</quote> og som slutter med <quote>ml</quote>, kan du skrive et regulært udtryk sådan her <userinput>(x|ht|u)ml</userinput>. Indsæt dette udtryk i søgeeditoren, klik på knappen <guibutton>OK</guibutton> og aktiver til sidst regulære udtryk ved at trykke på <link linkend="tdefilereplace-the-toolbar"><guibutton>Regulært udtryk</guibutton>-knappen</link>. 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 <quote>hvis du vil løse et problem med et regulært udtryk, står du med to problemer</quote>.</para>
<para>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 <link linkend="tdefilereplace-the-toolbar"><guiicon>Opret sikkerhedskopier</guiicon></link>. Hvis du vil tilpasse sikkerhedskopiernes fil-endelser skal du åbne dialogen <link linkend="tdefilereplace-the-options-dialog"><guilabel>Indstillinger</guilabel></link>. </para>
<para>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 &tdefilereplace; indlejret i &quantaplus;, kan du åbne filen direkte ved den angivede linje og søjle.</para>
<para>Forestil dig du vil erstatte sætningen <quote>Alice i Eventyrland</quote> med <ulink url="http://www.textlibrary.com/download/alice-wo.txt"> hele filen der indeholder Carrolls roman.</ulink>. 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 <link linkend="tdefilereplace-the-toolbar"><guiicon>Tilføj</guiicon></link> og vælger <guilabel>Søge- og erstatningstilstand</guilabel> og indsætter følgende strenge: <userinput>Alice i eventyrland</userinput> i søgeeditoren og strengen <userinput>[$loadfile:<replaceable>/stientilminmappe/minmappe/minfil</replaceable>$]</userinput> i erstatningseditoren. Klik på knappen <guibutton>OK</guibutton>. Tilbage i &tdefilereplace;s hovedvindue, trykker du på knappen <link linkend="tdefilereplace-the-toolbar">Aktivér kommandoer i erstatningsstreng</link>, der aktiverer kommandoerne og så starter du erstatningsprocessen. Andre kommander kan du læse om i <xref linkend="available-commands"/> hvor du også finder en hel liste over kommandoer.</para>
<title>Sådan installerer du &tdefilereplace;</title>
<para>&tdefilereplace; 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 &tdefilereplace; 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 <ulink url="http://kdewebdev.org"> &tdewebdev;-hjemmesiden</ulink> hvor du også kan få mere information. </para>
<para>For at bruge kommandoen <link linkend="available-commands">[$mathexp:<replaceable>some_math_expression</replaceable>$]</link> skal du installere &bc; matematikværktøjet (version 1.06 eller nyere) skrevet af Philip A. Nelson (<email>philnelson@acm.org</email>). </para>
