Podręcznik KFileReplace
Podręcznik KFileReplace
Następny

Podręcznik KFileReplace

Emiliano Gulmini

Polskie tłumaczenie dokumentacji: Łukasz Fidosz
Zmiana 1.0.0 (2004-08-09)

Dozwolone jest kopiowanie, dystrybucja i/lub modyfikacja tego dokumentu na zasadach licencji GNU Free Documentation License, w wersji 1.1 lub dowolnej późniejszej wersji, opublikowanej przez Free Software Foundation; bez Sekcji Niezmiennych, bez Tekstu Początkowego i bez tekstu Końcowego. Kopia tej licencji znajduje się w sekcji zatytułowanej "GNU Free Documentation License".

KFileReplace jest narzędziem do wyszukiwania i zamiany ciągów znaków.


Rozdział 1. Wprowadzenie
Wprowadzenie
Poprzedni
Następny

Rozdział 1. Wprowadzenie

KFileReplace jest programem służącym do wyszukiwania i zastępowania listy ciągów znaków w drzewie plików. Ciągi mogą być określone dosłowne lub w postaci wyrażeń regularnych w stylu Qt. Posiada także inne opcje służące do precyzyjnego ustawienia Twojego wyszukiwania.

Poprzedni
Następny
Spis treści


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

Rozdział 2. Używanie KFileReplace
Używanie KFileReplace
Poprzedni
Następny

Rozdział 2. Używanie KFileReplace


KFileReplace we własnym cieleniu

Pasek narzędzi

Pasek narzędzi KFileReplace powinien wyglądać tak jak poniżej:


Pasek narzędzi KFileReplace

Pasek narzędzi pokazuje Ci przyciski podstawowych funkcji.

Ikony paska narzędzi

Nowa sesja

Ten przycisk otwiera okno sesji w którym możesz ustawić kilka podstawowych opcji. Jeśli KFileReplace jest uruchomione jako samodzielny program, powinno się kliknąć ten przycisk w pierwszej kolejności.

Znajdź

Ten przycisk rozpoczyna proces wyszukiwania.

Zamień

Ten przycisk rozpoczyna proces wyszukiwania i zamiany. Kiedy ciąg zostanie znaleziony, KFileReplace zastąpi go przez inny ciąg.

Symulowana zamiana

Ten przycisk rozpoczyna symulowane wyszukiwanie i zamianę. Nic się w rzeczywistości nie stanie jeśli naciśniesz ten przycisk.

Stop

Ten przycisk zatrzymuje aktualną operacje.

Dodaj ciąg

Ten przycisk otwiera okno Dodawania ciągów, w którym możesz edytować swoją listę ciągów.

Usuń ciąg

Ten przycisk usuwa zaznaczony (lub aktualny jeśli żaden nie został zaznaczony) ciąg z listy.

Modyfikuj wybrany ciąg

Ten przycisk edytuje zaznaczony ciąg.

Wyczyść listę ciągów

Ten przycisk usuwa wszystkie ciągi z listy.

Zamień ciągi miejscami

Ten przycisk zamienia ciągi miejscami, tak że szukany ciąg staje się zamienianym, więc możesz odwrócić operacje szukania i zamieniania.

Wczytaj listę ciągów z pliku

Ten przycisk wczytuje lisŧę ciągów zapisaną w pliku xml z rozszerzeniem kfr.

Przeszukuj podkatalogi

Ten przycisk pozwala Ci na rekurencyjne przeszukiwanie podkatalogów w Twoim katalogu bazowym podczas szukania/zamieniania.

Twórz kopie zapasowe

Ten przycisk włącza tworzenie kopii zapasowych.

Rozróżnianie wielkich/małych liter

Ten przycisk włącza rozróżnianie wielkich/małych liter podczas szukania.

Polecenia

Ten przycisk włącza obsługę poleceń. Polecenia są specjalnymi ciągami. Zobacz „Polecenia”.

Wyrażenia regularne

Ten przycisk włącza wyrażenia regularne w stylu Qt.

Lista wyników
Lista wyników

Lista wyników


Widok wyników w KFileReplace

