Pomoc:AutoWikiBrowser

Automatyzacja i boty

Ten poradnik przeprowadzi Cię przez proces używania programu AutoWikiBrowser (AWB) do wykonywania półautomatycznych edycji — na przykładzie masowej podmiany słowa na wielu stronach wiki Fandubbing. Choć technicznie AWB nie jest typowym botem, często opisuje się go w ten sposób.

Bardziej szczegółowy podręcznik użytkownika znajdziesz na Wikipedii.

Krok 1: Utwórz konto bota

Uwaga: jeśli masz już konto bota, pomiń ten krok.

Możesz uruchamiać AWB na swoim głównym koncie, ale jeśli planujesz wykonywać większe serie edycji, warto utworzyć osobne konto bota, aby odseparować edycje automatyczne.

Kilka wskazówek dotyczących konta bota:

• Większość nazw kont botów zawiera słowo „bot”, aby jasno wskazywać ich przeznaczenie.
• Na stronie użytkownika konta bota należy podać, kto jest właścicielem konta i wspomnieć, że jest to bot. Więcej informacji znajdziesz tutaj.
• Jeśli planujesz wprowadzić wiele zmian lub bot ma służyć na dłuższy okres czasu rozważ omówienie ze swoją społecznością, czy konto powinno zostać oznaczone jako bot flagi bota. Dzięki temu zmiany bota zostaną domyślnie ukryte na stronie ostatnich zmian.
• Jeśli społeczność się zgodzi, skontaktuj się z Fandomem i poproś o nadanie flagi — koniecznie podając link do publicznej dyskusji oraz nazwę konta bota.

Krok 2: Pobierz program

Pobierz najnowszą wersję AutoWikiBrowser z tej strony i następnie wypakuj ją gdzie chcesz np. na pulpit.

Podstawowa obsługa programu wygląda tak:

1. Uruchom AutoWikiBrowser.
2. Zaloguj się na konto bota.
3. Określ, które strony mają być edytowane.
4. Wskaż, co bot ma zrobić.

Pamiętaj, że AWB można uruchomić w trybie w pełni automatycznym lub półautomatycznym. W trybie półautomatycznym każdą edycję musisz zatwierdzić ręcznie — co znacząco zmniejsza ryzyko błędów przy masowych zmianach.

Krok 3: Naucz się obsługi programu

W tym przykładzie przygotujemy bota tak, aby poprawiał błędnie wpisane imię artysty na wielu stronach wiki.

Wybór wiki

1. Uruchom AutoWikiBrowser.
2. Przejdź do Options → Preferences → Site.
3. Z listy wybierz projekt "custom".
4. *Możesz także wybrać "Fandom" i wpisać pierwszy człon adresu (np. "fandubbing" dla "fandubbing.fandom.com"), ale działa to tylko dla anglojęzycznych wiki.
5. Wybierz "https://" zamiast "http://".
6. *Nawet jeśli ustawisz HTTP, AWB często poprawi to automatycznie po kolejnym kroku — ale nie zawsze, zależnie od wersji programu.
7. W polu tekstowym wpisz domenę wiki (np. help.fandom.com) **bez** „https://”.
8. Po zakończeniu kliknij „OK”, aby zapisać ustawienia.

Program może zawiesić się na kilka sekund. Po chwili na dolnym pasku zobaczysz, że AWB połączył się z wybraną wiki:

Logowanie

Gdy wiki jest już wybrana, musisz zalogować się na konto bota.

1. Przejdź do File → Log in/Profiles....
2. Wpisz nazwę użytkownika oraz hasło bota.
   • Logowanie wymaga podania nazwy bota i specjalnie wygenerowanego hasła
   • Nazwa użytkownika powinna mieć format: Konto@NazwaHasłaBota.

     Przykład: Jeśli Twoje konto to Edward-bot, a nazwę hasła ustawiłeś jako AWB, to pełna nazwa użytkownika bota będzie wyglądała tak: Edward-bot@AWB.

   • Hasło to ciąg liter i cyfr wygenerowany przez system, np. g5kc62j26875malmr06dpj0m4tjjp3ej.
3. Jeśli korzystasz z bezpiecznego komputera, zaznacz opcję „Save Password”, aby nie wpisywać danych ponownie.
4. Kliknij „Login”.

Dolny pasek programu powinien teraz pokazywać pełne zalogowanie:

Bot jest teraz gotowy do pracy.

Uwaga: Niektóre wiki korzystają ze specjalnej listy kontrolnej, która może ograniczać działanie AWB do wybranych użytkowników lub blokować edycje automatyczne.

