# Podręcznik &tdefilereplace;

## Wprowadzenie

&tdefilereplace; 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.

## Używanie &tdefilereplace;

&tdefilereplace; we własnym cieleniu &tdefilereplace; we własnym cieleniu

### Pasek narzędzi

Pasek narzędzi &tdefilereplace; powinien wyglądać tak jak poniżej: Pasek narzędzi &tdefilereplace; Pasek narzędzi &tdefilereplace;

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 &tdefilereplace; 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, &tdefilereplace; 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 tdefilereplace-commands.

Wyrażenia regularne

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

### Lista wyników

Widok wyników w &tdefilereplace; Widok wyników w &tdefilereplace;

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.

### Lista ciągów

To jest widok Ciągi: Widok ciągów w &tdefilereplace; Widok ciągów w &tdefilereplace;

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.

### Okno Nowa sesja

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

#### Karta Ogólne

Karta ogólnych ustawień &tdefilereplace; 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

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

, 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 &tdefilereplace; Karta Zaawansowane w &tdefilereplace;

Karta Zaawansowane pozwoli Ci ustawić kilka użytecznych opcji zawężających wyszukiwanie do podzbioru Twojego docelowego drzewa plików. Jeśli chcesz uruchomić &tdefilereplace; 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).

### 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 Karta Ogólne okna Opcje

#### Zaawansowane opcje

Karta zaawansowane okna Opcje Karta zaawansowane okna Opcje

Nie pokazuj plików jeśli żaden ciąg nie został znaleziony lub zamieniony Podczas wyszukiwania, zatrzymaj sie na pierwszym znalezionym ciągu Podążaj za dowiązaniami symbolicznymi Ignoruj ukryte pliki i katalogi
- pokazuje tylko pliki, które pasują do któregoś z Twoich ciągów. Zwiększa to szybkość wyszukiwania. &tdefilereplace; 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. jeśli plik jest dowiązaniem do innego pliku, wyszukiwanie będzie sie odbywało na wskazywanym przez dowiązanie pliku. jeśli ukryte pliki lub katalogi zostaną napotkane, ignoruje je.

### Okno Dodaj ciągi

Okno Dodaj ciągi w &tdefilereplace; Okno Dodaj ciągi w &tdefilereplace;

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.

## Funkcje &tdefilereplace;

Ten rozdział zawiera informacje o kilku użytecznych możliwościach &tdefilereplace;.

### 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 &tdefilereplace; tak jak zostało to wcześniej wyjaśnione.

### 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 &tdefilereplace;' Funkcja raportów w &tdefilereplace;'

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

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

### 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 &tdefilereplace; wbudowane w &quantaplus;, możesz otworzyć plik w tym programie od razu na określonym wierszu i kolumnie.

### 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 &tdefilereplace;, przełącz przyciskPolecenia tak, żeby polecenia były włączone, i rozpocznij proces zamieniania. Istnieje więcej poleceń, zobacz available-commands, aby zapoznać się z listą pozostałych.

## Zasługi i licencje

Prawa autorskie do programu: copyright 1999 François Dupoux dupoux@dupoux.com, 2003 Andras Mantia amantia@kde.org, 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

## Autorzy i opiekunowie &tdefilereplace;:

François Dupoux dupoux@dupoux.com

- Pierwotny autor

Andras Mantia amantia@kde.org

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

Emiliano Gulmini emi_barbarossa@yahoo.it

- Bieżący opiekun, czyszczenie i przepisywanie kodu

Prawa autorskie do dokumentacji: © 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

Polskie tłumaczenie dokumentacji: Łukasz Fidoszvirhilo@gmail.com

&underFDL; &underGPL;

## Instalacja

### Jak zainstalować &tdefilereplace;

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

### 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 (philnelson@acm.org).

## Polecenia w &tdefilereplace;

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

&documentation.index;