Manual:Pywikibot/PAWS/de

Dieses Dokument bietet eine schnelle, interaktive Übersicht von Pywikibot mithilfe eines "Notebooks", das auf der Wikimedia Labs-Umgebung unter Verwendung von "PAWS" gehostet wird.

Note PAWS Terminal supports copy and paste in Chromium-based browsers only. If you use a different browser, you will need to manually type the commands mentioned in this walk-through.

Erstellen eines Wikimedia-Benutzerkontos
Um diese schnelle Demonstration durchzuführen, benötigen Sie lediglich ein Benutzerkonto bei einem Wikimedia-Projekt.

Um ein Wikimedia-Benutzerkonto zu erstellen, siehe die Einloggen-Hilfeseite. (Vermeiden Sie Sonderzeichen, bis T120066 gewartet wurde.)

Wenn sie ein Benutzerkonto erstellt haben, besuchen Sie bitte https://test.wikipedia.org/ und stellen Sie sicher, dass Ihr Benutzername in der oberen rechten Ecke auftaucht. (das funktioniert mit T120327).

Einschreiben in ein Notebook
Um ein gehostetes Notebook zu starten, besuchen Sie bitte https://tools.wmflabs.org/paws

Drücken sie auf "Sign in with MediaWiki" und anschließend auf "Allow", wenn sie um die Erlaubnis für "Use OAuth for Authentication" gebete werden. (Known bug: any username with non-alphanumeric chars will fail.)

Beim ertsen Besuch von PAWS müssen sie einen Server erstellen. Click the green "My Server" button. It's normal to wait about ten minutes for the new server to start up.

Wenn dies abgeschlossen ist, werden Sie zu einer URL umgeleitet, die wie https://tools.wmflabs.org/paws/user/ /tree aussieht.

Eine Konsole starten
Um eine neue interaktive Konsole zu öffnen,
 * 1) Gehen sie zu ihrer PAWS Startseite
 * 2) Klicken Sie auf "New" auf der rechten Seite
 * 3) Wählen sie "Terminal"

Das wird ein neues Fenster mit der URL https://tools.wmflabs.org/paws/user/ /terminals/1 mit der Linux-Eingabeaufforderung "$".

Sie können die URL zu ihren Lesezeichen hinzufügen und zu dieser Seite zurückkehren, selbst wenn sie Ihren Browser geschlossen oder Ihren Computer heruntergefahren haben.

Diese Konsole ist kein Emulator. Es ist eine echte Bash Shell, wie sie Teil einer Linux-Installation basierend auf einem Docker-Container ist. Also kann jeder Bash-Befehl und jeder auf Linux verfügbare und installierte Befehl verwendet werden.

Um einige der verfügbaren Befehle zu sehen, verwenden Sie.

In das Wiki einloggen
Pywikibot benötigt eine Konfigurationsdatei namens "user-config.py", welche PAWS automatisch für Sie erstellt, wobei das Standardwiki https://test.wikipedia.org/ ist.

Der folgende Befehl sollte bestätigen, dass Sie sich auf https://test.wikipedia.org/ einloggen können. Da OAuth verwendet wird, wird kein Passwort benötigt.

Eine Seite erstellen
Um eine Seite zu erstellen, geben Sie den folgenden Befehl in die Konsole ein, wobei Sie " " mit Ihrem Benutzernamen ersetzen und anschließend "Y" drücken, wenn sie gefragt werden, ob sie ihre Änderungen übernehmen möchten:

Nun haben Sie das Wiki bearbeitet. Sehen Sie sich ihre Änderungen an, indem sie https://test.wikipedia.org/wiki/User_talk: in Ihrem Browser öffen.

Sie können mehr über die Skripte erfahren, wenn sie die "-help"-Option anwenden.

Eine Seite fetchen
Das Fetchen vieler Seiten wird durch den "listpages"-Befehl ermöglicht.

Um die Inhalte der erstellten Seite anzuzeigen, geben Sie folgenden Befehl ein:

Wenn Sie nun auf Ihre PAWS Dateiliste gehen, sollte die gespeicherte Seite dort vorhanden sein.

Ein echtes Skriptbeispiel
Wenn eine auf Wikipedia verwendete Seite ihre URL verändert, veralten die Links auf Wikipedia und möglicherweise werden sie auch zu Redlinks, falls keine Weiterleitung von der alten URL zu der neuen URL erstellt wird.Zum Beispiel Encyclopedia Britannica (EB) hat ihre Links durch das Verschieben von Seiten von http://www.britannica.com/EBchecked/media/ nach http://www.britannica.com/topic/[topic name]/images-videos/* verändert. Sie können die Liste der Verwendungen der alten URL auf https://en.wikipedia.org/wiki/Special:LinkSearch/http://www.britannica.com/EBchecked/media im englischen Wikipedia finden. Das manuelle Erneuern dieser Links würde zeitlich sehr uneffizient sein. Zum Glück hat EB Weiterleitungen von den alten URLs zu den neuen URLs beibehalten, also müssen die Wikipedia-Links nicht sofort erneuert werden.

