Wikipédia:WPCleaner/Installation

Nuvola web broom.svg WPCleaner - 2.03 ()

Nuvola web broom.svg WPCleaner

Informations générales sur WPCleaner.

Gnome-help-faq.svg Discussion (en)

Discussion sur WPCleaner et questions sur son fonctionnement.

Gnome-tools-check-spelling.svg Typos

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


Aide à l'utilisation de WPCleaner.

Gnome-system-software-installer.svg Installation

Installation de WPCleaner.

WPCleaner est un outil de maintenance corrective, développé en Java 8+, qui s'installe avec getdown. Le programme d'installation est hébergé sur WMFLabs depuis la version 2.0 de WPCleaner[a].

PrérequisModifier

Les prérequis pour installer et utiliser WPCleaner sont :

Installation de WPCleaner avec le programme d'installationModifier

La méthode la plus simple pour installer WPCleaner est avec le programme d'installation dédié (Note: actuellement, le programme d'installation n'a été testé que sur quelques ordinateurs fonctionnant sous un système d'exploitation Windows, donc n'hésitez à m'indiquer le resultat de votre installation sur la page de discussion de WPCleaner).

Effectuer les actions suivantes pour l'installation :

  • Télécharger le programme d'installation depuis WMFLabs (ne pas s'inquiéter en cas de warning, les fichiers .jar sont souvent considérés comme des fichiers exécutables, ce qu'ils sont)
  • Démarrer le programme d'installation (si Java est correctement installé et configuré, ouvrir le fichier jar téléchargé devrait démarrer le programme d'installation)
  • Fournir les informations demandées pour la configuration :
    • Répertoire d'installation : choisir le répertoire dans lequel sera installé WPCleaner. Note: Eviter de choisir un répertoire dans un répertoire protégé par des droits particuliers (genre C:\Program Files ou C:\Program Files (x86) sous Windows).
    • Wiki: le wiki auquel vous voulez vous connecter par défaut.
    • Langue: la langue dans laquelle vous souhaitez utiliser WPCleaner.
    • Nom d'utilisateur: votre nom d'utilisateur (optionnel).
    • Mot de passe : votre mot de passe (optionnel).
    • Choisir si vous voulez que le programme d'installation crée un raccourci pour WPCleaner. Si le nom d'utilisateur et le mot de passe ont été saisis, ce raccourci lancera WPCleaner avec ces informations. Note: La création de raccourcis ne marche que pour certains systèmes d'exploitation.
    • Choisir si vous voulez installer la version de test de WPCleaner (ne choisir cette option que si vous souhaitez tester une fonction en cours de développement)
  • Cliquer sur le bouton d'installation et attendre la fin de l'installation.

Note: Cette procédure utilise en interne la procédure d'installation avec getdown, ce qui permet de bénéficier des mises à jour automatiques par la suite.

Installation de WPCleaner avec getdownModifier

Tutoriel d'installation sous Windows 10

Une autre manière d'installer WPCleaner utilise getdown, un outil indépendant dédié à l'installation et à la mise à jour automatique de programmes Java. Cette installation permet par la suite de mettre à jour automatiquement WPCleaner à chaque démarrage.

