KFileReplace"> tdewebdev"> bc"> ]> Podręcznik &kfilereplace; Emiliano Gulmini
emi_barbarossa@yahoo.it
ŁukaszFidosz
virhilo@gmail.com
Polskie tłumaczenie dokumentacji
2004 Emiliano Gulmini &FDLNotice; 2004-08-09 1.0.0 &kfilereplace; jest narzędziem do wyszukiwania i zamiany ciągów znaków. KDE KFileReplace zamień znajdź ciąg
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. Używanie &kfilereplace; &kfilereplace; we własnym cieleniu &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 &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 . Wyrażenia regularne Ten przycisk włącza wyrażenia regularne w stylu Qt. Lista wyników Widok wyników w &kfilereplace; 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. Lista ciągów To jest widok Ciągi: Widok ciągów w &kfilereplace; 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. Okno <guilabel >Nowa sesja</guilabel > 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 <guilabel >Ogólne</guilabel > Karta ogólnych ustawień &kfilereplace; 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ń regularnychProszę 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 <guilabel >Zaawansowane</guilabel > Karta Zaawansowane w &kfilereplace; 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). Okno <guilabel >Opcje</guilabel > 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 UstawieniaKonfiguracja 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. &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. 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 <guilabel >Dodaj ciągi</guilabel > Okno Dodaj ciągi w &kfilereplace; 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. 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ągiZapisz 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ągiWczytaj 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 Raport możesz stworzyć wybierając z głównego menu Znajdź/zamieńWynikiUtwó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;' Funkcja raportów w &kfilereplace;' 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 &kfilereplace; 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 &kfilereplace;, przełącz przyciskPolecenia tak, żeby polecenia były włączone, i rozpocznij proces zamieniania. Istnieje więcej poleceń, zobacz , 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 &kfilereplace;: 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ć &kfilereplace; &kfilereplace; 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ć &kfilereplace; 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 &kfilereplace; [$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;