Ustawianie opcji edycji

W przykładzie będziemy poprawiać źle wpisane nazwisko artysty.

Najpierw musimy przygotować listę stron do edycji. AutoWikiBrowser oferuje wiele różnych generatorów list do użycia.

W panelu „Make List” przejrzyj menu „Source” i wybierz odpowiednią opcję. Jeśli wszystkie strony, które Cię interesują, należą do tej samej kategorii, użyj opcji „Category”. Jeśli chcesz znaleźć strony używające konkretnego szablonu — wybierz „What transcludes page (all NS)”.

Wskazówka:

Jeśli chcesz zrobić listę wszystkich stron z głównej przestrzeni nazw:

• w panelu „Make List” wybierz źródło „Special Page”,
• kliknij „Make List”,
• wybierz „All Pages”,
• ustaw przestrzeń nazw na „Main:”
• kliknij „OK”.

Gdy mamy wygenerowaną listę stron do sprawdzenia, trzeba powiedzieć botowi, co ma zrobić. Obok panelu „Make list” znajduje się sekcja głównych ustawień edycji.

Aby poprawić nazwisko, skorzystamy z funkcji „Find and replace”. Zaznacz odpowiednie pole, kliknij „Normal settings”, wpisz błędną wersję nazwy w polu „Find”, a poprawną w „Replace with”. Pozostałe opcje w tym przykładzie mogą pozostać domyślne.

Zamknij okno przyciskiem „OK”.

Wskazówka: Jeśli nie wiesz, co robi dana opcja, zajrzyj do podręcznika AWB.

Rozpoczynanie edycji

Kiedy jesteś pewien, że wszystko jest gotowe:

1. Przejdź do zakładki „Start”.
2. Wpisz „Default Summary” — główny opis edycji, który pojawi się w podsumowaniu każdej zapisanej zmiany.
3. Kliknij „Start”.

Program zacznie przeglądać listę stron. Gdy wykryje tekst do zmiany, zastosuje wybrane ustawienia i pokaże podgląd zmian.

Jeśli wynik nie wygląda tak, jak oczekujesz, możesz ręcznie poprawić treść w panelu edycji po prawej stronie.

Po sprawdzeniu:

• kliknij „Save”, aby zapisać zmiany,
• kliknij „Skip”, jeśli strona nie wymaga edycji.

Wskazówka: W zakładce „Skip” zaznacz opcję „Skip if no changes are made”.

AWB automatycznie pominie wtedy strony, które nie wymagają zmian.

Automatyczne zapisywanie edycji

Powyższy przykład pokazuje tryb półautomatyczny — szybki i bezpieczny, ponieważ każdą zmianę akceptujesz samodzielnie.

Jeśli jednak chcesz, aby AWB edytował w pełni automatycznie:

• przejdź do zakładki „Bots”,
• zaznacz „Auto save”.

Od teraz AWB będzie zapisywał każdą zmianę bez pytania o potwierdzenie.

Uwaga: Używaj tego trybu ostrożnie. Zdecydowanie zalecamy wykonanie kilku edycji testowych w trybie półautomatycznym, aby upewnić się, że wszystko działa poprawnie.

Find-Replace

Poniżej omówimy krok po kroku najprostszy typ edycji w AWB: znajdź słowo/zdanie i zamień je na inne.

1. Najpierw przygotuj listę stron, które chcesz edytować. Może to być lista z kategorii, „What links here” lub dowolna inna dostępna opcja.
   • Możesz także porównać dwie listy stron, korzystając z narzędzia „List comparer” w zakładce "Tools".
2. Gdy masz już listę, przejdź do zakładki „Options”, a potem kliknij „Find and replace”.
3. Zaznacz pole aktywujące funkcję po lewej stronie, następnie wybierz „Advanced settings”. Jeśli przeprowadzasz prostą korektę literówki — wpisz szukany tekst u góry, a tekst zamienny poniżej.
   • AWB obsługuje też bardziej zaawansowane operacje za pomocą wyrażeń regularnych (regex). Są one przydatne, jeśli chcesz dopasować podobne, ale nie identyczne wzorce tekstu.

Zakładka „Options”

Find-replace (bez regex)

Find-replace (z regex)

List comparer (porównywanie list)

Pamiętaj, że find-replace wykonuje się przed operacją append. Dlatego jeśli chcesz dopisać kategorię, ale niektóre strony już ją mają — najpierw ustaw find-replace, który usuwa kategorię, a dopiero potem dodawaj ją ponownie.

Blank editing w AWB

