<para>&tdefilereplace; ist eine Anwendung zum Suchen und Ersetzen einer Liste von Begriffen in allen Dateien einer Ordnerstruktur. Diese Zeichenketten können Suchbegriffe oder Qt-gleiche reguläre Ausdrücke sein. Es gibt aber noch weitere Möglichkeiten, die Suche zu verbessern. </para>
<para>Dieses Symbol führt zu einem <link linkend="tdefilereplace-the-project-dialog">Sitzungsdialog</link> in dem einige grundlegende Optionen gesetzt werden können; wenn&tdefilereplace; als eigenständige Anwendung gestartet wurde, sollte hier begonnen werden.</para>
<para>Dieses Symbol startet einen Suchen&Ersetzen-Lauf. Sobald ein Suchbegriff gefunden wird, ersetzt &tdefilereplace; diesen mit dem Ersatzbegriff.</para>
<para>Dieses Symbol öffnet den Dialog <link linkend="tdefilereplace-the-add-dialog">Begriffe hinzufügen</link>, in dem die Liste der Begriffe bearbeitet werden kann.</para>
<para>Mit diesem Symbol wird eine <link linkend="tdefilereplace-the-kfr-file"> Begriffsliste </link> geladen, die in einer XML-Datei mit <literal role="extension">kfr</literal>-Erweiterung gespeichert ist.</para>
<para>Dieses Symbol aktiviert die Fähigkeit, Befehle im Suchtext auszuführen. Dies sind spezielle Suchbegriffe, siehe in <xref linkend="tdefilereplace-commands"/>.</para>
<para>Die Ansicht <guilabel>Ergebnisse</guilabel> zeigt die Namen der Dateien, die die Suchbegriffe enthalten, ihren Pfad, ihre Größe, die Anzahl der gefundenen Suchbegriffe und die Benutzer-ID der Dateien. In dieser Ansicht wird auch die exakte Position jedes Treffers angegeben. Eine aufgelistete Datei kann mit der rechten Maustaste geöffnet werden.</para>
<para>Die <guilabel>Begriffe</guilabel>-Ansicht zeigt die Liste der Begriff, die gesucht/ersetzt werden. Bitte beachten Sie, dass im Suchmodus die <guilabel>Ergebnisse</guilabel>-Ansicht und die <guilabel>Begriffe</guilabel>-Ansicht eine unterschiedliche Gestaltung haben.</para>
<para>Im Dialog <guilabel>Neue Sitzung</guilabel> können die Grund-Parameter von &tdefilereplace; eingestellt werden. Es besteht aus zwei Unterfenstern, <guilabel>Allgemein</guilabel> und <guilabel>Erweitert</guilabel>. </para>
<para>Zum Beginnen einer neuen Sitzung, klicken Sie auf das<link linkend="tdefilereplace-the-toolbar"><guiicon>Neue Sitzung</guiicon> -Symbol</link>. Dann muss der Ausgangspfad und eine Folge von Platzhaltern, wie in der Kommando-Shell, als Filter eingegeben werden.</para>
<para>Dann können einige nützliche Optionen, wie Suche in Unterordnern, Beachtung der Groß/Kleinschreibung, Einschalten von Befehlen und/oder regulären Ausdrücken festgelegt werden <footnote id="performancewarning"><para>Bitte beachten Sie, dass reguläre Ausdrücke und Befehle die Geschwindigkeit sehr vermindern können. </para></footnote>, oder die Erstellung einer Sicherung für jede Datei vor dem Ersetzen.</para>
<para>Wenn die Suche starten soll, kann ein Suchbegriff im Suchfeld eingegeben und <guibutton>Sofort Suchen</guibutton> drücken, oder das Suchfeld leer lassen und <guibutton>Später Suchen</guibutton> drücken.</para>
<para>Das Unterfenster <guilabel>Erweitert</guilabel> erlaubt die Einstellung von nützlichen Optionen zur Eingrenzung der Suche auf einen Teil der Dateien in derdurchsuchten Ordnerstruktur. Wenn &tdefilereplace; nur Dateien mit einer Größe im Bereich von 10KB - 100KB gesucht werden sollen, kann die Größenoption genutzt werden. Es gibt eine Datumsoption für die Einschränkung auf einen Zeitraum und eine Möglichkeit, nach dem Eigentümer (auch für Systemadministratoren nützlich) einzugrenzen.</para>
<para>Dieser Dialog enthält Optionen, die auch mit der Werkzeugleiste erreichbar sind und extra Optionen für besondere Umstände. Er kann aus dem Menü mit <menuchoice><guimenu>Einstellungen</guimenu><guimenuitem>KFileReplace einrichten ...</guimenuitem></menuchoice> aufgerufen werden. </para>
<seg>Zeigt nur Dateien mit Suchtreffern. Dies erhöht die Geschwindigkeit der Suche.</seg>
<seg>&tdefilereplace; hält an, wenn ein Suchbegriff gefunden wird und sucht nach anderen Suchbegriffen oder, wenn nur ein Begriff gesucht wird, setzt es mit der nächsten Datei fort.</seg>
<seg>Wenn eine Datei nur eine Verknüpfung zu einer anderen Datei ist, dann wird die echte Datei durchsucht.</seg>
<seg>Wenn es versteckte Dateien oder Ordner gibt, werden diese ignoriert.</seg>
<para>Dieser Dialog wird zum Einfügen und Bearbeiten einer Liste von Begriffen benutzt. Es genügt, entweder eine nur-Suchen oder eine Suchen und Ersetzen Liste auszufüllen bzw. in den beiden Bearbeitungsfeldern zu erfassen. Mit den Pfeilen können Begriffe paarweise zur Suchliste hinzugefügt oder daraus gelöscht werden. Mit <guibutton>OK</guibutton> beendet man den Dialog.</para>
<title>Die Liste mit Suchbegriffen speichern</title>
<para>Wenn die Liste von Suchbegriffen wiederverwendet werden soll, kann sie in einer <literal role="extension">xml</literal> Datei gesichert werden. Dazu ist im Menü <menuchoice><guimenu>Suchen/Ersetzen</guimenu><guisubmenu>Suchbegriffe</guisubmenu><guimenuitem>Liste der Suchbegriffe in eine Datei sichern</guimenuitem></menuchoice> zu wählen. Beim Sichern wird eine einfache <literal role="extension">xml</literal>-Datei mit der Erweiterung <literal role="extension">kfr</literal> erstellt. Um eine <literal role="extension">kfr</literal>-Datei zu Laden, aus dem Menü <menuchoice><guimenu>Suchen/Ersetzen</guimenu><guisubmenu>Suchbegriffe</guisubmenu><guimenuitem>Suchbegriffe aus Datei laden</guimenuitem></menuchoice> wählen . Die aktuelle Datei sieht so aus:</para>
<para>Wenn ein früheres Format vorliegt, kann es händisch durch Anpassen an das Schema oben erneuert werden. Alternativ kann die Datei im alten Format von &tdefilereplace; gelesen und in der vorher beschriebenen Weise erneuert gepeichert werden.</para>
<para>Ein Bericht kann durch die Menüwahl <menuchoice><guimenu>Suchen/Ersetzen</guimenu><guisubmenu>Ergebnisse</guisubmenu><guimenuitem>Erstelle einen Bericht ...</guimenuitem></menuchoice> erstellt werden. Ein Bericht ist ein Ordner, der eine <literal role="extension">xml</literal>- und eine <literal role="extension">css</literal>-Datei enthält. Mit Berichten ist das Mitführen einer einfachen Aufzeichnung ihrer Operationen leicht. <screenshot>
<screeninfo>Die Berichterstellung in &tdefilereplace;</screeninfo>
<para>Wenn z. B. jede Zeichenfolge, die mit <quote>x</quote>, <quote>ht</quote> oder <quote>u</quote> beginnt und mit <quote>ml</quote>endet, gesucht werden soll, könnte ein regulärer Ausdruck wie dieser helfen: <userinput>(x|ht|u)ml</userinput>. Durch Eingeben im Sucheditor und Anklicken von <guibutton>OK</guibutton>, sowie dem Aktivieren regulärer Ausdrücke mit demSymbol <link linkend="tdefilereplace-the-toolbar"><guibutton>Reguläre Ausdrücke vewenden</guibutton></link> startet die Suche. Die Verwendung von regulären Ausdrücken erlaubt komplexe Suchvorgänge, kann aber die Geschwindigkeit drastisch vermindern. Reguläre Ausrücke können sehr trickreich sein, so dass <quote>die Lösung eines Problems mit regulären Ausdrücken oft zu zwei Problemen führt</quote>.</para>
<para>Wenn Originaldateien bewahrt werden sollen, kann davon vor dem Ersetzen eine Kopie erstellt werden. Nach dem Eingeben der Begriffe und vor Beginn des Ersetzen-Vorgangs muss nur das <link linkend="tdefilereplace-the-toolbar">Symbol <guiicon>Sicherungskopie anlegen</guiicon> </link> aktiviert werden. Die Erweiterung der Sicherungsdateien kann im <link linkend="tdefilereplace-the-options-dialog"><guilabel>Optionen</guilabel> -Dialog</link> angepasst werden. </para>
<para>Eine Datei, die Suchbegriffe enthält, kann durch Rechtsklick auf die Zeile mit dem Treffer in der Ergebnisansicht geöffnet werden. Es wird ein Kontextmenü angezeigt, aus dem die Datei geöffnet werden kann. Wenn &tdefilereplace; eingebettet in &quantaplus; verwendet wird, kann die Datei direkt an der Zeile und Spalte geöffnet werden.</para>
<para>Gesetzt, es soll der Ausdruck <quote>Lisis Abenteuer im Wunderland </quote> mit der <ulink url="http://www.textlibrary.com/download/alice-wo.txt">ganzen Datei, die Carrolls Erzählung enthält</ulink>, ersetzt werden. Möglicherweise soll dies nicht händisch geschehen, sondern mit einem Befehl. Klicken Sie das Symbol<link linkend="tdefilereplace-the-toolbar"><guiicon>Hinzufügen</guiicon></link> an, wählen Sie <guilabel>Suchen und Ersetzen-Modus</guilabel> und geben Sie diesen Suchbegriff ein: <userinput>Lisis Abenteuer im Wunderland </userinput> im Suchbegriff-Editor und diesen Ersatzbegriff <userinput>[$loadfile:<replaceable>/Pfad_zu_meinem_Ordner/mein_Ordner/meine_Datei</replaceable>$]</userinput> im Ersatzbegriff-Editor. Bestätigen Sie mit <guibutton>OK</guibutton>. Im Hauptfenster von &tdefilereplace; muss das Symbol <link linkend="tdefilereplace-the-toolbar">Befehle ausführen</link> aktiviert sein. Starten Sie dann den Ersetzen-Vorgang. Es gibt noch viele andere Befehle, siehe die Liste in <xref linkend="available-commands"/>.</para>
<para>&tdefilereplace; ist aktuell Teil des &tdewebdev;-Paketes, daher müssen Sie zum Installieren eine Kopie von &tdewebdev; besorgen. Bitte beachten Sie, dass bei Verwendung einer &kde;-Installation aus einer Distribution &tdewebdev; meist schon installiert ist; in diesem Fall kann &tdefilereplace; entweder über den &quantaplus;-Webeditor, oder direkt verwendet werden (außer Sie haben eine alte &kde;-Version).Sonst könnte das &tdewebdev;-Paket aus dem Internet geladen werden: auf der <ulink url="http://kdewebdev.org">&tdewebdev;-Website</ulink> finden Sie mehr Informationen. </para>
<para>Zur Verwendung von Befehlen der Art <link linkend="available-commands">[$mathexp:<replaceable>irgendein_mathematischer_Ausdruck</replaceable>$]</link> sollte das mathematische Werkzeug &bc; (Version 1.06 oder neuer), entwickelt von Philip A. Nelson (<email>philnelson@acm.org</email>), installiert sein.</para>
