Příručka:Pywikibot/Instalace
Níže naleznete příručku, která vám pomůže s nastavením Pywikibota a jeho spuštěním na vašem počítači. V procesu jsou čtyři hlavní kroky:
 |
| Pywikibot |
|---|
|
Nainstalujte si Python
Stáhněte a nainstalujte Python z https://www.python.org/downloads/.
Ujistěte se, že jste v dolní části instalačního průvodce zaškrtli políčko s dotazem, zda chcete do cesty PATH přidat Python!
To vám umožní přístup k Pythonu z libovolného příkazového řádku pouhým zadáním klíčového slova python3.
Pokud již máte Python nainstalovaný, zkontrolujte, zda je vaše verze dostatečně aktuální spuštěním příkazu python --version z konzoly.
Chcete -li zjistit, zda je nainstalována Python verze 3 nebo vyšší, spusťte na konzoli python3 --version.
Ubuntu 19.04 a vyšší přichází s nainstalovanými verzemi 2 a 3.
Python v2 běží ve výchozím nastavení pomocí příkazu terminálu python. Chcete -li použít v3, použijte příkaz terminálu python3.
Pro spuštění robota je aktuálně vyžadován Python 3.9 nebo vyšší, ale doporučuje se Python 3.10 nebo vyšší. Na Windows nezapomeňte přidat hodnotu do systémové proměnné PATH, aby Python a pip správně fungovaly.
Nainstalujte si potřebné knihovny
Ke spuštění Pywikibota jsou nutné další balíčky. Spusťte následující příkaz k instalaci těchto balíčků:
python3 -m pip install "requests>=2.20.1"
python3 -m pip install "mwparserfromhell>=0.5.2"
python3 -m pip install packaging
Pro Python 3.7 je vyžadován další balíček. Nainstalujte jej pomocí:
python3 -m pip install importlib_metadata
Alternativní analyzátor značek MediaWiki lze nainstalovat s:
python3 -m pip install "wikitextparser>=0.47.5"
See also https://doc.wikimedia.org/pywikibot/stable/introduction.html#quick-start
Nainstalujte si Pywikibota
Doporučeno
python3 -m pip install pywikibot
Pokud používáte pip, použijte pwb namísto python3 pwb.py v příkladech níže.
Alternativy
Stáhněte si aktuální větev Pywikibota stable: .tar.gz, .zip.
Rozbalte stažený soubor, například do ~/pywikibot nebo do %USERPROFILE%\pywikibot.
Případně můžete nejnovější verzi získat pomocí klienta git od Gerritu, viz Příručka:Pywikibot/Gerrit. Toto je doporučený způsob používání Pywikibota pro aktivní provozovatele robotů a vývojáře.
Další verze jsou dostupné na https://pywikibot.toolforge.org/.
Aktualizace Pywikibota
Udržujte framework svého bota aktuální. Nové verze jsou vydávány nepřetržitě a jsou dostupné stále na stejném místě.
Pokud používáte git release, můžete tuto poznámku přeskočit. Jinak mějte prosím na paměti, že před instalací nové verze je nutné zálohovat konfigurační soubory a skripty (user-config.py, jakýkoli soubor rodiny nebo vlastní skript, který jste případně vytvořili nebo změnili, a jakýkoli aktuální soubor s výpisem XML, který používáte pro wiki).
Rozbalte novou verzi namísto té staré, přepište všechny soubory.
Nastavení Pywikibota
Otevřete Terminál (terminal) na systému unixového typu (Linux/BSD/Solaris) nebo Příkazový řádek (command prompt) na Windows (typicky pod složkami Systém Windows nebo Příslušenství (accessories) v položce Všechny aplikace (all aps) nebo Všechny programy (all programs) uvnitř nabídky Start), a změňte adresář tam, kam jste rozbalili Pywikibota:
- Systémy unixového typu (Linux/BSD/Solaris):
cd ~/core
- Windows (příkazový řádek, ne PowerShell):
c: cd "%USERPROFILE%\pywikibot"
Samozřejmě nahraďte umístění na to správné, kde máte rozbaleného Pywikibota.
Pro vygenerování souboru uživatelského nastavení pokračujte následujícím příkazem:
python3 pwb.py generate_user_files
Následujte pokyny k nastavení Pywikibota. Budete muset vytvořit heslo.
Spusťte následující příkaz k přihlášení se do vaší wiki:
python3 pwb.py login
Použití na wiki třetích stran
Pywikibot je přednastaven pro velké množství wiki, ale možná ne pro tu vaši, na které chcete pracovat. Podívejte se na stránku Manual:Pywikibot/Use on third-party wikis pro nastavení Pywikibota pro vaší wiki.
Více možností nastavení
Pywikibot poskytuje širokou škálu možností nastavení pro změnu chování vašeho bota.
Tato nastavení můžete změnit v souboru user-config.py.
Pro seznam všech parametrů, které lze použít, se podívejte na config.py (anglicky).
Nastavení proxy serveru
Pywikibot závisí na requests pro komunikaci s webem.
Pro uskutečnění požadavků prostřednictvím proxy serveru můžete použít systémové proměnné HTTP_PROXY a HTTPS_PROXY.
Více informací získáte na dokumentaci requests (anglicky).
Spuštění skriptu
Pywikibot obsahuje ve své složce scripts velké množství skriptů. Všechny lze spustit použitím následujícího:
python3 pwb.py [name of the script]
Další informace o spouštění základních skriptů Pywikibota naleznete na:
- Malý workshop wiki toolkit o spouštění základních skriptů Pywikibota
- Materiály pro samostudium založené na malém workshopu wiki toolkits
- Workshopová příručka založená na malém workshopu wiki toolkits
Seznam všech skriptů je k dispozici na Manual:Pywikibot/Scripts a doc.wikimedia.org/pywikibot.
Další potřebné knihovny
Většina skriptů nepotřebuje další balíčky, ale některé bez nich fungovat nebudou. Ty jsou vypsány v requirements.txt společně s jejich potřebnými knihovnami.
K instalaci potřebných knihoven pro některé skripty použijte pip a spusťte následující příkaz:
python3 -m pip install [name of the package]
Případně můžete spustit následující příkaz k instalaci všech potřebných knihoven pro všechny skripty najednou:
python3 -m pip install -r requirements.txt
- Potřebujete-li další pomoc při rozběhání Pywikibota, navštivte IRC kanál #pywikibot připojit se nebo e-mailový komunikační kanál pywikibot@.