Wikipédia:WPCleaner/Outils pour bots

WPCleaner - 2.05 ()

WPCleaner

Informations générales sur WPCleaner.

Discussion (en)

Discussion sur WPCleaner et questions sur son fonctionnement.

Typos

Suggestions d'orthographe et de typographie gérées par WPCleaner.


Aide à l'utilisation de WPCleaner.

Installation

Installation de WPCleaner.

Bot tools
Bot tools

WPCleaner propose quelques outils de type Bot :

General bot tools
General bot tools
Bot tools for Check Wiki
Bot tools for Check Wiki
  • Mise à jour des bandeaux {{Avertissement Homonymie}} sur les pages de discussion des articles pour informer les contributeurs des liens vers les pages d'homonymie présents dans les articles.
  • Mise à jour des bandeaux {{Avertissement ISBN}} sur les pages de discussion des articles pour informer les contributeurs des ISBN invalides présents dans les articles.
  • Mise à jour des bandeaux {{Avertissement Argument dupliqué}} sur les pages de discussion des articles pour informer les contributeurs des arguments dupliqués présents dans les articles.
  • Constitution d'une liste d'ISBN invalides avec les articles concernés.
  • Surveillance des modifications récentes pour détecter l'ajout de liens vers des pages d'homonymie.
  • Projet Correction syntaxique :
    • Correction automatique de certaines erreurs.
    • Vérification de la présence des erreurs dans les articles.
    • Vérification des listes blanches.


Remarque : ces outils sont destinés à n'être utilisés que par des robots autorisés. Ils peuvent en effet modifier un nombre important de pages en un temps restreint. Veuillez n'utiliser ces fonctions que si vous comprenez parfaitement les modifications qui vont être entreprises. Il est de votre responsabilité de vous assurer que les modifications effectuées sont correctes.

Bots utilisant ces outils régulièrement modifier

Utilisation en ligne de commande modifier

La plupart de ces outils sont aussi accessibles en ligne de commande, pour pouvoir par exemple être exécutés automatiquement à intervalle régulier.

