Manuel:Pywikibot/Installation

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 95% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Lëtzebuergesch • ‎Nederlands • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎norsk nynorsk • ‎polski • ‎português do Brasil • ‎suomi • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Gnome-system-software-installer.svg
Cette page vous aidera à débuter avec Pywikibot, soit sur votre propre ordinateur, sur Toolforge, ou en utilisant PAWS: un shell Web.
Sous PAWS
Unicorn paw logo.svg

PAWS: un shell web est la manière la plus simple pour débuter avec Pywikibot. Aucune installation n'est nécessaire, tout passe par une page Web et un terminal en ligne pour envoyer les commandes.

Sur son propre ordinateur
Computer n screen.svg

Vous trouverez ci-dessous un manuel pour vous aider à installer et à utiliser Pywikibot sur votre propre ordinateur. Il y a quatre étapes principales dans ce processus :

Toolforge logo.svg

"Toolforge" vous fournit une infrastructure de nuage stable sur les serveurs Wikimedia vous permettant d'exécuter des robots d'une manière continue ou d'après un calendrier.

Installer Python

Télécharger Python et l'installer à partir de https://www.python.org/downloads/.

Si vous possédez déjà Python, la commande python --version permet d'afficher la version dans le terminal et de vérifier qu'elle est à jour. Si vous avez installé Python 2.7.4 ou plus récent, ou Python 3.4 ou plus récent, votre version de Python est suffisamment récente. Néanmoins, les versions de Python antérieures à la 3.5 pourront être écartées dans un futur proche. Il est strictement recommandé d'utiliser Python 3.5 ou plus récent.

On Windows please don't forget to modify PATH environment variable to make Python and pip work properly.

Dépendances de l'installation

Un package additionnel appelé requêtes (requests) est nécessaire pour exécuter Pywikibot. Utilisez pip, qui est déja installé si vous avez Python 2.7.9 (ou supérieur) ou 3.4 (ou supérieur). Exécutez la commande suivante pour installer ce package :

$ pip install requests

Installer Pywikibot

Télécharger Pywikibot stable branch: .tar.gz, .zip.

Décompresser le fichier téléchargé, par exemple dans ~/pywikibot ou C:\Users\nom d'utilisateur\pywikibot.

Vous pouvez, d'une manière similaire, récupérer la dernière version avec Git ou un client SVN à partir de Gerrit, voir Manual:Pywikibot/Gerrit . C'est la manière de faire recommandée pour utiliser Pywikibot, pour les opérateurs et les développeurs.

Les versions sont disponibles sur https://tools.wmflabs.org/pywikibot/.

Mettre à jour Pywikibot

Gardez à niveau votre système de robots. De nouvelles versions sont livrées en continu et sont disponibles au même endroit.

Si vous utilisez une version de Git ou de SVN, vous pouvez sauter cette note. Sinon, soyez conscient que, avant d'installer une nouvelle version, il vous appartient de sauvegarder vos fichiers et vos scripts de configuration (user-config.py, les fichiers de famille, ou les scripts adaptés que vous auriez pu créer ou modifier, ainsi que les fichiers de dump XML courants que vous utilisez pour un wiki).

Décompresser la nouvelle version en remplaçant l'ancienne et ses fichiers.

Configurer Pywikibot

Ouvrez Terminal sur les systèmes pseudo-Unix (Linux/BSD/Solaris) ou une Fenêtre de commandes (cmd) sous Windows (typiquement dans les répertoires Windows System ou Accessoires, dans le menu All apps ou All programs du menu Démarrage), et modifiez le répertoire dans lequel vous avez décompressé Pywikibot :

Pseudo Unix (Linux/BSD/Solaris):
$ cd ~/pywikibot
Windows:
$ c:
$ cd "\Users\username\pywikibot"

Évidemment il faut remplacer l'emplacement par le dossier où vous avez décompressé Pywikibot.

Continuer avec la commande suivante pour générer le fichier de configuration utilisateur :

$ python pwb.py generate_user_files

Suivez les questions pour configurer Pywikibot.

Finalement exécutez la commande suivante pour vous connecter à votre wiki :

$ python pwb.py login

Utilisation sur des Wikis tiers

Pywikibot est pré-configuré pour fonctionner sur un grand nombre de Wikis, mais il est possible que le votre ne figure pas sur la liste. Voir Manual:Pywikibot/Use on third-party wikis pour la démarche permettant de configurer Pywikibot sur votre wiki.

Plus d'options de configuration

Pywikibot propose de nombreux paramètres de configuration pour modifier le comportement de votre robot. Vous pouvez modifier ces paramètres dans le fichier « user-config.py ». Tous les paramètres utilisables sont listés sur config2.py.

Proxy configuration

Pywikibot relies on requests for communicating with the web. You can use HTTP_PROXY and HTTPS_PROXY environment variables to make requests use a proxy server. Refer to requests' documentation for more info.

Exécuter un script

Pywikibot est installé avec de nombreux scripts dans le dossier scripts. Vous pouvez tous les exécuter à partir de la commande suivante :

$ python pwb.py [name of the script]

Une liste complète de ces scripts est disponibles sur Manual:Pywikibot/Scripts .

Autres dépendances

La plupart des scripts ne nécessite pas de packages supplémentaires, mais certains d'entre-eux ne fonctionneront pas s'ils sont absents. Ils sont listés sur requirements.txt, ensemble avec leurs dépendances.

Pour installer les dépendances de certains scripts, utilisez pip, et lancez la commande suivante :

$ pip install [name of the package]

Vous pouvez à la place, lancer la commande suivante pour installer toutes les dépendances pour l'ensemble des scripts en une fois :

$ pip install -r requirements.txt


If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel connect or pywikibot@ mailing list.