Widok Wyniki pokazuje nazwy plików, które zawierają szukane przez Ciebie ciągi, ich ścieżki, rozmiar i liczbę odnalezionych ciągów oraz identyfikator właściciela tych plików. Ten widok pokazuje także dokładną pozycję każdego dopasowania. Możesz także otworzyć plik klikając prawym przyciskiem myszy na elemencie listy zawierającym numer wiersza i kolumny.



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

Lista ciągów
Lista ciągów

Lista ciągów

To jest widok Ciągi:


Widok ciągów w KFileReplace

Widok Ciągi ukazuje listę ciągów, które chcesz znaleźć/zamienić. Proszę zauważyć, że w trybie wyszukiwania widok Wyniki i widok Ciągi mają inny układ.



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

Okno Nowa sesja
Okno Nowa sesja

Okno Nowa sesja

Okno Nowa sesja jest używane do skonfigurowania podstawowych parametrów wymaganych przez KFileReplace do pracy. Składa się z dwóch zakładek, Ogólne i Zaawansowane.

Karta Ogólne


Karta Ogólne

Kiedy chcesz rozpocząć nową sesję pierwszym krokiem jest kliknięcie na przycisk Nowa sesja . Następnie musisz podać ścieżkę bazową i ciąg masek nazw plików w stylu powłoki, które zostaną użyte jako filtr.

Następnie możesz ustawić trochę użytecznych opcji, jak wyszukiwanie we wszystkich podkatalogach, wyszukiwanie z rozróżnianiem wielkości znaków, włączanie poleceń i/lub wyrażeń regularnych[1], tworzenie kopii zapasowych plików przed zamianą.

Jeśli chcesz rozpocząć wyszukiwanie, wpisz ciąg w pole wyszukiwania i naciśnij przycisk Znajdź teraz. W przeciwnym wypadku pozostaw pole wyszukiwania puste i naciśnij Znajdź później.

Karta Zaawansowane


Karta Zaawansowane w KFileReplace

Karta Zaawansowane pozwoli Ci ustawić kilka użytecznych opcji zawężających wyszukiwanie do podzbioru Twojego docelowego drzewa plików. Jeśli chcesz uruchomić KFileReplace tylko dla plików o rozmiarach w zakresie 10KB - 100KB, wtedy możesz skorzystać z ustawień rozmiaru. Znajduje się tam także opcja daty, która ogranicza wyszukiwanie do zakresu czasowego, a ostatnia opcja pozwala Ci na wyszukiwanie tylko do plików należących (lub nienależących) do konkretnego użytkownika (może być ona bardziej użyteczna dla administratora systemu).



[1] Proszę zwrócić uwagę, że wyrażenia regularne i polecenia mogą zmniejszyć szybkość wykonywania.



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

Okno Opcje
Okno Opcje

Okno Opcje

To okno dialogowe zawiera opcje które znajdują się na pasku narzędzi i dodatkowe ustawienia, które mogą okazać się poręczne w niektórych sytuacjach. Możesz je wywołać wybierając Ustawienia->Konfiguracja KFileReplace...w menu głównym.

Ustawienia ogólne

Opcje te zostały przedstawione w sekcji Pasek narzędzi.


Karta Ogólne okna Opcje

Zaawansowane opcje


Karta zaawansowane okna Opcje
Nie pokazuj plików jeśli żaden ciąg nie został znaleziony lub zamieniony: pokazuje tylko pliki, które pasują do któregoś z Twoich ciągów. Zwiększa to szybkość wyszukiwania.
Podczas wyszukiwania, zatrzymaj sie na pierwszym znalezionym ciągu: KFileReplace zatrzyma się, kiedy znajduje pasujący ciąg i kontynuuje wyszukiwanie dla innych ciągów, zaś jeśli szukasz tylko jednego ciągu, wyszukiwanie będzie kontynuowane dla następnego pliku.
Podążaj za dowiązaniami symbolicznymi: jeśli plik jest dowiązaniem do innego pliku, wyszukiwanie będzie sie odbywało na wskazywanym przez dowiązanie pliku.
Ignoruj ukryte pliki i katalogi: jeśli ukryte pliki lub katalogi zostaną napotkane, ignoruje je.



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

Okno Dodaj ciągi
Okno Dodaj ciągi