AWB świetnie nadaje się też do automatycznego wykonywania „pustych edycji” (null edits), czyli zapisów bez zmian treści. Null edity odświeżają cache wiki oraz aktualizują różne tabele danych, jeśli wiki używa rozszerzeń, takich jak Cargo.

Aby wykonać null edity:

• przejdź do Options → „Apply changes automatically”
• odznacz tę opcję.

Rozwiązywanie problemów

Poniżej opisano najczęstsze problemy, jakie mogą wystąpić podczas korzystania z AWB — wraz z ich możliwymi przyczynami.

Problemy z instalacją

• AWB uruchamia się bezpośrednio z folderu, w którym go rozpakowałeś — nie pojawi się w menu Start.
• AWB działa tylko na systemie Windows.
• W niektórych przypadkach konieczne jest uruchomienie programu jako administrator (prawy przycisk → „Run as administrator”).

Problemy z logowaniem

• Czy Twoje konto bota odwiedziło wiki w przeglądarce? Jeśli nie — system może nie rozpoznawać go jako istniejącego jeszcze użytkownika.
• Czy używasz danych wygenerowanych na Special:BotPasswords?

  Jest to wymagane do logowania w narzędziach zewnętrznych, takich jak AWB.

• Czy nazwa użytkownika ma poprawny format?

  TwojaNazwa@NazwaHasłaBota

• Czy na pewno używasz HTTPS zamiast HTTP?
• Czy logujesz się do właściwej wiki?
• Czy wcześniej próbowałeś logować się błędnymi danymi?

  Jeśli korzystasz z „quick login”, upewnij się, że usunąłeś niepoprawne zestawy danych oraz że klikasz właściwy przycisk logowania.

Problemy z wyborem stron

• Czy wybrałeś wersję „all namespaces” danego generatora list? Jeśli nie — AWB będzie przeszukiwać tylko główną przestrzeń nazw.

Problemy z zapisywaniem stron

• Czy „Apply Changes Automatically” w zakładce Options jest zaznaczone? Jeśli nie — AWB będzie robić null edity zamiast zapisywać zmiany.
• Czy jesteś zalogowany na właściwej wiki?
• W przypadku find-replace — czy reguły są włączone (checkbox obok nazwy)?
• Czy masz włączone „Follow redirects”, kiedy nie powinieneś? (lub odwrotnie)
• Czy strony, które próbujesz edytować, są zabezpieczone?

  Jeśli tak — czy bot ma odpowiednie pozwolenia w Special:BotPasswords?

  Pamiętaj, że ochrona kaskadowa to *inne* uprawnienie niż zwykła ochrona. Czasem konieczne jest tymczasowe wyłączenie ochrony kaskadowej na stronie głównej.

Problemy z wyrażeniami regularnymi

• Czy zaznaczyłeś opcję „Regular expression”?
• Czy poprawnie używasz trybów Singleline (kropka dopasowuje znaki nowych linii) oraz Multiline (^ i $ dopasowują początek/koniec linii zamiast całej strony)?
• Czy przetestowałeś swoje regexy (np. w oknie „Test...”)?
• Czy przypadkiem nie masz ustawionego warunku „If” w regule, choć nie powinieneś?
• Czy poprawnie „uciekłeś” znaki specjalne, takie jak |, ?, {} itd.?

Problemy specyficzne dla Fandomu

• Czy Twój bot znajduje się na liście Project:AutoWikiBrowser/CheckPage?
• Czy używasz VPN?

  Jeśli tak — spróbuj zmienić serwer lub wyłączyć VPN, ponieważ niektóre połączenia mogą być blokowane.

Zobacz także

• Pełny podręcznik użytkownika na Wikipedii
• Bardziej zaawansowane operacje find-and-replace można wykonać za pomocą wyrażeń regularnych:
  • https://regexr.com/ — narzędzie do testowania regexów wraz z praktycznymi podpowiedziami i ściągawką.
  • https://regex101.com/ — podobne narzędzie, również z podglądem działania regexów.
  • https://www.regular-expressions.info/ — techniczne, bardzo szczegółowe omówienie regexów; przydatne jako uzupełnienie, choć napisane dość trudnym językiem.

Dalsze wsparcie

Szukasz dalszego wsparcia lub masz pytanie? Sprawdź poniższe linki, aby dowiedzieć się więcej.

• Dowiedz się więcej, sprawdzając inne strony pomocy.
• Uzyskaj pomoc od innych użytkowników Fandomu w Dyskusjach na Centrum Społeczności.
• Skontaktuj się ze wsparciem Fandomu poprzez formularz kontaktowy.