Handbuch:Pywikibot/Compat/Grundlegende Verwendung

Verwendung

Siehe Eine Verknüpfung erstellen für Windows-Nutzer.

Bot-Skript auswählen und ausführen

Nachdem du Python und Pywikibot installiert hast, benötigst du eine textbasierte Benutzeroberfläche für dein Betriebssystem.

Auf Pywikibot zugreifen

Nachdem du die Datei mit dem Namen user-config.py erstellt hast, kannst du auf Pywikibot zugreifen.

Unter Windows erfolgt dies durch das Öffnen des Startmens und Klicken auf 'Ausführen'. Du wirst aufgefordert, den Namen eines Programms anzugeben; gib "cmd.exe" ein.

• Wechsel zum Stammverzeichnis C:, indem du chdir C:\ eingibst
• Gib chdir \"Name des Ordners, in den Pywikibot heruntergeladen wurde" ein (Zum Beispiel: chdir \"pywikibot", wenn sich die Datei im Ordner C: befindet.)

Folgende Schritte könnten erforderlich sein:

• Verschiebe den Ordner httplib2, der sich im Unterordner externals befindet, eine Ebene nach oben.
• Alle Skripte, die du verwenden möchtest, müssen aus dem Unterordner scripts in den Hauptordner kopiert werden. Dies schließt login.py ein.

Auf Mac findest du Terminal.app unter /Applications/Utilities, siehe Mac-Installation.

Unter Linux oder einem anderen Unix-System kannst du eine beliebige Terminalanwendung wie gnome-terminal, konsole, xterm oder einfach die Textkonsole verwenden.

Führe in Compat das Skript login.py mit dem Befehl "python login.py" aus. Falls du die Datei user-config.py noch nicht hast, wird sie durch diesen Befehl interaktiv erstellt.

Führe im Kern-Verzeichnis das Skript login.py mit dem Befehl "python pwb.py login" aus. Falls du die Datei user-config.py noch nicht hast, wird sie durch diesen Befehl interaktiv erstellt.

pwb.py fügt das Kern-Verzeichnis zur `PATH`-Variable hinzu, damit Python das Pywikibot-Verzeichnis findet. Es gibt auch andere Möglichkeiten, dies zu beheben, z. B. das Hinzufügen des Kern-Verzeichnisses (oder eines beliebigen Verzeichnisses, das das Pywikibot-Verzeichnis enthält) zu `PATH` oder `PYTHONPATH`.

Passwort eingeben

Python gibt dann Folgendes zurück:

Password for user your_bot on your_site:en:

Verwende das Passwort, das du für den Benutzernamen des Bots verwendet hast. Beachte, dass deine Eingabe aus Datenschutzgründen nicht sichtbar ist. Der Bot kann nicht anonym arbeiten. Sofern du dein Passwort nicht änderst, musst du dieses Programm normalerweise nur einmal ausführen; der Bot wird in der Regel nicht abgemeldet.

Einen Bot verwenden

Die Bots befinden sich nach dem Herunterladen im Pywikibot-Hauptordner.

Verwende gegebenenfalls den Befehl cd, um in das Verzeichnis zu wechseln, in dem die Bot-Dateien gespeichert sind.

Starte nun einen der hier aufgeführten Bots, indem du "python botname.py" eingibst (Wenn du Windows verwendest, kannst du "python" weglassen).

Skripte

Hauptseite: Handbuch:Pywikibot/Skripte

Kommandozeilen-Argumente

Obwohl viele Bot-Skripte eigene Kommandozeilen-Argumente haben, die auf den jeweiligen Seiten (oder im Quellcode) dokumentiert sein sollten, erkennen alle Bots, sofern nicht ausdrücklich anders angegeben, die folgenden Kommandozeilen-Argumente:

(vollständige Liste hier: Handbuch:Pywikibot/Globale Optionen )

-help

Gibt eine Liste der globalen Bot-Argumente (diese Liste) aus, gefolgt von bot-spezifischer Hilfe, falls verfügbar.

-lang:xx

Legt die Sprache des Wikis, in dem du arbeiten möchtest, auf den Sprachcode xx fest und überschreibt damit die Konfiguration in user-config.py.

-family:xyz

Legt die Wiki-Familie, in der du arbeiten möchtest, fest, z. B. Wikipedia, Wiktionary, Wikitravel... Dadurch wird die Konfiguration in user-config.py überschrieben.

-user:xyz

Melde als Benutzer 'xyz' an anstatt des Standardbenutzernamens.

-log

Aktiviert die Protokolldatei. Die Protokolle werden im Logs-Unterverzeichnis gespeichert.

-log:xyz

Aktiviert die Protokolldatei mit xyz als Dateinamen.

-nolog

Deaktiviert die Protokolldatei (falls diese standardmäßig aktiviert ist).

-putthrottle:nn

Legt die Mindestzeit (in Sekunden) fest, die der Bot zwischen dem Speichern von Seiten wartet. Der Standartwert ist 10.

Beispielsweise führt der Befehl python scriptname.py -family:wiktionary den Bot "scriptname" für Wiktionary-Artikel aus und überschreibt die Standardeinstellung für die Wiki-Familie in deiner Benutzerkonfiguration.

Erlaubnis in Wikimedia-Projekten

Stelle sicher, dass dein Bot von der Wiki-Community, in der du ihn einsetzen möchtest, genehmigt ist: Siehe dazu die globale Bot-Richtlinie. Die Strenge der Richtlinien variiert stark zwischen den verschiedenen Projekten.

Erstelle mit deinem Browser einen Benutzernamen und ein Passwort für den Bot. Wähle am besten einen Namen, der eindeutig auf den Bot hinweist und idealerweise auch den Betreiber nennt. Häufig verwendet man den eigenen Benutzernamen und fügt das Wort 'Bot' hinzu, es gibt aber auch andere Möglichkeiten.