Das Handbuch zu KFileReplace
Das Handbuch zu KFileReplace
Weiter

Das Handbuch zu KFileReplace

Emiliano Gulmini

Deutsche Übersetzung: Georg Schuster
Version 1.0.0 (2004-08-09)

Es ist erlaubt, dieses Dokument zu kopieren, zu vertreiben und/oder zu ändern gemäß den Bedingungen der GNU Free Documentation Licence, Version 1.1 oder irgend einer späteren Version, wie sie von der Free Software Foundation veröffentlicht wurde; ohne die invarianten Abschnitte, ohne Texte auf der vorderen Umschlagseite, und ohne Texte auf der hinteren Umschlagseite. Eine Kopie der Lizenz findet sich im Abschnitt "GNU Free Documentation License".

KFileReplace ist ein Werkzeug zum Suchen und Ersetzen in Dateien.


Kapitel 1. Einführung
Einführung
Zurück
Weiter

Kapitel 1. Einführung

KFileReplace 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.

Zurück
Weiter
Zum Anfang


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kapitel 2. Die Verwendung von KFileReplace
Die Verwendung von KFileReplace
Zurück
Weiter

Kapitel 2. Die Verwendung von KFileReplace


KFileReplace als selbständige Anwendung

Die Werkzeugleiste

Die Werkzeugleiste von KFileReplace sollte so aussehen:


Die Werkzeugleiste von KFileReplace

In der Werkzeugleiste sind Symbole für die wichtigen Funktionen enthalten.

Werkzeugleisten-Symbole

Neue Sitzung

Dieses Symbol führt zu einem Sitzungsdialog in dem einige grundlegende Optionen gesetzt werden können; wennKFileReplace als eigenständige Anwendung gestartet wurde, sollte hier begonnen werden.

Nur Suchen

Mit diesem Symbol wird ein Suchlauf gestartet.

Ersetzen

Dieses Symbol startet einen Suchen&Ersetzen-Lauf. Sobald ein Suchbegriff gefunden wird, ersetzt KFileReplace diesen mit dem Ersatzbegriff.

Simuliertes Ersetzen

Dieses Symbol startet einen nur simulierte Suchen&Ersetzen-Lauf. In Wirklichkeit geschieht nichts.

Stop

Dieses Symbol stoppt die Ausführung.

Begriffe hinzufügen

Dieses Symbol öffnet den Dialog Begriffe hinzufügen, in dem die Liste der Begriffe bearbeitet werden kann.

Begriff entfernen

Das Symbol entfernt den ausgewählten (oder den aktuellen, wenn es keine Auswahl gibt) Begriff aus der Liste.

Begriffe bearbeiten

Mit diesem Symbol werden ausgewählte Begriffe bearbeitet.

Liste löschen

Mit diesem Symbol werden alle Begriffe aus der Liste gelöscht.

Such- und Ersatzbegriff tauschen

Mit diesem Symbol werden Suchbegriff und Ersatzbegriff vertauscht. Damit kann eine Suchen/Ersetzen-Operation rückgängig gemacht werden.

Begriffsliste laden

Mit diesem Symbol wird eine Begriffsliste geladen, die in einer XML-Datei mit kfr-Erweiterung gespeichert ist.

Unterordner einbeziehen

Mit diesem Symbol können Unterordner im Suchverzeichnis rekursiv in das Suchen/Ersetzen einbezogen werden.

Erstelle Sicherungsdateien

Mit diesem Symbol wird die Erstellung von Sicherungs-Dateien aktiviert.

Suche mit Beachtung der Groß/Kleinschreibung

Dieses Symbol aktiviert die Beachtung von Groß/Kleinschreibung beim Suchen.

Befehle

Dieses Symbol aktiviert die Fähigkeit, Befehle im Suchtext auszuführen. Dies sind spezielle Suchbegriffe, siehe in „Befehle“.

Reguläre Ausdrücke

Das Symbol aktiviert Qt-gleiche reguläre Ausdrücke.

Die Ergebnisliste
Die Ergebnisliste

Die Ergebnisliste


Ergebnisansicht von KFileReplace

Die Ansicht Ergebnisse 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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Die Suchbegriffsliste
Die Suchbegriffsliste

Die Suchbegriffsliste

Das ist die Begriffe-Ansicht:


Die Begriffe-Ansicht von KFileReplace

Die Begriffe-Ansicht zeigt die Liste der Begriff, die gesucht/ersetzt werden. Bitte beachten Sie, dass im Suchmodus die Ergebnisse-Ansicht und die Begriffe-Ansicht eine unterschiedliche Gestaltung haben.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Der Dialog Neue Sitzung
Der Dialog Neue Sitzung

Der Dialog Neue Sitzung

Im Dialog Neue Sitzung können die Grund-Parameter von KFileReplace eingestellt werden. Es besteht aus zwei Unterfenstern, Allgemein und Erweitert.

Das Unterfenster Allgemein


KFileReplace, Unterfenster Allgemein