Pour utiliser WPCleaner en ligne de commande :

  • Installer normalement WPCleaner avec getdown
  • Exécuter WPCleaner avec la commande suivante :
    • Sous Windows, dans une Invite de commandes, depuis le répertoire d'installation, utiliser une des commandes suivantes
      • Bot.bat [options_générales] [wiki] [utilisateur] [mot_de_passe] [commande] [options]
      • Bot.bat [options_générales] -credentials credentials.txt [wiki] [commande] [options][n 1]
    • Sous Linux (et probablement sous d'autres environnements), dans un Terminal, depuis le répertoire d'installation, utiliser une des commandes suivantes
      • Bot.sh [options_générales…] [wiki] [utilisateur] [mot_de_passe] [commande] [options…]
      • Bot.sh [options_générales…] -credentials credentials.txt [wiki] [commande] [options…][n 1]

Où :

  • [options_générales…] sont d'éventuelles options générales :
    • -timelimit [secondes] permet de définir une limite en secondes du temps d'exécution
  • [wiki] est le code du wiki sur lequel WPCleaner doit être exécuté (« fr » pour ce wiki)
  • [utilisateur] est votre nom d'utilisateur
  • [mot_de_passe] est votre mot de passe
  • [commande] est la commande à exécuter, et [options…] les éventuelles options spécifiques à la commande. Les commandes disponibles sont :
    • UpdateDabWarnings pour mettre à jour les bandeaux {{Avertissement Homonymie}}
    • UpdateDuplicateArgsWarnings pour mettre à jour les bandeaux {{Avertissement Argument dupliqué}}
    • UpdateISBNWarnings pour mettre à jour les bandeaux {{Avertissement ISBN}}
    • ListISBNWarnings pour mettre à jour la liste des ISBN invalides
    • UpdateISSNWarnings pour mettre à jour les bandeaux {{Avertissement ISSN}}
    • ListISSNWarnings pour mettre à jour la liste des ISSN invalides
    • FixCheckWiki pour corriger des erreurs du projet Correction Syntaxique. Les arguments supplémentaires contiennent les listes d'erreurs à analyser ([numéroErreur]) et éventuellement des erreurs supplémentaires à corriger si elles sont trouvées dans les articles (+[numéroErreur]).
    • ListCheckWiki pour analyser un fichier d'export de MediaWiki pour trouver des erreurs du projet Correction Syntaxique. Les arguments supplémentaires contiennent :
      • le chemin vers le fichier d'export ([fichierExport]),
      • le chemin vers le répertoire ou les fichiers pour les résultats de l’analyse ([repértoireOuFichier]) ou le nom des pages de destination sur le wiki (wiki:[nomPage]). Note : le texte {0} est remplacé par le numéro de l’erreur concernée.
      • les listes d'erreurs à analyser ([numéroErreur]).

Exemple sur Toolforge modifier

Il est possible d'exécuter WPCleaner en mode bot depuis Toolforge. Des explications sont disponibles sur ce ticket Phabricator, en particulier dans ce commentaire.

Exemple sur NAS Synology modifier

Il est possible d'exécuter WPCleaner en mode bot sur certains NAS, selon la marque et le modèle du NAS. Ce chapitre présente un exemple pour des NAS Synology (testé sur le modèle DS411j).

Pour exécuter à intervalle régulier des tâches automatiques avec WPCleaner, suivre les étapes ci-dessous :

  • Installer Java (détails de la procédure en anglais sur pcloadletter) :
    • Déterminer le type de processeur de votre NAS en se basant sur cette liste (exemple DS411j : Marvell Kirkwood mv6281 1.2Ghz ARM donc ARM).
    • Télécharger la version embedded de Java 7 correspondant à ce type de processeur sur le site d'Oracle (exemple DS411j : ejre-7u55-fcs-b13-linux-arm-sflt-headless-17_mar_2014.tar.gz) et le copier dans le répertoire partagé public de votre NAS (le créer si nécessaire)
    • Dans le gestionnaire de paquets du NAS (Package Center), ajouter le site PCLoadLetter avec l'url http://packages.pcloadletter.co.uk.
    • Installer le paquet Java SE Embedded 7.
  • Créer le script :
    • Créer un répertoire dédié au script (exemple : /volume1/Divers/WPCleaner/ISBNWarnings)
    • Créer le script lui-même (exemple : script.sh ci-dessous à adapter en fonction du répertoire choisi et de la tâche à accomplir). Quelques explications :
      • En première ligne, utiliser #!/bin/sh
      • Utiliser ensuite la commande cd pour se positionner dans le répertoire contenant le script
      • Mettre à jour WPCleaner (commandes rm et wget)
      • Exécuter la (ou les) tâche(s) automatique(s) avec WPCleaner (exemple, mise à jour des avertissements des liens vers les pages d'homonymie)
    • Tester le fonctionnement en ligne de commande
  • Programmer le déclenchement du script en utilisant les tâches planifiées (Task Scheduler) du NAS.


#!/bin/sh
cd /volume1/Divers/WPCleaner/FixCheckWiki/
/bin/rm -f WikipediaCleaner.jar 2>&1 | /usr/bin/tee script.log
/usr/bin/wget -nv http://site4145.mutu.sivit.org/WikiCleaner/WikipediaCleaner.jar 2>&1 | /usr/bin/tee -a script.log
/volume1/@appstore/java7/jre/bin/java -Xmx1024m -cp WikipediaCleaner.jar org.wikipediacleaner.Bot fr UTILISATEUR MOTDEPASSE UpdateDabWarnings 2>&1 | /usr/bin/tee -a script.log
echo Finished >> script.log
  1. a et b Se reporter à Wikipédia:WPCleaner/Installation pour la création et l'utilisation du fichier credentials.txt