Jump to content

Handbuch:Pywikibot/Installation

From mediawiki.org
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 81% complete.
Diese Seite hilft dir, mit Pywikibot loszulegen, sowohl auf dem eigenen Computer, auf Toolforge oder indem du PAWS (Pywikibot: A Web Shell) verwendest.
Mit PAWS

PAWS: A Web Shell ist der einfachste Weg um Pywikibot zu starten. Hier ist keine Installation nötig und du kannst ein Web-Interface nutzen, um den Bot zu steuern.

Auf deinem eigenen Computer

Unten befindet sich eine Anleitung, die dir dabei hilft, Pywikibot einzurichten und auf deinem eigenen Computer zu betreiben. Vier Hauptschritte leiten dich durch diesen Prozess:

Toolforge bietet dir eine stabile Hosting-Infrastruktur, die es dir erlaubt, einen Bot kontinuierlich oder nach einem Zeitplan laufen zu lassen.

Python installieren

Lade dir Python von https://www.python.org/downloads/ herunter und installiere es. Make absolutely certain that you check the box at the bottom of the install wizard asking if you want to add Python to PATH! That will allow you to access Python from any command prompt just by typing the keyword python.

Wenn du Python bereits installiert hast, prüfe bitte, ob du eine aktuelle Version nutzt. Gib dazu in einer Konsole folgenden Befehl ein:

python --version To discover if Python version 3 or above is installed, run python3 --version in a console.

Ubuntu 19.04 and up comes with versions 2 & 3 installed. Python v2 runs by default using terminal command python; to use v3, use terminal command python3.

Python 3.7 or higher is currently required to run the bot, but Python 3.8 or higher is recommended. Auf Windows bitte nicht vergessen, die PATH-Umgebungs-Variable zu modifizieren um Python und pip richtig zum Laufen zu bekommen

Installiere Erweiterungen

Additional packages are required to run Pywikibot. Run the following command to install these packages:

$ python -m pip install "requests>=2.20.1"
$ python -m pip install "mwparserfromhell>=0.5.2"
$ python -m pip install packaging

For Python 3.7 an additional package is required. Install it with:

$ python -m pip install importlib_metadata

An alternate MediaWiki markup parser may be installed with:

$ python -m pip install "wikitextparser>=0.47.5"

See also https://doc.wikimedia.org/pywikibot/stable/introduction.html#quick-start


Installiere Pywikibot

$ python -m pip install pywikibot

If using pip, use pwb instead of python pwb.py in examples below.

Lade den aktuellen Pywikibot stable-Zweig herunter: .tar.gz, .zip.

Entpacke die geladene Datei, beispielsweise nach ~/pywikibot oder %USERPROFILE%\pywikibot.

Alternativ kann man die neueste Version mit git oder svn client von Gerrit beziehen, siehe Handbuch:Pywikibot/Gerrit . Dies wird empfohlen für aktive Botbetreiber und Entwickler, die Pywikibot verwenden.

Andere Versionen sind unter https://pywikibot.toolforge.org/ verfügbar.

Pywikibot aktualisieren

Halte dein Botstruktur aktuell. Neue Versionen werden laufend veröffentlicht und sind am selben Ort verfügbar.

Nutzer von git oder svn release können diesen Hinweis überspringen. Andernfalls ist es notwendig vor der Installation einer neuen Version die Konfigurationsdateien und Skripte (user-config.py, Family-Dateien oder angepasste Skripte, die erstellt oder geändert wurden, und den aktuellen XML-Dump, der als Wiki verwendet wird) zu sichern.

Entpacke die neue Version über die alte Version und überschreibe damit alle Dateien.

Pywikibot konfigurieren

Öffne das „Terminal“ in einem Unix-System(Linux/BSD/Solaris) bzw. die „Eingabeaufforderung“ unter Windows (normalerweise im „System“- oder „Zubehör“-Ordner im Startmenü unter „Alle Programme“). Wechsle in das Verzeichnis, in das der Pywikibot entpackt wurde.

Unix-Systeme (Linux/BSD/Solaris):
$ cd ~/core
Windows:
$ c:
$ cd "%USERPROFILE%\pywikibot"

Natürlich musst du den Pfad durch den Pfad ersetzen, wohin Pywikibot entpackt wurde.

Fahre fort mit folgendem Befehl, um die Dateien für die Benutzerkonfiguration zu erstellen:

$ python pwb.py generate_user_files

Folge der Anzeige zur Konfiguration von Pywikibot.

Mit folgendem Befehl meldest du dich schließlich an deinem Wiki an:

$ python pwb.py login

Verwendung auf fremden Wikis

Pywikibot ist für viele Wikis voreingestellt, aber eventuell nicht für das, auf dem du arbeiten willst. Siehe Manual:Pywikibot/Use on third-party wikis für die Konfiguration von Pywikibot für das fremde Wiki.

Weitere Konfigurationseinstellungen

Pywikibot stellt eine Vielzahl von Optionen vor, die das Verhalten deines Bots ändern. Diese Einstellungen kannst du in der Datei user-config.py vornehmen. Siehe config.py für die Liste aller verfügbaren Parameter.

Proxy-Konfiguration

Pywikibot ist auf requests angewiesen, um mit dem Web zu kommunizieren. Du kannst die Umgebungsvariablen HTTP_PROXY und HTTPS_PROXY verwenden, um Anfragen durch einen Proxy-Server zu führen. Siehe die Dokumentation von requests für mehr Informationen.

Ein Script ausführen

Das Pywikibot-Paket enthält zahlreiche Scripts im Verzeichnis „scripts“. Sie werden folgendermaßen ausgeführt:

$ python pwb.py [name of the script]

To learn more about running basic Pywikibot scripts, see:

Ein Verzeichnis aller Scripts findet sich unter Handbuch:Pywikibot/Skripte und doc.wikimedia.org/pywikibot.

Weitere Module

Die meisten Scripts brauchen keine zusätzlichen Pakete, aber einige laufen nicht ohne. In requirements.txt sind sie zusammen mit den benötigten Modulen aufgeführt.

Um ein Modul für ein Script zu installieren, verwende „pip“ mit folgendem Befehl:

$ python -m pip install [name of the package]

Du kannst mit folgendem Befehl auch alle Module für alle Scripts auf einmal installieren:

$ 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.