Zum Beginnen einer neuen Sitzung, klicken Sie auf dasNeue Sitzung -Symbol. Dann muss der Ausgangspfad und eine Folge von Platzhaltern, wie in der Kommando-Shell, als Filter eingegeben werden.

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 [1], oder die Erstellung einer Sicherung für jede Datei vor dem Ersetzen.

Wenn die Suche starten soll, kann ein Suchbegriff im Suchfeld eingegeben und Sofort Suchen drücken, oder das Suchfeld leer lassen und Später Suchen drücken.

Das Unterfenster Erweitert


Unterfenster Erweitert von KFileReplace

Das Unterfenster Erweitert erlaubt die Einstellung von nützlichen Optionen zur Eingrenzung der Suche auf einen Teil der Dateien in derdurchsuchten Ordnerstruktur. Wenn KFileReplace 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.



[1] Bitte beachten Sie, dass reguläre Ausdrücke und Befehle die Geschwindigkeit sehr vermindern können.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Der Optionen-Dialog
Der Optionen-Dialog

Der Optionen-Dialog

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 Einstellungen->KFileReplace einrichten ... aufgerufen werden.

Allgemeine Einstellungen

Diese Optionen wurden im Bereich Werkzeugleiste dargestellt.


Das Unterfenster Allgemein des Optionendialoges

Erweiterte Einstellungen


Das Unterfenster Erweitert des Optionendialoges
Dateien nicht zeigen, in denen keine Suchbegriffe gefunden wurden: Zeigt nur Dateien mit Suchtreffern. Dies erhöht die Geschwindigkeit der Suche.
Beim Suchen an der ersten Fundstelle anhalten: KFileReplace 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.
Folge symbolischen Verknüpfungen (Links): Wenn eine Datei nur eine Verknüpfung zu einer anderen Datei ist, dann wird die echte Datei durchsucht.
Versteckte Dateien und Ordner ignorieren: Wenn es versteckte Dateien oder Ordner gibt, werden diese ignoriert.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Der Füge Suchen/Ersetzen-Begriffe ein-Dialog
Der Füge Suchen/Ersetzen-Begriffe ein-Dialog

Der Füge Suchen/Ersetzen-Begriffe ein-Dialog


Der Füge Suchen/Ersetzen-Begriffe ein Dialog von KFileReplace

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 OK beendet man den Dialog.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Zurück
Weiter
Zum Anfang


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kapitel 3. Möglichkeiten von KFileReplace
Möglichkeiten von KFileReplace
Zurück
Weiter

Kapitel 3. Möglichkeiten von KFileReplace

Diese Kapitel beschreibt einige sehr nützliche Möglichkeiten von KFileReplace.

Die Liste mit Suchbegriffen speichern

Wenn die Liste von Suchbegriffen wiederverwendet werden soll, kann sie in einer xml Datei gesichert werden. Dazu ist im Menü Suchen/Ersetzen->Suchbegriffe->Liste der Suchbegriffe in eine Datei sichern zu wählen. Beim Sichern wird eine einfache xml-Datei mit der Erweiterung kfr erstellt. Um eine kfr-Datei zu Laden, aus dem Menü Suchen/Ersetzen->Suchbegriffe->Suchbegriffe aus Datei laden wählen . Die aktuelle Datei sieht so aus:

<?xml version="1.0" ?>
<kfr>
        <mode search="false"/>
        <replacement>
                <oldstring
><![CDATA[SUCHBEGRIFF_1]] 
></oldstring
> 
                <newstring
><![CDATA[ERSATZBEGRIFF_1]]
></newstring>
        </replacement>
        <replacement>
                <oldstring
><![CDATA[SUCHBEGRIFF_2]]
></oldstring>
                <newstring
><![CDATA[ERSATZBEGRIFF_2]]
></newstring>
        </replacement>


        <replacement>
                <oldstring
><![CDATA[SUCHBEGRIFF_N]]
></oldstring
> 
                <newstring
><![CDATA[ERSATZBEGRIFF_N]]
></newstring>
        </replacement>

</kfr
>

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 KFileReplace gelesen und in der vorher beschriebenen Weise erneuert gepeichert werden.

Einen einfachen Bericht erstellen
Einen einfachen Bericht erstellen

Einen einfachen Bericht erstellen

Ein Bericht kann durch die Menüwahl Suchen/Ersetzen->Ergebnisse->Erstelle einen Bericht ... erstellt werden. Ein Bericht ist ein Ordner, der eine xml- und eine css-Datei enthält. Mit Berichten ist das Mitführen einer einfachen Aufzeichnung ihrer Operationen leicht.


Die Berichterstellung in KFileReplace



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Reguläre Ausrücke verwenden
Reguläre Ausrücke verwenden

Reguläre Ausrücke verwenden

Wenn z. B. jede Zeichenfolge, die mit „x“, „ht“ oder „u“ beginnt und mit „ml“endet, gesucht werden soll, könnte ein regulärer Ausdruck wie dieser helfen: (x|ht|u)ml. Durch Eingeben im Sucheditor und Anklicken von OK, sowie dem Aktivieren regulärer Ausdrücke mit demSymbol Reguläre Ausdrücke vewenden 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 „die Lösung eines Problems mit regulären Ausdrücken oft zu zwei Problemen führt“.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Originaldateien bewahren
Originaldateien bewahren

