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.

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.

Beim ertsen Besuch von PAWS müssen sie einen Server erstellen.

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
When a website used on Wikipedia changes its URL, the links on Wikipedia become outdated, and possible also dead links if the website doesn't redirect from the old URLs to the new URLs. e.g. for example, Encyclopedia Britannica (EB) has changed their links, such as moving pages from http://www.britannica.com/EBchecked/media/ to http://www.britannica.com/topic/[topic name]/images-videos/*. You can find the list of usages of the old URL on English Wikipedia at https://en.wikipedia.org/wiki/Special:LinkSearch/http://www.britannica.com/EBchecked/media. Updating all those links manually will be very time consuming. Thankfully EB has maintained redirects from their old URLs to the new URLs, so this does not need to be fixed immediately.

For a simpler example, English Wikipedia currently contains links to http://britannica.com/EBchecked/ instead of http://www.britannica.com/EBchecked/ ; i.e. a 'www.' subdomain is missing in the URL.

There are currently 14 cases on English Wikipedia: https://en.wikipedia.org/wiki/Special:LinkSearch/http://britannica.com/EBchecked/

Wikipedia in other language also have this problem. e.g. there is one case on German Wikipedia: https://de.wikipedia.org/wiki/Spezial:Weblinksuche/http://britannica.com/EBchecked/

In order to fix those links, we can use Pywikibot replace.py script. In this demo we will use the '-simulate' argument to avoid writing to the wiki, as there are strict rules about automated editing of English Wikipedia.

First lets list all of the pages which link to http://britannica.com/EBchecked/.

Now we check those pages actually have the literal URL in the page; i.e. they are not using a template.

Now use replace to add the missing "www."

In PAWS, and any terminal that supports color, the diff of changes will show the added "www." in green text color, making it easier to find the proposed changes.

Inside Pywikibot
Next we will use the PAWS Python session.


 * 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.

In the text box, enter the following and in the Cell menu select 'Run' (or pressing shift+enter to run).

A new text box will appear below. Run the following to create an APISite object connected to https://test.wikipedia.org/:

Describe "site" by entering it into the new text box and selecting "Run".

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 ins Wiki:

Die Antwort sollte folgendermaßen lauten:

The interactive Python 3 notebook allows many lines to be run together. The above could be put into one text box and Run

The log of your interactive Python session can be saved or downloaded for future reference.

Auf die Online-Dokumentation in PAWS zugreifen
Pywikibot documentation may be found at https://doc.wikimedia.org/pywikibot/index.html. It is primarily sourced from docstrings, which can be loaded in the interactive Python 3 notebook using the Python built-in function help.

For example, to look at the arguments for the save method above, run either:

or

Pywikibot-Skripte bearbeiten
The Pywikibot library and scripts are located in /srv/pwb, and are read-only. The installed Pywikibot library can not be modified in PAWS.

Scripts may be modified after copying them into your PAWS home.

To run a modified "checkimages.py"
 * 1) In the terminal, enter "cp /srv/pwb/scripts/checkimages.py ~"
 * 2) Click on the file checkimages.py in your PAWS home
 * 3) Edit the code and save your modifications
 * 4) In the terminal, enter "pwb.py ~/checkimages.py -simulate"