Effectuer les actions suivantes pour l'installation :

  • Créer un répertoire dédié pour WPCleaner (noté [Répertoire] dans la suite des explications). Note : Eviter de créer ce répertoire dans un répertoire protégé par des droits particuliers (genre C:\Program Files ou C:\Program Files (x86) sous Windows).
  • Télécharger dans ce répertoire les fichiers suivants :
    • getdown.txt (si votre navigateur affiche le contenu du fichier plutôt que de vous proposer de le télécharger, vous pouvez par exemple faire un clic droit sur le lien et utiliser une option telle que "Sauver le lien sous…")
    • getdown.jar (ne pas s'inquiéter en cas de warning, les fichiers .jar sont souvent considérés comme des fichiers exécutables, ce qu'ils sont)
  • Pour finaliser l'installation[b] :
    • Sous Windows :
      • Ouvrir une invite de commande (cmd[1] ou PowerShell)
      • Se placer dans le répertoire créé (commande cd [Répertoire], par exemple cd C:\Users\Toto\WPCleaner)
      • Exécuter la commande java -version pour s'assurer que Java est bien installé et que la version utilisée est au moins égale à 1.8
      • Exécuter la commande java -jar [Répertoire]\getdown.jar [Répertoire] (par exemple, java -jar C:\Users\Toto\WPCleaner\getdown.jar C:\Users\Toto\WPCleaner
    • Sous Linux :
      • Ouvrir une invite de commande (Terminal, Shell)
      • Se placer dans le répertoire créé (commande cd [Répertoire], par exemple cd /home/toto/WPCleaner)
      • Exécuter la commande java -version pour s'assurer que Java est bien installé et que la version utilisée est au moins égale à 1.8
      • Exécuter la commande java -jar [Répertoire]/getdown.jar [Répertoire] (par exemple, java -jar /home/toto/WPCleaner/getdown.jar /home/toto/WPCleaner)
    • Sous Mac OS :
      • Installer le JDK 10[c].
      • Ouvrir une invide de commande (Applications → Utilitaires → Terminal)[2].
      • Se placer dans le répertoire créé (commande cd [Répertoire], for example cd ~/Applications/WPCleaner)
      • Exécuter la commande java -version pour s'assurer que Java est bien installé et que la version utilisée est au moins égale à 1.8
      • Exécuter la commande java -jar [Répertoire]/getdown.jar [Répertoire] (par exemple, java -jar ~/Applications/WPCleaner/getdown.jar ~/Applications/WPCleaner)
    • Sous un autre système d'exploitation, c'est probablement très similaire à l'installation sous Linux
  • Getdown récupère alors tous les fichiers nécessaires à l'utilisation de WPCleaner, et démarre WPCleaner.


Vous avez la possibilité de customiser l'installation de WPCleaner pour en simplifier l'usage ultérieur :

  • Créer des raccourcis pour démarrer WPCleaner[d]
  • Créer un fichier contenant vos informations de connexion (credentials.txt : remplacer les informations entre crochets par les bonnes valeurs) :
Syntaxe générale Exemple
user=[Nom d'utilisateur]
password=[Mot de passe]
user=NicoV
password=MonMotDePasse
  • Créer des scripts personnalisés
  • Créer un fichier extra.txt dont chaque ligne correspond à une option ajoutée à la JVM utilisée par WPCleaner (par exemple, pour augmenter la mémoire maximale à 8G, créer ce fichier avec la ligne -Xmx8192M)
  • Note : les fichiers téléchargés par getdown ne doivent pas être modifiés, car toute modification serait écrasée au prochain démarrage de WPCleaner.

UsageModifier

Pour démarrer l'interface graphique de WPCleaner, vous pouvez (je vous conseille de créer un raccourci[d]) :

  • Sous Windows :
    • Double cliquer sur WPCleaner.bat
    • Exécuter la commande WPCleaner.bat -credentials credentials.txt fr pour que WPCleaner se connecte automatiquement à Wikipédia en français (fichier credentials.txt à créer au préalable)
    • Exécuter la commande WPCleaner.bat fr [NumUtilisateur] [MotDePasse] pour que WPCleaner se connecte automatiquement à Wikipédia en français
  • Sous Linux :
    • Double cliquer sur WPCleaner.sh[e]
    • Exécuter la commande WPCleaner.sh -credentials credentials.txt fr[e] pour que WPCleaner se connecte automatiquement à Wikipédia en français (fichier credentials.txt à créer au préalable)
    • Exécuter la commande WPCleaner.sh fr [NumUtilisateur] [MotDePasse][e] pour que WPCleaner se connecte automatiquement à Wikipédia en français
  • Sous tous les environnements (Windows, Linux ou autre) :
    • Exécuter la commande java -jar getdown.jar . depuis le répertoire d'installation (Noter le « . » à la fin de la commande qui est obligatoire)
    • Exécuter la commande java -jar getdown.jar . client -credentials credentials.txt fr depuis le répertoire d'installation pour que WPCleaner se connecte automatiquement à Wikipédia en français (fichier credentials.txt à créer au préalable)
    • Exécuter la commande java -jar getdown.jar . client fr [NomUtilisateur] [MotDePasse] depuis le répertoire d'installation pour que WPCleaner se connecte automatiquement à Wikipédia en français

Pour démarrer WPCleaner en mode bot sans interface graphique (traitement de tâches spécifiques), se reporter au fichier Bot.bat ou Bot.sh pour des explications sur les paramètres à utiliser.

Diagnostic des problèmesModifier

Ce chapitre essaie de donner des réponses pour quelques problèmes pouvant se produire durant l'installation.

Version de JavaModifier

Même en ayant installé un Java 8 ou un version plus récente sur votre ordinateur, il est possible que celui utilisé par l'invite de commande soit plus ancien. Vous pouvez voir ce problème à plusieurs étapes du processus d'installation :

  • Quand vous exécutez la commande java -version, la version indiquée est inférieure à 1.8
  • Quand vous exécutez la commande d'installation avec getdown, vous obtenez une exception UnsupportedClassVersionError indiquant "Unsupported major.minor version 51.0" (version 51.0 est pour Java 7, 52 pour Java 8)

Dans tous les cas, ceci signifie que l'invite de commande utilise une ancienne version de Java. Vous pouvez soit désinstaller l'ancien Java ou soit vous assurer que l'invite de commande utilise la nouvelle version.

Pour l'installation sous Mac, il semble que ce soit un problème connu (voir cette discussion), mais installer un JDK 10 devrait régler le problème.

SécuritéModifier

WPCleaner a besoin de votre identifiant Wikipédia et de votre mot de passe pour lire et modifier les articles sur lesquels vous voulez travaillez. Pour tester WPCleaner, sans possibilité d'enregistrer vos modifications, vous pouvez utiliser le mode Démo sans fournir de mot de passe.

Pour un mot de passe avancé avec double authentification, consulter le guide BotPasswords[f].

Configuration réseau avancéeModifier

Si votre ordinateur dispose d’une configuration réseau particulière (proxy, ...), il peut être nécessaire de configurer les accès réseau pour WPCleaner[3].

Boîte utilisateurModifier

Si vous voulez afficher sur votre page utilisateur que vous utilisez WPCleaner, vous pouvez utiliser {{Utilisateur WPCleaner}} ou l'icône de titre {{Icône WPCleaner}} :

 
WPCleaner

Changer d'ordinateurModifier

Sous Windows, WPCleaner enregistre la plupart de ses paramètres dans la base de registre. Si vous changez d'ordinateur et souhaitez conserver vos paramètres, vous pouvez simplement copier la partie concernée de la base de registre de votre ancien ordinateur vers le nouveau.

Pour copier vos paramètres d'un PC Windows vers un autre PC Windows, vous pouvez utiliser Regedit :

  1. Démarrez Regedit
  2. Sélectionnez le dossier HKEY_CURRENT_USER\Software\JavaSoft\Prefs\org\wikipediacleaner
  3. Cliquez sur Fichier > Exporter…
  4. Saisissez un nom de fichier et cliquez sur Enregistrer
  5. Copiez le fichier .reg de l'ancien PC vers le nouveau
  6. Sur le nouveau PC, cliquez droit sur le fichier .reg et choisissez Fusionner
  7. À la question "Etes-vous sûr de vouloir continuer ?", répondez Oui
  8. Une fois que la fusion est terminée, cliquez sur OK

Sous Mac et Linux, les paramètres sont enregistrés dans un fichier qui peut être copié sur un autre PC Mac ou Linux.


Voir aussiModifier

Notes et référencesModifier

NotesModifier

  1. Les versions antérieures à la 2.0 devront être désinstallées car elles ne sont plus mises à jour.
  2. Selon la configuration de votre ordinateur, il est possible que vous ayez besoin de configurer votre parefeu pour autoriser javaw.exe à communiquer avec l'extérieur afin qu'il puisse récupérer WPCleaner.
  3. Sous Mac OS, des problèmes existent avec les versions de Java antérieures.
  4. a et b Des icônes sont fournis dans le répertoire d'installation, WPCleaner.ico pour Windows et WPCleaner.png pour Linux et autres systèmes.
  5. a b et c Pour fonctionner, il faut que le script ait les droits en exécution, ce qui n'est pas possible automatiquement avec getdown. Après la première installation (et après chaque éventuelle mise à jour qui concerne ce fichier), il est nécessaire de donner les droits en exécution à ce fichier avec la commande chmod a+x WPCleaner.sh).
  6. FAQ : Authentification à 2 facteurs.

RéférencesModifier