Handbuch:Pywikibot/Installation
Diese Seite hilft dir, Pywikibot auf deinem eigenen Computern zu installieren und zu betreiben. Vier Hauptschritte leiten dich durch diesen Prozess:
 |
| Handbuch:Pywikibot |
|---|
|
Contents
Python installieren
Lade dir Python von https://www.python.org/downloads/ herunter und installiere es.
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
Hast du Python 2.7.4 oder höher bzw. Python 3.4 oder höher installiert, ist deine Version aktuell genug.
However, Python versions below 3.5 can be dropped in near future.
It is strictly recommended to use Python 3.5 or higher.
Modify the path
On Windows systems, even after installing python, the command line interface may not initially know where the python installation is located (although the installer has an option to make it know). In other words, if you enter the command
C:\Users\Joe>python
it may result in the following error:
'python' is not recognized as an internal or external command, operable program or batch file.
To fix this, you need to modify the environment variable named "path" and add the folder which contains "python.exe". On Windows 10, this is under Settings > System > About > System info > Advanced System Settings > Environment Variables. Closing and re-opening the command line, entering "python" should give some information about your current python installation. This same process can be repeated for pip. If you enter the command
C:\Users\Joe>pip
and it displays an error, also add the folder containing "pip.exe" to the path.
Installiere Erweiterungen
Damit Pywikibot läuft, wird ein Zusatzpaket namens „requests“ benötigt. Verwende pip (bereits installiert, wenn du Python 2.7.9 oder höher verwendest) oder Python ab Version 3.4. Gib folgenden Befehl zur Installation des Pakets ein:
pip install requests
$ pip install requests
Installiere Pywikibot
Lade dir aktuelle Pywikibot stable branch herunter: .tar.gz, .zip.
Entpacke die geladene Datei, beispielsweise nach /home/username/pywikibot oder C:\Users\benutzername\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://tools.wmflabs.org/pywikibot/ 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 ~/pywikibot
- Windows:
$ c: $ cd "\Users\username\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 config2.py für die Liste aller verfügbaren Parameter.
Proxy configuration
Pywikibot relies on requests for communicating with the web.
You can use HTTP_PROXY and HTTPS_PROXY environment variables to make requests use a proxy server.
Refer to requests' documentation for more info.
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]
Ein Verzeichnis aller Scripts findet sich unter Manual:Pywikibot/Scripts.
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:
$ pip install [name of the package]
Du kannst mit folgendem Befehl auch alle Module für alle Scripts auf einmal installieren:
$ pip install -r requirements.txt
- If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel verbinden or pywikibot@ mailing list.
