Manual:Pywikibot/Installation/fr

 Cette page vous aidera à débuter avec Pywikibot, soit sur votre propre ordinateur, sur Toolforge, ou en utilisant Pywikibot: un shell Web (PAWS).

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  permet d'afficher la version dans le terminal et de vérifier qu'elle est à jour. Si vous avez installé Python 2.7.2+, ou Python 3.4+, votre version de Python est suffisamment récente.

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 3.4+. Lancez la commande suivante pour installer ce package :

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

Décompresser le fichier téléchargé, par exemple dans   ou.

Vous pouvez d'une manière similaire récupérer la dernière version avec un client Git ou SVM à partir de Gerrit, voir. C'est la manière de faire recommandée pour utiliser Pywikibot, pour les opérateur et les développeurs actifs travaillant avec des robots.

Les versions plus anciennes sont disponibles sur http://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 SVN, vous pouvez sauter cette note. Sinon, soyez conscient que, avant d'installer une nouvelle version, il vous appartient de sauver 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):


 * Windows:

Évidemment il faut naviguer jusqu'au dossier où a été décompressé Pywikibot.

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

Les indications affichées dans le terminal permettent de configurer le logiciel. Une fois l'identifiant et le mot de passe Wikimédia entrés, vous êtes connecté.

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

Utilisation sur des Wikis indépendants
Pywikibot est pré-configuré pour fonctionner sur une grande partie des Wikis, mais il est possible d'en ajouter d'autres. présente la démarche permettant ceci.

Plus d'options de configuration
Pywikibot propose de nombreux paramètres de configuration pour personnaliser votre bot. Vous pouvez les modifier dans le fichier 'user-config.py'. Les paramètres sont listés sur config2.py.

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

Une liste complète de ces scripts est disponibles sur.

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 :

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