<para>&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. </para>
<para>Ten przycisk otwiera <link linkend="tdefilereplace-the-project-dialog">okno sesji</link> 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.</para>
<para>Ten przycisk otwiera okno <link linkend="tdefilereplace-the-add-dialog">Dodawania ciągów</link>, w którym możesz edytować swoją listę ciągów.</para>
<para>Ten przycisk wczytuje <link linkend="tdefilereplace-the-kfr-file">lisŧę ciągów</link> zapisaną w pliku xml z rozszerzeniem <literal role="extension">kfr</literal>.</para>
<para>Widok <guilabel>Wyniki</guilabel> 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.</para>
<para>Widok <guilabel>Ciągi</guilabel> ukazuje listę ciągów, które chcesz znaleźć/zamienić. Proszę zauważyć, że w trybie wyszukiwania widok <guilabel>Wyniki</guilabel> i widok <guilabel>Ciągi</guilabel> mają inny układ.</para>
<para>Okno <guilabel>Nowa sesja</guilabel> jest używane do skonfigurowania podstawowych parametrów wymaganych przez &tdefilereplace; do pracy. Składa się z dwóch zakładek, <guilabel>Ogólne</guilabel> i <guilabel>Zaawansowane</guilabel>. </para>
<para>Kiedy chcesz rozpocząć nową sesję pierwszym krokiem jest kliknięcie na przycisk <link linkend="tdefilereplace-the-toolbar"><guiicon>Nowa sesja</guiicon> </link>. 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.</para>
<para>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<footnote id="performancewarning"><para>Proszę zwrócić uwagę, że wyrażenia regularne i polecenia mogą zmniejszyć szybkość wykonywania.</para></footnote>, tworzenie kopii zapasowych plików przed zamianą.</para>
<para>Jeśli chcesz rozpocząć wyszukiwanie, wpisz ciąg w pole wyszukiwania i naciśnij przycisk <guibutton>Znajdź teraz</guibutton>. W przeciwnym wypadku pozostaw pole wyszukiwania puste i naciśnij <guibutton>Znajdź później</guibutton>.</para>
<para>Karta <guilabel>Zaawansowane</guilabel> 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).</para>
<para>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 <menuchoice><guimenu>Ustawienia</guimenu><guimenuitem>Konfiguracja KFileReplace...</guimenuitem></menuchoice>w menu głównym. </para>
<seg>pokazuje tylko pliki, które pasują do któregoś z Twoich ciągów. Zwiększa to szybkość wyszukiwania.</seg>
<seg>&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.</seg>
<seg>jeśli plik jest dowiązaniem do innego pliku, wyszukiwanie będzie sie odbywało na wskazywanym przez dowiązanie pliku.</seg>
<seg>jeśli ukryte pliki lub katalogi zostaną napotkane, ignoruje je.</seg>
<para>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 <guibutton>OK</guibutton>.</para>
<para>Jeśli chcesz użyć ponownie listę ciągów możesz zapisać ją w pliku <literal role="extension">xml</literal>. Aby to zrobić wybierz z menu <menuchoice><guimenu>Znajdź/Zamień</guimenu><guisubmenu>Ciągi</guisubmenu><guimenuitem>Zapisz listę ciągów do pliku</guimenuitem></menuchoice>. Kiedy zapiszesz listę zostanie utworzony prosty plik <literal role="extension">xml</literal> z rozszerzeniem <literal role="extension">kfr</literal>. Aby wczytać plik <literal role="extension">kfr</literal> wybierz z menu <menuchoice><guimenu>Znajdź/Zamień</guimenu><guisubmenu>Ciągi</guisubmenu><guimenuitem>Wczytaj listę ciągów z pliku</guimenuitem></menuchoice>. Sam plik wygląda następująco:</para>
<para>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.</para>
<para>Raport możesz stworzyć wybierając z głównego menu <menuchoice><guimenu>Znajdź/zamień</guimenu><guisubmenu>Wyniki</guisubmenu><guimenuitem>Utwórz plik z raportem</guimenuitem></menuchoice>. Raport jest katalogiem zawierającym pliki <literal role="extension">xml</literal> i <literal role="extension">css</literal>. Raporty mogą być użyteczne przy prowadzeniu prostych dzienników Twoich działań. <screenshot>
<screeninfo>Funkcja raportów w &tdefilereplace;'</screeninfo>
<para>Jeśli chcesz odnaleźć każdy ciąg zaczynający się na <quote>x</quote>, <quote>ht</quote> lub <quote>u</quote> i kończący się na <quote>ml</quote>, możesz napisać wyrażenie regularne podobne do tego: <userinput>(x|ht|u)ml</userinput>. Wstaw to wyrażenie do pola wyszukiwania, kliknij <guibutton>OK</guibutton> i włącz wyrażenia regularne przez przełączenie przycisku <link linkend="tdefilereplace-the-toolbar"><guibutton>Wyrażenia regularne</guibutton></link>. 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 <quote>jeśli chcesz rozwiązać problem za pomocą wyrażenia regularnego, to masz dwa problemy</quote>.</para>
<para>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.</para>
<para>Załóżmy, że chcesz zamienić wyrażenie <quote>Alice's adventures in Wonderland</quote> na <ulink url="http://www.textlibrary.com/download/alice-wo.txt">cały tekst opowiadania Carrolla</ulink>. Prawdopodobnie nie chcesz robić tego ręcznie, potrzebujesz polecenia, które zrobi to za Ciebie. Kliknij przycisk <link linkend="tdefilereplace-the-toolbar"><guiicon>Dodaj</guiicon></link>, wybierz <guilabel>Tryb wyszukiwania i zamiany</guilabel> i wpisz następujące ciągi: <userinput>Alice's adventure in Wonderland</userinput> w polu znajdowania i ciąg <userinput>[$loadfile:<replaceable>/ścieżka-do-mojego-folderu/mój-folder/mój-plik</replaceable>$]</userinput> w polu zamiany. Kliknij <guibutton>OK</guibutton> . Kiedy powrócisz do głównego okna &tdefilereplace;, przełącz przycisk<link linkend="tdefilereplace-the-toolbar">Polecenia</link> tak, żeby polecenia były włączone, i rozpocznij proces zamieniania. Istnieje więcej poleceń, zobacz <xref linkend="available-commands"/>, aby zapoznać się z listą pozostałych.</para>
<para>&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ź <ulink url="http://kdewebdev.org"> stronę domową projektu &tdewebdev; </ulink>, aby uzyskać więcej informacji. </para>
<para>Aby używać polecenia <link linkend="available-commands">[$mathexp:<replaceable>jakieś_wyrażenie_matematyczne</replaceable>$]</link> trzeba zainstalować narzędzie matematyczne &bc; (wersja 1.06 lub nowsza) napisane przez Philipa A. Nelsona (<email>philnelson@acm.org</email>).</para>