Manual:Pywikibot/PAWS/de


 * Siehe PAWS für weitere Details.

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



Erstellen eines Wikimedia-Benutzerkontos
Um dieser schnellen Demonstration zu folgen, benötigst du lediglich ein Benutzerkonto bei einem Wikipedia/Wikimedia-Projekt. Benutze Special:CreateAccount, um eines anzulegen.

Wenn du ein Benutzerkonto erstellt hast, besuchen bitte https://test.wikipedia.org/ und stelle sicher, dass dein Benutzername in der oberen rechten Ecke auftaucht.

Wenn du ein neuer Wikimedia-Benutzer bist, logge dich mit deinem Konto auf Meta-Wiki, Wikipedia, Wikidata oder Wikimedia Commons ein. Lese und lösche in jedem dieser Projekte alle ausstehenden Nachrichten (ganz oben).



Einschreiben in ein Notebook
Um ein gehostetes Notebook zu starten, besuche bitte https://hub.paws.wmcloud.org/hub

Drücke auf "Sign in with MediaWiki" und anschließend auf "Allow", wenn du um die Erlaubnis für "Use OAuth for Authentication" gebeten wirst. Beim ersten Besuch von PAWS musst du einen Server erstellen. Klicke auf den grünen "Start my Server"-Button. Es ist normal, wenn es ein paar Minuten dauert, bis der neue Server hochgefahren ist.

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



Eine Konsole starten
Um eine neue interaktive Konsole zu öffnen,
 * 1) Gehe zu deiner PAWS Startseite
 * 2) Klicke auf "New" auf der rechten Seite
 * 3) Wähle "Terminal"
 * 4) Klicke: File > New > Terminal

Das wird ein neues Fenster mit der Linux-Eingabeaufforderung "$" öffnen.

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, verwende.

To see them all, press TAB twice.



Im Wiki einloggen
Dies wird dein Konto auf dem Server einrichten und dir erlauben, dich von der Kommandozeile aus einzuloggen. Der folgende Befehl sollte bestätigen, dass du sich auf https://test.wikipedia.org/ einloggen kannst. Da OAuth verwendet wird, wird kein Passwort benötigt.

Du kannst Pywikibot mit einem anderen Wiki verbinden, indem du eine Datei namens user-config.py in deinem  directory  erstellst und die Variablen mylang und family hinzufügst:



Eine Seite erstellen
Um eine Seite zu erstellen, gib den folgenden Befehl in die Konsole ein, wobei du " " mit deinem Benutzernamen ersetzen und anschließend "Y" drücken musst, wenn du gefragt wirst, ob deine Änderungen übernommen werden sollen:

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 [$url 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. 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 w: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.

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--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/paws 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

Edit the code -- for instance, just after the  code on line 1775, add a new line 1776 that will print out your name: (If no '-limit:x' defined, the program would run until all images checked, it may take long time.)
 * 1) In the terminal, enter
 * 1) In a browser, go to your PAWS home and click on the file.
 * 1) In the browser, you can edit the file.
 * 1) In the editing interface, use the File menu and click Save to save your modifications.
 * 1) In the terminal, enter



Siehe auch

 * PAWS/PAWS and Pywikibot
 * Using Pywikibot with PAWS notebook based tutorial - A tutorial that helps users get started with using Pywikibot and PAWS
 * Example notebooks using Pywikibot - A list of notebooks hosted on PAWS that use Pywikibot
 * PAWS cheatsheet by one user (e.g. about API and database access)
 * Source code on GitHub