Okno Dodaj ciągi


Okno Dodaj ciągi w KFileReplace

To okno jest używane do wstawiania i edytowania listy ciągów. Możesz wstawić albo listę ciągów tylko do wyszukiwania, albo do wyszukiwania i zamiany, a następnie za pomocą dwóch mini edytorów możesz podać swój tekst. Przyciski strzałek pozwalają Ci na dodawanie lub usuwanie par ciągów. Kiedy skończysz, kliknij na przycisk OK.



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

Poprzedni
Następny
Spis treści


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

Rozdział 3. Funkcje KFileReplace
Funkcje KFileReplace
Poprzedni
Następny

Rozdział 3. Funkcje KFileReplace

Ten rozdział zawiera informacje o kilku użytecznych możliwościach KFileReplace.

Jak zapisać Twoją listę ciągów

Jeśli chcesz użyć ponownie listę ciągów możesz zapisać ją w pliku xml. Aby to zrobić wybierz z menu Znajdź/Zamień->Ciągi->Zapisz listę ciągów do pliku. Kiedy zapiszesz listę zostanie utworzony prosty plik xml z rozszerzeniem kfr. Aby wczytać plik kfr wybierz z menu Znajdź/Zamień->Ciągi->Wczytaj listę ciągów z pliku. Sam plik wygląda następująco:

<?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
>

Jeśli używasz poprzedniego formatu, możesz uaktualnić twój plik ręcznie przez prostą modyfikację zgodnie ze schematem powyżej. Alternatywne możesz wczytać plik napisany w starym formacie i zapisać go ponownie w KFileReplace tak jak zostało to wcześniej wyjaśnione.

Jak utworzyć prosty raport
Jak utworzyć prosty raport

Jak utworzyć prosty raport

Raport możesz stworzyć wybierając z głównego menu Znajdź/zamień->Wyniki->Utwórz plik z raportem. Raport jest katalogiem zawierającym pliki xml i css. Raporty mogą być użyteczne przy prowadzeniu prostych dzienników Twoich działań.


Funkcja raportów w KFileReplace'



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

Jak używać wyrażeń regularnych
Jak używać wyrażeń regularnych

Jak używać wyrażeń regularnych

Jeśli chcesz odnaleźć każdy ciąg zaczynający się na „x”, „ht” lub „u” i kończący się na „ml”, możesz napisać wyrażenie regularne podobne do tego: (x|ht|u)ml. Wstaw to wyrażenie do pola wyszukiwania, kliknij OK i włącz wyrażenia regularne przez przełączenie przycisku Wyrażenia regularne. Zauważ, że używanie wyrażeń regularnych pozwala Ci tworzyć nawet bardzo skomplikowane wyszukiwania, ale kosztem może być nieprawidłowe wykonanie. Wyrażenie regularne może być bardzo skomplikowane, a to często powoduje, że „jeśli chcesz rozwiązać problem za pomocą wyrażenia regularnego, to masz dwa problemy”.



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

Jak chronić oryginalne pliki
Jak chronić oryginalne pliki

Jak chronić oryginalne pliki

Jeśli nie chcesz stracić oryginalnych plików, możesz zrobić ich kopie przed zamianą ciągów. Po wpisaniu Twoich ciągów i przed rozpoczęciem procesu zastępowania, musisz przełączyć przycisk Twórz kopie zapasowe. Jeśli chcesz zmienić rozszerzenie plików kopii zapasowych, otwórz okno Opcje.



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

Jak otworzyć plik
Jak otworzyć plik

Jak otworzyć plik

Jeśli chcesz otworzyć plik pasujący do któregoś z Twoich ciągów, wybierz daną linię w widoku wyników i kliknij prawym przyciskiem myszy. Pojawi się menu kontekstowe z którego możesz otworzyć plik. Jeśli używasz KFileReplace wbudowane w Quanta Plus, możesz otworzyć plik w tym programie od razu na określonym wierszu i kolumnie.



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

Polecenia
Polecenia

Polecenia