Originaldateien bewahren

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 Symbol Sicherungskopie anlegen aktiviert werden. Die Erweiterung der Sicherungsdateien kann im Optionen -Dialog angepasst werden.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Eine Datei öffnen
Eine Datei öffnen

Eine Datei öffnen

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 KFileReplace eingebettet in Quanta Plus verwendet wird, kann die Datei direkt an der Zeile und Spalte geöffnet werden.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Befehle
Befehle

Befehle

Gesetzt, es soll der Ausdruck „Lisis Abenteuer im Wunderland “ mit der ganzen Datei, die Carrolls Erzählung enthält, ersetzt werden. Möglicherweise soll dies nicht händisch geschehen, sondern mit einem Befehl. Klicken Sie das SymbolHinzufügen an, wählen Sie Suchen und Ersetzen-Modus und geben Sie diesen Suchbegriff ein: Lisis Abenteuer im Wunderland im Suchbegriff-Editor und diesen Ersatzbegriff [$loadfile:/Pfad_zu_meinem_Ordner/mein_Ordner/meine_Datei$] im Ersatzbegriff-Editor. Bestätigen Sie mit OK. Im Hauptfenster von KFileReplace muss das Symbol Befehle ausführen aktiviert sein. Starten Sie dann den Ersetzen-Vorgang. Es gibt noch viele andere Befehle, siehe die Liste in Anhang B, KFileReplace-Befehle.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Zurück
Weiter
Zum Anfang


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kapitel 4. Mitwirkende und Lizenz
Mitwirkende und Lizenz
Zurück
Weiter

Kapitel 4. Mitwirkende und Lizenz

KFileReplace. Programm copyright 1999 by François Dupoux , 2003 Andras Mantia , 2004 Emiliano Gulmini

Die Autoren und Betreuer von KFileReplace:

François Dupoux

Ursprünglicher Autor

Andras Mantia

Autor des Konsolenprogrammes, KPart-Ersteller, Co-Betreuer

Emiliano Gulmini

Aktueller Betreuer, Quelltextverbesserung

Dokumentations-Copyright (c) 2004 Emiliano Gulmini

Deutsche Übersetzung von Georg Schuster

Diese Dokumentation ist unter den Bedingungen der GNU Free Documentation License veröffentlicht.

Dieses Programm ist unter den Bedingungen der GNU General Public License veröffentlicht.

Zurück
Weiter
Zum Anfang


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anhang A. Installation
Installation
Zurück
Weiter

Anhang A. Installation

KFileReplace installieren

KFileReplace ist aktuell Teil des kdewebdev-Paketes, daher müssen Sie zum Installieren eine Kopie von kdewebdev besorgen. Bitte beachten Sie, dass bei Verwendung einer KDE-Installation aus einer Distribution kdewebdev meist schon installiert ist; in diesem Fall kann KFileReplace entweder über den Quanta Plus-Webeditor, oder direkt verwendet werden (außer Sie haben eine alte KDE-Version).Sonst könnte das kdewebdev-Paket aus dem Internet geladen werden: auf der kdewebdev-Website finden Sie mehr Informationen.

Erfordernisse
Erfordernisse

Erfordernisse

Zur Verwendung von Befehlen der Art [$mathexp:irgendein_mathematischer_Ausdruck$] sollte das mathematische Werkzeug bc (Version 1.06 oder neuer), entwickelt von Philip A. Nelson (), installiert sein.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Zurück
Weiter
Zum Anfang


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anhang B. KFileReplace-Befehle
KFileReplace-Befehle
Zurück

Anhang B. KFileReplace-Befehle

[$datetime:iso$]: Dieser Befehl liefert das aktuelle Datum und die Uhrzeit im Qt ISO-Format.
[$datetime:local$]: Wie oben, aber im lokalen Format.
[$user:uid$]: Liefert die UID des aktuellen Benutzers.
[$user:gid$]: Liefert die GID des aktuellen Benutzers.
[$user:loginname$]: Liefert den Anmeldenamen des aktuellen Benutzers.
[$user:fullname$]: Liefert den vollen Namen des aktuellen Benutzers.
[$user:homedir$]: Liefert den Heimatordner des aktuellen Benutzers.
[$user:shell$]: Liefert die Shell des aktuellen Benutzers.
[$loadfile:/mein_Pfad/mein_Ordner/meine_Datei$]: Liefert den Inhalt der meine_Datei Datei.
[$empty:$]: Liefert eine leere Zeichenkette.
[$random:EINE_GANZZAHL$]: Liefert eine Zeichenkette mit einer Zufallszahl unter Verwendung EINER_GANZZAHL als Anfangs-Streuung.
[$random:$]: Wie oben, aber ohne Anfangs-Streuung.
[$mathexp:bc-Ausdruck$]: Liefert das Ergebnis des mathematischen Ausdrucks aus bc V1.06.

Zurück
Zum Anfang


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Weiter
 


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team