Manual:Pywikibot/PAWS/fr


 * Voir PAWS pour plus d'informations.

Ce document donne une vision rapide et interactive de  en utilisant un notebook hébergé sur le Services cloud Wikimedia Cloud via PAWS (PAWS: A Web Shell).

Créer un compte Wikimédia
Pour suivre ce guide, vous avez seulement besoin d'un compte Wikipédia/Wikimédia. Utilisez Special:CreateAccount pour en créer un.

Une fois votre compte créé, merci de vérifier,en allant sur https://test.wikipedia.org/ que votre identifiant apparaît en haut à droite. (fonctionne depuis ).

Si vous êtes un nouvel utilisateur sur Wikimedia, connectez-vous avec votre compte sur meta.Wikimedia, Wikipedia, Wikidata et Commons. Et dans chacun d'eux, lisez et supprimez tous les messages en attente que vous avez (en haut).

Se connecter au Notebook
Pour démarrer un Notebook en ligne, aller sur https://hub.paws.wmcloud.org/hub

Cliquer sur Sign in with MediaWiki, puis sur Autoriser lors de l'OAuth Authentication. Lors du premier accès à PAWS, vous devez créer votre serveur. Cliquez sur le bouton vert Start my Server. Il est normal d'attendre quelques minutes lors du démarrage.

Une fois celui-ci terminé, vous serez redirigé à une page de type https://paws.wmflabs.org/paws/user//tree

Démarrer un terminal
Pour démarrer un terminal en ligne,
 * 1) Allez sur la page d'accueil de PAWS
 * 2) Cliquez sur New en haut à droite de fenêtre, puis
 * 3) Sélectionnez Terminal

Une nouvelle page va s’ouvrir avec une adresse telle https://paws.wmflabs.org/paws/user//terminals/1, avec un message d'accueil et une zone de saisie débutant par '$'.

Vous pouvez sauvegarder cette adresse dans vos marques pages, elle permet d’accéder directement au terminal.

Le terminal est réel, c'est un bash shell, dans une installation appartenant à un docker container. Vous pouvez donc utilisez n'importe quelle commande bash reconnue par Linux.

Pour lister les fichiers, utilisez.

Se connecter au wiki
Ceci établira votre compte sur le serveur et vous permettra de vous logguer depuis la ligne de commande. Cette commande permet de vérifier que vous pouvez vous connecter au wiki de test. Celui-ci utilise OAuth, il n'est donc pas nécessaire de saisir son mot de passe.

Vous pouvez connecter pywikibot à un wiki différent en créant un fichier nomé user-config.py dans votre dossier  et en ajoutant les variables mylang et family :

Créer une page
La commande suivante permet de créer une page de test. Remplacez '&lt;username>' par votre nom d'utilisateur, puis validez la modification de la page en appuyant sur Y (oui) lorsque cela vous est demandé.

Vous avez modifié le Wiki ! Vous pouvez contempler en ouvrant $u dans votre navigateur.

Vous pouvez en savoir plus sur chacun de ces scripts avec le paramètre '-help'.

Lire une page
La recherche de plusieurs pages est possible via la commande listpages.

Pour obtenir le contenu de la page créée précédemment, entrez la commande suivante :

Maintenant, en allant sur la liste des fichiers, vous pouvez vérifier que la page a été téléchargée et enregistrée.

Un exemple de script réel
Losqu'un site utilisé par Wikipédia change son URL, les liens dans Wikipédia deviennent caducs, et probablement des liens morts si le site web ne redirige pas des anciennes URLs vers les nouvelles. L'encyclopédie Britanica (EP) a changé ses liens, déplaçant les pages de http://www.britannica.com/EBchecked/media/ à http://www.britannica.com/topic/[topic name]/images-videos/*. Vous pouvez trouver la liste des des anciennes URLS sur la Wikipédia anglaise à w:Special:LinkSearch/http://www.britannica.com/EBchecked/media. Mettre à jours à la main tous ces liens serait chronophage. Heureusement, EB a maintenu des redirections des anciennes URLS vers les nouvelles. Ainsi, il n'est pas nécessaire de régler le problème immédiatement.

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: w:Special:LinkSearch/http://britannica.com/EBchecked/

Wikipedia in other language also have this problem. e.g. there is one case on German Wikipedia: w:de: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, let's 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.

Utilisation plus complète
Nous allons à nouveau utiliser les Notebook fournis par PAWS et ses commandes Python.


 * 1) Aller sur la page d'accueil
 * 2) Cliquer sur New en haut à droite, puis
 * 3) Sélectionner Python 3

Une nouvelle fenêtre s'ouvre.

Dans la zone de saisie, entrez la commande suivante. Pour l’exécuter, cliquez sur Run dans le menu Cell (ou le raccourci clavier Shift + Enter).

Une nouvelle zone de saisie apparaît dessous. La commande suivante permet de créer un objet nommé APISite et de se connecter au wiki de test.

Appelez l'objet précédemment créé puis cliquez sur Run.

Vous obtenez :

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

Créer un objet de type page :

Vérifier qu'il est existant en l’appelant :

Vous obtenez :

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

Afficher le contenu de la page :

Le remplacer par un nouveau contenu :

Et enfin sauvegarder la page :

Vous obtenez :

La Notebook interactif du langage Python 3 autorise l’exécution simultanée de plusieurs lignes? Par exemple vous pouvez ajouter les lignes ci dessous dans une seule cellule puis cliquez sur Run :

Il est possible de télécharger les logs (résultats) pour une référence future.

Documentation en ligne
La documentation de Pywikibot peut être obtenue à l'adresse https://doc.wikimedia.org/pywikibot/. Elle provient principalement de docstrings, qui peut également être consultée directement depuis le terminal interactif Python 3 avec la fonction help.

Par exemple, pour obtenir la documentation de la commande utilisée précédemment :

ou

Éditer les scripts Pywikibot
La bibliothèque Pywikibot est enregistrée dans le dossier, accessible en lecture seule.

Il est néanmoins possible de les modifier en les copiant dans votre espace personnel.

Par exemple, pour exécuter une version modifiée de "checkimages.py" :

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

Voir aussi

 * 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