Podręcznik:Pywikibot/Instalacja
Poniżej znajduje się instrukcja, która pomoże Ci skonfigurować i uruchomić Pywikibota na swoim komputerze. Ten proces składa się z czterech kroków:
Instalowanie Pythona
Pobieranie i instalowanie Pythona z https://www.python.org/downloads/.
Jeśli masz już zainstalowany Python, sprawdź, czy Twoja wersja jest wystarczająco aktualna, uruchamiając python --version w konsoli.
Dla sprawdzenia, czy zainstalowany jest język Python w wer. 3 lub nowszej, uruchom w konsoli python3 --version.
Ubuntu 19.04 i nowsze są dostarczane z zainstalowanymi wersjami 2 i 3.
Python v2 działa domyślnie przy użyciu polecenia terminala python; aby użyć wer. 3, użyj polecenia terminala python3.
Python 3.7 lub nowszy jest wymagany do uruchomienia bota. W systemie Windows nie zapomnij zmodyfikować zmiennej środowiskowej PATH, dla poprawnego działania Python'a i pip.
Instalowanie zależności
Do uruchomienia Pywikibota wymagane są dodatkowe pakiety Uruchom następujące polecenie, aby zainstalować te pakiety:
$ python -m pip install "requests>=2.20.1"
$ python -m pip install "mwparserfromhell>=0.5.2"
$ python -m pip install packaging
W przypadku Pythona 3.7 wymagany jest dodatkowy pakiet. Zainstaluj za pomocą:
$ python -m pip install importlib_metadata
Alternatywny analizator znaczników MediaWiki może zostać zainstalowany z:
$ python -m pip install "wikitextparser>=0.47.5"
See also https://doc.wikimedia.org/pywikibot/stable/introduction.html#quick-start
Instalowanie Pywikibota
$ python -m pip install pywikibot
Jeśli używasz pip, użyj pwb zamiast python pwb.py w poniższych przykładach.
Pobierz aktualnego Pywikibot stable: .tar.gz, .zip.
Rozpakować pobrane pliki, na przykład w ~/pywikibot lub %USERPROFILE%\pywikibot.
Alternatywnie, można odzyskać najnowszą wersję za pomocą klienta git lub svn z Gerrit, patrz Manual:Pywikibot/Gerrit#For users. Jest to zalecany sposób korzystania z Pywikibota przez aktywnych operatorów botów i programistów.
Inne wersje są dostępne tu: https://pywikibot.toolforge.org/.
Aktualizowanie Pywikibota
Dbaj by boty były aktualizowane na bieżąco. Nowe wersje są wydawane w sposób ciągły i są dostępne w tym samym miejscu.
Jeśli używasz wydania git lub svn, możesz pominąć tę uwagę. W przeciwnym razie pamiętaj o konieczności utworzenia kopii zapasowej plików konfiguracyjnych i skryptów (user-config.py, dowolnego pliku rodziny lub niestandardowego skryptu, który mogłeś utworzyć lub zmienić, a także dowolnego bieżącego pliku zrzutu XML, którego używasz na wiki) przed zainstalowaniem nowej wersji.
Rozpakuj nową wersję na starej nadpisując wszystkie pliki.
Konfigurowanie Pywikibota
Otwórz Terminal w systemie uniksopodobnym (Linux/BSD/Solaris) lub Wiersz poleceń w systemie Windows (zwykle w folderach Windows, Akcesoria, Wszystkie aplikacje lub menu Wszystkie programy w menu Start) i zmień katalog na lokalizację, w której rozpakowałeś Pywikibota:
- Uniksopodobne (Linux/BSD/Solaris):
$ cd ~/core
- Windows:
$ c: $ cd "%USERPROFILE%\pywikibot"
Zamień lokalizację na tę, w której rozpakowałeś Pywikibota.
Kontynuuj, wykonując następujące polecenie, aby wygenerować plik konfiguracyjny użytkownika:
$ python pwb.py generate_user_files
Postępuj zgodnie z instrukcją, aby skonfigurować Pywikibota.
Na koniec uruchom następujące polecenie, aby zalogować się do swojej wiki:
$ python pwb.py login
Use on third-party wikis
Pywikibot jest wstępnie skonfigurowany dla dużej liczby wiki, lecz być może akurat nie dla tej, nad którą chcesz pracować. Zobacz Manual:Pywikibot/Use on third-party wikis aby dowiedzieć się, jak skonfigurować Pywikibot dla swojej wiki.
Więcej opcji konfiguracyjnych
Pywikibot zapewnia szeroką gamę opcji konfiguracyjnych pozwalających zmienić zachowanie Twojego bota. Możesz zmienić te ustawienia w pliku user-config.py. Zobacz config.py, aby poznać listę wszystkich parametrów, których możesz użyć.
Konfiguracja Proxy
Pywikibot wykorzystuje żądania $ do komunikacji z siecią.
Możesz użyć zmiennych środowiskowych HTTP_PROXY i HTTPS_PROXY, do tworzenia żądań korzystajacych z serwera proxy.
Więcej informacji znajdziesz w requests' documentation.
Uruchomienie skryptu
W pakiecie z Pywikibotem dostarczana jest spora ilość skryptów, znajdujących się w katalogu skrypty. Możesz uruchomić to wszystko za pomocą:
$ python pwb.py [name of the script]
Aby dowiedzieć się więcej o uruchamianiu podstawowych skryptów Pywikibota, zobacz:
- Warsztat nt. Małego zestawu narzędzi wiki do uruchamiania podstawowych skryptów Pywikibota.
- Materiały do samodzielnej nauki oparte na warsztatach z małych zestawów narzędzi wiki
- Podręcznik warsztatowy bazujący na warsztatach z małych zestawów narzędzi wiki
Lista wszystkich skryptów jest dostępna w Manual:Pywikibot/Scripts i doc.wikimedia.org/pywikibot.
Inne zależności
Większość skryptów nie wymaga dodatkowych pakietów, ale kilka z nich nie będzie działać bez nich. Są one wymienione w requirements.txt wraz z ich zależnościami.
Aby zainstalować zależności dla jakiegoś skryptu użyj pip i uruchom następującą komendę:
$ python -m pip install [name of the package]
Alternatywnie uruchom następującą komendę, aby zainstalować wszystkie zależności dla wszystkich skryptów naraz:
$ python -m pip install -r requirements.txt
- If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel connect or pywikibot@ mailing list.