Beschreibung

Das pythonbasierte Bot-Framework Pywikipediabot des Niederländers Rob W.W. Hooft erledigt nützliche Aufgaben im MediaWiki, sei es Wikipedia, Wikibooks oder Dein eigenes MediaWiki-unterstützes Projekt.

Installation

• python sollte bei Mac OS X sowie Linux dabei sein, ansonsten Python hier herunterladen und installieren!
• Lade den BOT herunter unter http://sourceforge.net/projects/pywikipediabot/
  • Du musst lediglich den Ordner entpacken, es muss nichts extra installiert werden

Vorbereitungen

• Erstelle ein Benutzerkonto für den Bot in deinem WikiMedia-Projekt
• Als nächstes musst Du eventuell 2 Dateien in dem BOT-Ordner erstellen, die user-config.py, und eine MEINPROJEKT_family.py, wobei das MEINPROJEKT durch deinen WikiMedia-Projektnamen ersetzt wird.

user-config.py

• Erstelle die Datei user-config.py, mit folgendem Inhalt:
  mylang = 'de' <- evtl. ersetzen username = 'USERNAME_DES_BOT' <- ersetzen
• Ändere in der Datei config.py die generellen Parameter; siehe den entspechenden Abschnitt etwas weiter unten!

project_family.py

• Falls der BOT für die Wikipedia o.ä. gedacht ist, kannst du die bestehende _family.py-Dateien verwenden
• Soll der BOT auf dein eigenes MediaWiki-Projekt zugreifen, dann
  • erstelle die datei MEINPROJEKT_family.py, wobei das MEINPROJEKT durch deinen WikiMedia-Projektnamen ersetzt wird.

<code>

 # -*- coding: utf-8  -*-

 import family

 # The meta family

 class Family(family.Family):
     name = 'MEINPROJEKT'
     def __init__(self):
         self._addlang('de',
                         location = 'www.MEINPROJEKT.de',                <- ERSETZEN DURCH DIE URL DEINES WikiMedia-Projektes
                         namespaces = {  1: u'Diskussion',
                                         2: u'Benutzer',
                                         3: u'Benutzer Diskussion',
                                         4: u'MEINPROJEKT',              <- ERSETZEN
                                         5: u'MEINPROJEKT Diskussion',   <- ERSETZEN
                                         6: u'Bild',
                                         7: u'Bild Diskussion' })


     def path(self, code):
         return '/index.php'

</code>

Generelle Parameter

Die Scripte verstehen folgende generelle Parameter:

• -family: die Scripte lassen sich mit diesem Parameter für verschiedene MediaWiki-Projekte verwenden
  • -family:FAMNAME
• -throttle: fügt eine Wartezeit (in Sekunden) beim Aufrufen der Seiten hinzu, um den Server nicht zu überlasten
  • -minthrottle = 2
  • -maxthrottle = 60
• -put_throttle: fügt eine Wartezeit (in Sekunden) beim Abspeichern der Seiten hinzu, um den Server nicht zu überlasten
  • -put_throttle = 60

Sinnvollerweise kann man diese Einstellungen global in der Datei config.py festlegen (nicht in der Datei user-config.py, dort nurmehr username und mylang eintragen!):

 mylang = 'de'
 username = 'USERNAME_DES_BOT'    <- ersetzen 
 family = 'MEINPROJEKT'           <- ersetzen
 minthrottle = nn       <- nn durch sekunden ersetzen
 maxthrottle = nn       <- nn durch sekunden ersetzen
 put_throttle = nn      <- nn durch sekunden ersetzen

Benutzung des BOT

Zunächst muss der BOT sich über das login.py-Script auf der MediaWiki-Seite einloggen. Um das Script auszuführen, wechsel in der Kommandozeile in den Ordner des BOT, und gib dort ein:

python login.py

Du wirst nach dem Passwort des BOT gefragt. Wenn die Eingaben stimmen, bist du eingeloggt. (Normalerweise bleibt der BOT eingeloggt, das Script muss also nur beim Systemstart aufgerufen werden)

Das war's, nun kannst du alle weiteren Scripte mit

python SCRIPTNAME

aufrufen.

Zur Verfügung stehende Scripte

Main bots:

• category.py
• check_extern.py
• interwiki.py
• redirect.py
• replace.py
• solve_disambiguation.py
• table2wiki.py
• upload.py

Other bots:

• brackethttp.py
• catall.py
• copy_table.py
• editarticle.py
• find.py
• getimages.py
• imageharvest.py
• imagetransfer.py
• pagelist.py
• saveHTML.py
• standardize_interwiki.py
• touchall.py
• us-states.py
• warnfile.py

Auxiliary programs:

• extract_names.py
• extract_wikilinks.py
• login.py
• splitwarning.py
• sqldump.py
• template.py
• test.py
• xmltest.py

FAQ - Häufig gestellte Fragen

• Wie hält man den Bot an, wenn man noch während eines Prozesses abbrechen möchte/muss?
  • Drücke "Strg + C" um den Prozess zu beenden
• Wie kann man mit replace.py mehrere Texte in einem Artikel ersetzen? Oder geht das nicht? (z.B. ein Artikel enthält an einer Stelle "Errror" an anderer "Feehler" und man möchte beides auf einmal ersetzen)
• Was KANN der Bot?

Verweise

• Englisches HowTo: http://meta.wikimedia.org/wiki/Using_the_python_wikipediabot
• Quelle des PyWikipediaBot: http://sourceforge.net/projects/pywikipediabot/
• Python: http://www.python.org/download/

Kategorie

Tutorials