Diese Skripte benutzen pywikibot (docs) um das ZaPFwiki zu bearbeiten.
Die eigentlich Skripte sind in scripts/. Die notwendigen Dependencies
installiert man am besten in ein virtual environment, diese finden sich in
requirements.txt.
Um die Skripte zu benutzen benötigt man ein families
file,
welches schon vorgeneriert in families/zapfwiki_family.py zu finden ist und
eine user-config.py, welche man mit sh pwb generate_user_file erzeugen
kann. Dafür empfiehlt es sich vorher ein
Botpasswort anzulegen.
Die Generierung der user-config.py muss im Toplevel dieses Repos stattfinden,
damit das families file gefunden wird, dann einfach die Zahl des ZaPFwikis
auswählen, bei der Sprache de wählen, den eigenen Nutzernamen eingeben, nicht
mit anderen Projekten verbinden, Ja zum Botpasswort, dann Nutzernamen und
Passwort für den Bot angeben und den Rest kann man getrost verneinen.
Beispiele gibt es in scripts/, in der
Doku und in den
Beispielskripten von
pywikibot.
Skripte benötigen einen Moduldocstring damit Hilfeaufrufe mit -help möglich
sind. pywikibot benutzt eine etwas eigene Syntax für
Kommandozeilenargument. Optionen beginnen mit einem Bindestrich gefolgt von
einem Wort, z.B. -help, und etwaige Werte werden durch einen Doppelpunkt
getrennt angehängt, z.B. -option:wert.