Załóżmy, że chcesz zamienić wyrażenie „Alice's adventures in Wonderland” na cały tekst opowiadania Carrolla. Prawdopodobnie nie chcesz robić tego ręcznie, potrzebujesz polecenia, które zrobi to za Ciebie. Kliknij przycisk Dodaj, wybierz Tryb wyszukiwania i zamiany i wpisz następujące ciągi: Alice's adventure in Wonderland w polu znajdowania i ciąg [$loadfile:/ścieżka-do-mojego-folderu/mój-folder/mój-plik$] w polu zamiany. Kliknij OK . Kiedy powrócisz do głównego okna KFileReplace, przełącz przyciskPolecenia tak, żeby polecenia były włączone, i rozpocznij proces zamieniania. Istnieje więcej poleceń, zobacz Dodatek B, Polecenia w KFileReplace, aby zapoznać się z listą pozostałych.



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

Poprzedni
Następny
Spis treści


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

Rozdział 4. Zasługi i licencje
Zasługi i licencje
Poprzedni
Następny

Rozdział 4. Zasługi i licencje

Prawa autorskie do programu: copyright 1999 François Dupoux , 2003 Andras Mantia , 2004 Emiliano Gulmini

Autorzy i opiekunowie KFileReplace:

François Dupoux

Pierwotny autor

Andras Mantia

Autor powłoki, twórca KPart, współopiekun

Emiliano Gulmini

Bieżący opiekun, czyszczenie i przepisywanie kodu

Prawa autorskie do dokumentacji: (c) 2004 Emiliano Gulmini

Polskie tłumaczenie dokumentacji: Łukasz Fidosz

Ta dokumentacja jest rozprowadzana na zasadach Licencji GNU Free Documentation License.

Ten program jest rozprowadzany na zasadach Licencji GNU General Public License.

Poprzedni
Następny
Spis treści


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

Dodatek A. Instalacja
Instalacja
Poprzedni
Następny

Dodatek A. Instalacja

Jak zainstalować KFileReplace

KFileReplace jest aktualnie częścią pakietu kdewebdev, więc żeby go zainstalować musisz zdobyć kopię kdewebdev. Jednak jeśli używasz pakietuKDE dostarczonego przez dostawcę Twojego systemu operacyjnego, prawdopodobnie już posiadasz zainstalowane kdewebdev; w tym przypadku możesz używać KFileReplace albo przez uruchomienie edytora stron WWW Quanta Plus, albo przez jego bezpośrednie uruchomienie (jeśli nie masz starej wersji KDE). W przeciwnym wypadku możesz pobrać pakiet kdewebdev z internetu: odwiedź stronę domową projektu kdewebdev , aby uzyskać więcej informacji.

Wymagania
Wymagania

Wymagania

Aby używać polecenia [$mathexp:jakieś_wyrażenie_matematyczne$] trzeba zainstalować narzędzie matematyczne bc (wersja 1.06 lub nowsza) napisane przez Philipa A. Nelsona ().



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

Poprzedni
Następny
Spis treści


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

Dodatek B. Polecenia w KFileReplace
Polecenia w KFileReplace
Poprzedni

Dodatek B. Polecenia w KFileReplace

[$datetime:iso$]: to polecenie zwraca aktualną datę i czas w formacie Qt ISO.
[$datetime:local$]: jak wyżej, ale w lokalnym formacie.
[$user:uid$]: zwraca identyfikator użytkownika (UID) aktualnego użytkownika.
[$user:gid$]: zwraca identyfikator grupy (GID) aktualnego użytkownika.
[$user:loginname$]: zwraca nazwę aktualnego użytkownika.
[$user:fullname$]: zwraca pełną nazwę aktualnego użytkownika.
[$user:homedir$]: zwraca katalog domowy aktualnego użytkownika.
[$user:shell$]: zwraca powłokę aktualnego użytkownika.
[$loadfile:/moja-ścieżka/mój-katalog/mój-plik$]: zwraca zawartość mój-plik.
[$empty:$]: zwraca pusty ciąg.
[$random:LICZBA$]: zwraca losowy ciąg liczbowy używająć LICZBA jako ziarna inicjującego.
[$random:$]: jak wyżej, ale bez ziarna inicjującego.
[$mathexp:wyrażenie-bc$]: zwraca wynik wyrażenia matematycznego programu bc v1.06.

Poprzedni
Spis treści


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

Następny
 


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