Manual:Pywikibot/Compat/Basic use/fr

Utilisation

 * Voyez Créer un raccourci pour les utilisateurs de Windows.

Sélectionner et exécuter un script par un bot
Maintenant que vous avez installé Python et Pywikibot, vous devez avoir une interface textuelle pour accéder à votre système d'exploitation.


 * Accès à pywikibot

Après avoir créé le fichier nommé , vous pouvez accéder à pywikibot.

Sous Windows, cela s'effectue en ouvrant le menu de démarrage et en cliquant sur 'Exécuter'. Vous êtes invité à donner le nom d'un programme, tapez " ".


 * Changez la racine en C: en tapant
 * Entrez chdir \"nom du dossier où pywikibot a été téléchargé"  (Par exemple: chdir \"pywikibot" si le fichier se trouve dans le dossier C: .)

Il est possible que les étapes suivantes soient également à faire :


 * Remonter au niveau supérieur le dossier httplib2 qui se trouve dans le sous-dossier externals.
 * Tous les scripts que vous souhaitez utiliser doivent être copiés du sous-dossier scripts vers le dossier principal. Cela inclut login.py.

Sur Mac, cherchez Terminal.app dans / Applications / Utilitaires, voir Installation Mac.

Sous Linux ou n'importe quel autre Unix, utilisez une application de type terminal telle que gnome-terminal, konsole, xterm ou simplement la console en mode texte.

Dans compat, exécutez le script en tapant "python login.py". Si vous n'avez pas encore, cette commande va le créer de manière interactive.

Dans le noyau, à partir du répertoire de base, exécutez le script en tapant "python pwb.py login". Si vous n'avez pas encore, cette commande va le créer de manière interactive.


 * Saisie du mot de passe

Python retournera alors :

''' Password for user your_bot on your_site:en: '''

Utilisez le mot de passe que vous avez utilisé pour le nom de connexion du bot. Notez que vos saisies ne seront pas visibles pour des raisons de confidentialité. Le bot ne peut pas travailler anonymement. À moins que vous ne changiez votre mot de passe, vous devez normalement exécuter ce programme une seule fois, le bot n'est généralement pas déconnecté.


 * Utilisation d'un bot

Les bots sont dans le dossier pywikibot principal lors du téléchargement.

Si nécessaire, utilisez la commande cd pour aller dans le répertoire où les fichiers bot sont enregistrés.

Maintenant, exécutez l'un des bots ici en tapant "python botname.py" (si vous utilisez Windows, vous pouvez omettre "python").

Scripts

 * Page d'accueil : 

Arguments de la ligne de commande
Bien que de nombreux scripts de bots aient leurs propres arguments à la ligne de commande, ce qui devrait être documenté sur leurs pages respectives (ou dans le code source), tous les bots, à moins d'indication contraire, reconnaissent les arguments suivants à la ligne de commande :

(liste complète ici : )


 * -help
 * Imprime une liste d'arguments globaux des bots (cette liste), suivie de l'aide spécifique au bot si elle est disponible.


 * -lang:xx
 * Définit la langue du wiki sur lequel vous souhaitez travailler par son code de langue, en remplaçant la configuration dans.


 * -family:xyz
 * Définit la famille du wiki sur lequel vous souhaitez travailler, par exemple, wikipedia, wiktionary, wikitravel, ... Cela remplacera la configuration dans.


 * -user:xyz
 * Permet de se connecter en tant que xyz au lieu de l'utilisateur par défaut, le mot de passe est demandé après.


 * -log
 * Active le fichier journal. Les journaux seront stockés dans le sous-répertoire logs.


 * -log:xyz
 * Active le fichier journal en utilisant  comme nom de fichier.


 * -nolog
 * Désactive le fichier journal (s'il est activé par défaut).


 * -putthrottle:nn
 * Définit le temps minimum (en secondes) que le bot attendra entre la sauvegarde des pages. La valeur par défaut est 10.

Par exemple,  exécutera le bot « scriptname » sur les articles du Wiktionary, en remplaçant le paramètre par défaut de la famille dans votre configuration utilisateur.

Autorisation sur les projets Wikimedia
Assurez-vous que votre bot est approuvé par la communauté wiki où vous allez l'exécuter : consultez la Politique globale des robots pour obtenir des conseils. Les règles diffèrent considérablement suivant les projets.

Avec votre navigateur Web habituel, créez un pseudonyme et un mot de passe pour le bot. Il est préférable d'utiliser un pseudonyme qui indique clairement qu'il s'agit d'un bot, et de préférence aussi qui l'exploite. Une méthode courante consiste à utiliser votre pseudonyme de connexion et à y ajouter « bot »; d'autres formes existent également.