Ein einfacheres Beispiel wäre, dass das englische Wikipedia zurzeit Links zu http://britannica.com/EBchecked/ statt http://www.britannica.com/EBchecked/ enthält; es fehlt also das "www." als Subdomain in der URL.

Es gibt derzeit 14 Fälle im englischen Wikipedia: https://en.wikipedia.org/wiki/Special:LinkSearch/http://britannica.com/EBchecked/

Wikipedia hat dieses Problem auch in anderen Sprachen. Zum Beispiel gab es einen Fall im deutschen Wikipedia: https://de.wikipedia.org/wiki/Spezial:Weblinksuche/http://britannica.com/EBchecked/

Um diese Links zu reparieren, können wir das Pywikibot-replace.py-Skript verwenden. In dieser Demonstration werden wir das "-simulate"-Argument verwenden, um nicht das Wiki zu bearbeiten, da es strenge Regeln für das automatisierte Bearbeiten beim englischen Wikipedia gibt.

Zuerst betrachten wir alle Seiten, die zu http://britannica.com/EBchecked/ verlinken.

Nun schauen wir, ob die Seiten die wortwörtliche URL auf der Seite haben, das heißt, dass sie nicht die Vorlage verwenden.

Nun nutzen wir "replace", um das fehlende "www." hinzuzufügen.

In PAWS wird bei jeder Konsole, die farbliche Darstellungen unterstützt, der Unterschied grün dargestellt, in unserem Fall das "www.", was uns das Finden der Änderungen erleichtert.

In Pywikbot
Als nächstes werden wir die PAWS-Python-Sitzung verwenden.


 * 1) Gehen Sie zu ihrer Startseite home
 * 2) Klicken Sie auf "New" auf der rechten Seite
 * 3) Wählen Sie 'Python 3' aus

Dies wird ein neues Fenster öffnen.

Geben Sie folgendes in die Textbox ein und wählen sie "Run" (oder alternativ Umschalt+Eingabe).

Eine neue Textbox wird darunter erscheinen. Starten sie folgenden, um ein APISite-Objekt zu erschaffen, das mit https://test.wikipedia.org/ verbunden ist:

Legen Sie "site" fest, indem Sie es in die neue Textbox eingeben und "Run" wählen.

Es sollte folgendes anzeigen

Out[3]: APISite("test", "wikipedia")

Erzeuge ein Seitenobjekt:

Prüfe durch Aufrufen, ob es vorhanden ist:

Es sollte folgendes ausgeben

VERBOSE:pywiki:Found 1 wikipedia:test processes running, including this one. Out[5]: True

Zeige den Text auf der Seite:

Ändere den Seitentext in dem Objekt:

Speichere die Seite im Wiki:

Die Antwort sollte folgendermaßen lauten:

Das interaktive Python 3-Notbook erlaubt ihnen, viele Befehle zusammen auszuführen. Das obere kann auch in eine einzige Textbox eingegeben werden.

Der Log Ihrer interaktiven Python-Sitzung kann für zukünftige Nachfrage gespeichert oder heruntergeladen werden.

Auf die Online-Dokumentation in PAWS zugreifen
Die Pywikibot-Dokumentation kann unter https://doc.wikimedia.org/pywikibot/index.html gefunden werden. Es basiert hauptsächlich auf docstrings, was im interaktiven Python 3-Notebook mithilfe der eingebauten Funktion help geladen werden kann.

Um zum Beispiel die Argumente für die Speicher-Methode oben anzusehen, führen Sie das aus:

or

Pywikibot-Skripte bearbeiten
Die Pywikibot-Bibliothek und die Skripte befinden sich in /srv/pwb und sind nur lesbar. Die installierte Pywikibot-Bibliothek kann nicht in PAWS bearbeitet werden.

Skripte können nach dem Kopieren in Ihr PAWS home modifiziert werden.

Um eine modifizierte Datei "checkimages.py" zu bearbeiten:
 * 1) Geben Sie in der Konsole "cp /srv/pwb/scripts/checkimages.py ~" ein
 * 2) Klicken Sie auf Ihre Datei "checkimages.py" in Ihrem PAWS home
 * 3) Verändern sie den Quelltext und speichern Sie Ihre Modifikationen.
 * 4) Geben Sie in der Konsole "pwb.py ~/checkimages.py -simulate" ein