Manual:Pywikibot/PAWS/de


 * See PAWS for more details.

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
To start a hosted notebook, go to https://paws.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 a few minutes for the new server to start up.

Once that is completed, you will be redirected to a URL like https://paws.wmflabs.org/paws/user/ /tree

Eine Konsole starten
To start a new interactive terminal,
 * 1) Go to your PAWS home
 * 2) click 'New' on the right hand side, and
 * 3) select 'Terminal'.

This will open a new window with the URL https://paws.wmflabs.org/paws/user/ /terminals/1, with a Linux '$' prompt.

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:

Now if you go to your PAWS files list, the saved page should be present.

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) Go to your PAWS home,
 * 2) click 'New' on the right hand side, and
 * 3) select 'Python 3'.

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
The Pywikibot library and scripts are located in /srv/paws, and are read-only. The installed Pywikibot library can not be modified in PAWS.

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

For example, to run a modified "checkimages.py":
 * 1) In the terminal, enter
 * 2) In a browser, go to your PAWS home and click on the file.
 * 3) In the browser, you can edit the file. Edit the code -- for instance, just after the   code on line 1775, add a new line 1776 that will print out your name:
 * 4) In the editing interface, use the File menu and click Save to save your modifications.
 * 5) In the terminal, enter