WikiRobots/de

Übersicht
Wiederkehrende Aufgaben können mit Hilfe von Robotern oder Bots automatisiert werden, d.h. mit Softwareprogrammen, die selbstständig auf dem Wiki arbeiten.

Die natürlichen und am häufigsten verwendeten Roboter für Wiki Seiten werden von MediaWiki unter dem Paketnamen Pywikibot zur Verfügung gestellt. Siehe Handbuch:Pywikibot für die vollständigen Informationen.

Kurz gesagt, Pywikibot ist eine Sammlung von Python Skripten, die die native Wiki API verwenden können, um auf Wiki Seiten zu agieren. Um die API Liste für das FreeCAD Wiki zu sehen, besuche http://www.freecadweb.org/wiki/api.php

Um Pywikibot verwenden zu können, musst du dies tun:


 * 1) installiere das Pywikibot Paket
 * 2) konfiguriere Pywikibot so, dass es im FreeCAD Wiki funktioniert
 * 3) starte die Skripte, die du für die anstehende Aufgabe benötigst

Es gibt eine Fülle von Informationen über die Installation, Konfiguration und Benutzung von Pywikibot. Bitte beachte jedoch, dass diese Informationen zwar nützlich, aber auch irreführend sein können, da sie Anweisungen vermischen, die sich auf zwei verschiedene Pywikibot Codebasen und verschiedene Versionen der Pywikibot Skriptsammlung beziehen.

Im Folgenden findest du die grundlegenden Anweisungen zum Einrichten und Verwenden von Pywikibot im FreeCAD Wiki. Damit kannst du die gängigsten Aufgaben durchführen. Für fortgeschrittene Nutzung findest du das Handbuch:Pywikibot und den Python Quellcode.

Einrichtung
Gehe zu http://tools.wmflabs.org/pywikibot/ und lade herunter (das Projekt steht auch unter github, gerrit, usw., aber dies ist ein einfacher Weg, um ein vollständig in sich geschlossenes Paket zu erhalten).

Entpacke den Inhalt in deinem bevorzugten Verzeichnis.

Wenn du die Bibliotheken nicht in deine Python Bibliotheken installieren willst, bist du fertig (wenn du sie immer noch installieren willst, überprüfe die Datei im Basisverzeichnis).

Pywikibot funktioniert mit Python 2.6 und 2.7 ohne Probleme. Python 3 wurde bisher nicht mit FreeCAD wiki getestet und funktioniert ebenfalls.

Konfiguration
Du musst den folgenden Python Code als Datei mit dem Namen in dem Basisverzeichnis speichern, in das du entpackt hast  (zur Verdeutlichung: im gleichen Verzeichnis, in dem sich bereits eine Datei namens  befindet).

Im obigen Code:


 * ersetze <> durch deinen Wiki-Benutzernamen
 * ersetze cp437 durch dein console_encoding. Um dein "console encoding" unter Windows bzw. Linux herauszufinden, starte den Python-Interpreter und gib  gefolgt von  ein. Python wird dein  auf dem Bildschirm anzeigen.

Dann musst du den folgenden Python-Code in einer Datei unter dem Namen im Unterverzeichnis  (zusammen mit den anderen  Dateien) speichern.

Anwendung
Du kannst nun die Pywikibot-Skripte ausführen. Die Skripte selbst sind im -Unterverzeichnis enthalten.

Um die Skripte auszuführen, öffne eine Shell und gehe zum Basisverzeichnis (der Installation, NICHT des -Unterverzeichnisses) und gib ein

wo du natürlich "< >" durch den Namen des Skripts ersetzt, das du ausführen willst und "< " durch den/die erforderlichen Parameter für das Skript.

Für eine Beschreibung von Anwendung und Parametern für ein beliebiges Skript benutze einfach den Parameter "-help". Um bspw. eine Beschreibung für das -Skript zu erhalten, tippe

Es gibt einen weiteren sehr hilfreichen Parameter, der für alle diese Skripte gültig ist, genannt "-simulate", der es dir erlaubt, Befehle auszuprobieren, ohne das Wiki zu verändern. Benutze ihn, bevor du 'live' gehst.

Beispiele
Dieser Befehl loggt sich in das Wiki ein

Dieser Befehl druckt eine Liste aller Seiten, die einen Verweis auf SourceForge enthalten

Dieser Befehl ersetzt alle Verweise auf das alte SourceForge Forum durch einen Verweis auf das neue freecadweb.org bereitgestellte Forum

Dieser Befehl druckt eine Liste aller Seiten, die das Wort "PartDesign" enthalten, beginnend mit der Seite "2d Drafting Module" und weiter alphabetisch geordnet

Dieser Befehl ersetzt alle sicheren Verweise auf das alte SourceForge Forum durch einen Verweis auf das neue freecadweb.org bereitgestellte Forum auf den übersetzten Seiten.

FreeCAD Wiki Verwandte Befehle
Zählt alle Seiten, in denen eine bestimmte Wiki Vorlage verwendet wird

Alle Seiten auflisten, in denen eine bestimmte Wiki Vorlage verwendet wird

Ersetze eine Zeichenfolge in allen Seiten, die in der Kategorie Arch aufgeführt sind (a/k/a )