Manual:Pywikibot/PAWS/fr


 * Voir PAWS pour plus d'informations.

Ce document donne une vision rapide de Pywikibot en tant que 'notebook' hébergé sur les Labs de la fondation Wikimédia via PAWS (Pywikibot: A Web Shell ou Pywikibot As Web Service, Pywikibot en tant que Service en Ligne).

Note : Le copier-coller dans le terminal fonctionne uniquement sur les navigateurs issus de Chrominium tels que Google Chrome. Si vous utilisez un autre navigateur vous devez taper manuellement les commandes présentes dans ce guide.

Créer un compte Wikimedia
Pour suivre ce guide, vous devez avoir un compte Wikimédia.

Pour en créer un, veuillez aller sur cette page d'aide. (Les caractères spéciaux sont autorisés depuis T120066)

Une fois votre compte créé, merci de vérifier que vous êtes connécté en allant sur https://test.wikipedia.org : votre identifiant doit apparaître en haut à droite. (fonctionne depuis T120327).

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

Cliquer sur 'Sign in with MediaWiki, puis sur Autoriser lors de l'OAuth Authentication''. (Known bug: any username with non-alphanumeric chars will fail.)

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. Une liste de commandes disponibles peut être obtenue avec.

Se connecter au Wiki
Pywikibot génère au démarrage du serveur un fichier essentiel nommé user-config.py, configuré par défaut pour fonctionner sur le Wiki de test, https://test.wikipedia.org.

Cette commande vérifie la connexion à https://test.wikipedia.org. PAWS utilise OAuth, il n'est donc pas nécessaire d'entrer ses identifiants dans l'interface.

Créer une page
La commande suivante permet de créer une page de test. Remplacez   (sans les <>) 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 votre œuvre sur https://test.wikipedia.org/wiki/User_talk:.

Chaque commande dispose d'une aide intégrée, il vous suffit de taper son nom suivi de -help.

Lire une page
La commande listpages le permet.

Pour obtenir le changement effectué 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 script plus utile
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.

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/index.html. Elle peut être aussi consultée directement depuis le terminal avec la fonction.

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

or

Éditer les scripts Pywikibot
La librairie 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" :
 * 1) Entrer dans un terminal  ,
 * 2) Dans la liste des fichiers, ouvrez le fichier   en cliquant dessus,
 * 3) Vous pouvez le modifier dans cette fenêtre. Par exemple, à la ligne 1775, après la ligne , ajoutez une nouvelle ligne 1776 qui affichera votre nom :  ,
 * 4) Dans l'éditeur de fichier, vous pouvez enregistrer en cliquant sur le bouton Save dans le menu File,
 * 5) Dans un terminal,   lancera votre programme modifié. Le paramètre   indique que le robot n'effectuera aucune modification réelle sur le Wiki.