Wstępik
ReplaceEm (Windows) to darmowy program do zamiany tekstu w wielu plikach (autorstwa Custom Fit Software [ang]). Jest przydatny przy pracy nad stroną www, na przykład gdy chcemy zamienić we wszystkich plikach adres e-mailowy na inny. W odróżnieniu jednak od innych dostępnych w Sieci programów ReplaceEm pozwala wprowadzić zmiany znacznie bardziej skomplikowane - np. we wszystkich plikach po <BODY> dodać <H1> o treści takiej, jak <TITLE> danego pliku. Program nie ma niestety (przynajmniej w wersji 2.0) polskiej wersji językowej. W związku z tym postanowiłem napisać krótką instrukcję, która - mam nadzieję - ułatwi komuś skorzystanie z programu. Na wszelki wypadek jednak eksperymentowanie z zamianami w plikach zacznijcie od.. zrobienia ich kopii zapasowej ;-)
Ważne odsyłacze: pobierz ReplaceEm [ang], zapoznaj się z pełniejszym i bardziej fachowym opisem programu [pl] (autorstwa Macieja Romaniaka).
Początek
Po pierwszym uruchomieniu programu tworzymy nową 'grupę' (Add Replace Group), a następnie dodajemy do niej pliki (prawy przycisk myszy na nowej grupie » pojawia się menu kontekstowe » Add File(s)). W tym przykładzie chcemy, aby zamiany były dokonywane we wszystkich plikach naszej strony www, czyli we wszystkich plikach html (include file filter: *.html) katalogu D:\Moje dokumenty\www, łącznie z podkatalogami (zaznaczona opcja Include files in all subfolders)
Przy okazji dodawania plików możemy od razu określić sposób tworzenia kopii zapasowych plików przy zamianie. Mogą one nie być tworzone wcale (odznaczona opcja enable file backup). Jeśli jednak chcemy mieć możliwość powrotu do wersji sprzed zamiany, to możemy stworzyć kopie zapasowe 'obok' plików ze zmianami. Poniżej dwa przykłady: w pierwszym każdemu zmienionemu plikowi będzie towarzyszył stary plik z dodanym rozszerzeniem 'kopia' (np. przy zamianie treści pliku o nazwie index.html stara wersja zostanie zapisana w tym samym katalogu jako index.html.kopia). W sytuacji przedstawionej na drugim obrazku 'stare' wersje wszystkich plików znajdą się w sąsiednim katalogu (D:\Moje dokumenty\kopia zapasowa)
W końcu zaczynamy wpisywać tekst do zamiany (Original text) i ten właściwy (Replacement text). Powiedzmy, że chcemy poprawić często przytrafiającą się literówkę (storna » strona) oraz zamienić wszędzie nasz stary adres e-mailowy na nowy, aktualny. Po wpisaniu wszystkiego w końcu klikamy start replacing i już po chwili obserwujemy efekty.
Troszkę więcej
Zamiana jednego wyrazu na inny jest, jak widać, bardzo prosta. Zdarza się jednak, że chcemy wymienić fragment tekstu składający się z kilku linijek. Jak go wpisać? Możemy zastąpić każdy znak nowej linii (Enter) tajemniczym oznaczeniem {}e, nie jest to jednak zbyt wygodne:
Prościej jednak będzie wejść w 'zaawansowaną edycję' (prawy przycisk myszy nad polem, w które wpisuje się tekst do zamiany » Advanced edit). W tym trybie znaki nowej linii czy tabulatory wpisuje się 'normalnie'.
W opcjach możemy wybrać sposób, w jaki program traktuje wpisywane przez nas teksty do zamiany. W najprostszym przypadku jest to 'Case Insensitive', czyli wyszukiwanie i zamiana podanego przez nas tekstu bez zwracania uwagi na wielkość liter (w pierwszym przykładzie zamieniona zostanie zarówno 'storna', jak i 'Storna'). Jeśli nam to nie odpowiada, możemy kazać programowi zwracać uwagę na wielkość liter (opcja 'Case Sensitive'):
Jeśli zamieniamy jednocześnie wiele tekstów, możemy dla każdego z nich ustawić tę opcję oddzielnie w oknie 'zaawansowanej edycji' (Advanced edit) lub - mniej wygodnie - w zwykłej edycji wpisując na początku tekstu {}s lub {}i.
Wyrażenia regularne
Oprócz prostych trybów zamiany mamy do dyspozycji także tzw. wyrażenia regularne (Regular Expression). Są one szczególnie przydatne, gdy wyszukiwany tekst może występować w wielu wariantach. Definiując wyszukiwany, przeznaczony do zamiany tekst (Original text) możemy użyć m.in. następujących wyrażeń regularnych:
- . kropka zastępuje dowolny znak, np. a, b, 5. Zatem jeśli wpiszemy stron. i użyjemy Regular Expression Search, zamienione zostaną wyrazy strona, strony, stroni, ale i stron! czy stron1
- + plus po wyrażeniu oznacza jedno lub więcej
powtórzeń tego wyrażenia, np. b+ wyszuka nam b, bb, bbb. Z kolei h(a+) wyszuka
nam ha, haa czy haaaaaa, a (h(a)+)+ - ha, haha, haahaa, hahaaaahaa (zwróćmy
uwagę na nawiasy)
- * gwiazdka po wyrażeniu oznacza brak lub dowolną
liczbę powtórzeń tego wyrażenia. h(a*) wyszuka nam
ha i haa, ale też samo
h
- ? znak zapytania po wyrażeniu oznacza brak lub
jedno wyrażenie. Na przykład wyrażenie (c?)hamak
znajdzie nam hamak i chamak (i w obu przypadkach zamieni np. na
'łóżko wiszące')
- kropka zastępuje dowolny pojedynczy znak, zatem (.+) zastępuje wiele dowolnych znaków. Oznacza to, że <TITLE>(.+)</TITLE> wyszuka wszystkie tytuły stron (np. <TITLE>Tytuł</TITLE> czy <TITLE>Moja strona domowa</TITLE>)
- [] nawias kwadratowy oznacza zakres, [abc] to dowolny ze znaków a, b lub c. Zatem stron[ay] znajdzie nam wyrazy strona i strony, ale już nie stroni
- zakresy z 'kreską': [0123456789] można zapisać jako [0-9], zatem [0-9]+ to dowolna liczba (ciąg składający się z jednej lub więcej cyfr)
- ^ - 'daszek' przed zakresem oznacza 'nie z tego zakresu', zatem [^0-9] oznacza dowolny znak nie będący cyfrą
- | pionowa kreska oznacza "lub". Zatem Adam|Bartek|Czarek|Darek wyszuka nam każde z wymienionych imion (i zamieni wszystkie np. na 'kolega ze studiów')
Z kolei przy definiowaniu tekstu docelowego (Replacement text) znak & czyli 'and' oznacza cały znaleziony tekst. Załóżmy, że jako tekst do zamiany (Original text) wpisaliśmy Adam|Bartek|Czarek|Darek - znaleziona zostanie zatem każde z wymienionych imion. Z kolei jako tekst docelowy (Replacement text) wpisujemy <B>&</B>. Efekt - każde z wymienionych imion zostanie znalezione i 'obłożone' znacznikami <B>, czyli - w kodzie HTML - pogrubione.
I ostatnie przykłady, cały czas oczywiście w trybie Regular Expression Search. W tekście wyszukiwanym zastosujemy kilka wyrażeń (.+), czyli wyszukane zostanie kilka fragmentów tekstu. Nie wiemy co w nich jest, mimo to możemy je wykorzystać w tekście docelowym stosując odpowiednie oznaczenia:
- Tekst wyszukiwany:
<TITLE>(.+)</TITLE>(.+)<BODY> . Tekst docelowy<TITLE>\1</TITLE>\2<BODY> . W miejsce \1 wchodzi fragment znaleziony przez pierwsze (.+), pod \2 podstawiony zostaje fragment znaleziony przez drugie (.+). Czyli w tekście nie zmienia się nic! - Tekst wyszukiwany:
<TITLE>(.+)</TITLE>(.+)<BODY> . Tekst docelowy<TITLE>\1</TITLE>\2<BODY><H1>\1</H1> . Bezpośrednio po tagu <BODY> dodany zostaje nagłówek pierwszego poziomu o treści takiej samej, jak tytuł strony - Tekst wyszukiwany:
<TITLE>(.+)</TITLE>(.+)<H1>(.+)</H1> . Tekst docelowy:<TITLE>\3</TITLE>\2<H1>\1</H1> . Jako jedyny efekt uzyskujemy zamianę tytułu strony z treścią pierwszego nagłówka pierwszego poziomu. 'Cokolwiek' znajdujące się między tytułem a nagłówkiem pozostaje na swoim miejscu.
Bardzo ważna uwaga: wyrażenie regularne typu
Dla przypomnienia: pobierz ReplaceEm [ang], zapoznaj się z pełniejszym i bardziej fachowym opisem programu [pl] (autorstwa Macieja Romaniaka) TU lub tutaj