Aide:Robots
Aide Robots
Certaines commandes peuvent modifier un grand nombre de pages. Les conséquences d’une erreur sont sous votre responsabilité ! Après une erreur, il est parfois possible de corriger le tir en réutilisant le robot, mais pas toujours !
Avant d’appliquer des commandes replace et regexp à un grand nombre de pages, il est fortement conseillé de les tester sur une seule page.
Il n’existe pas de moyen d’interrompre une requête qui est commencée ; inutile donc d’écrire sur le template RequeteEnCours (quand la ligne s’affiche en jaune), ça n’a aucun effet sur le robot, à part qu’il ne saura plus où indiquer qu’il a fini.
- Plusieurs robots sont disponibles sur Wikisource, dont entre autres
- Ils obéissent ou bien à des requêtes (ThomasBot) ou bien à des demandes « en clair » placées sur leur page de discussion.
Cette page décrit la syntaxe des requêtes adressées à ThomasBot.
Pour consulter la liste des robots de Wikisource, voir Special:Listusers/bot.
- Pour demander une utilisation spécifique (par exemple, charger des images) ou pour demander le statut de bot, voir Wikisource:Bots.
Sommaire |
[modifier] Déroulement d’une requête
Pour effectuer une requête, il faut utiliser le modèle Requete.
La syntaxe générale est : {{Requete|commentaire|destination|commande|paramètres}}
La requête s’affiche en bleu lorsque vous sauvegardez la page : Requête en attente: .
Si le robot ne comprend pas votre requête, il répond par Requête Invalide: "" , "" :
Sinon, le template est remplacé par Requête en cours puis Requête terminée: Temps d'attente: s. Exécution: s. pages modifiées.
Vous pouvez effectuer plusieurs requêtes en même temps, mais le robot n’en traite qu’une seule à la fois. Il ne devrait donc y avoir qu’une seule Requête en cours à la fois sur la page du robot, sauf si vous faites une erreur.
Si le robot ne répond pas, c’est qu’il n’est pas en marche. Pour savoir si un robot est actif, vérifiez qu’il écoute sur IRC://browne.wikimedia.org#fr.wikisource. Il se peut aussi que le robot ne réponde pas immédiatement à une requête, car il est actif sur plusieurs sites en même temps. Dans ce cas soyez patient...
[modifier] Description de la syntaxe
Des exemples des requêtes déjà utilisées sont disponibles sur la page Utilisateur:Yann/Anciennes requêtes.
[modifier] Commentaire
Le champ ’commentaire’ est le commentaire laissé par le robot. Merci d’y mettre votre nom (sans symbole |), suivi éventuellement d’un commentaire.
[modifier] Destination
Le champ ’destination’ sert à indiquer au robot quelles pages doivent être modifiées.
Il est possible de spécifier trois types de destinations :
- Une seule page : [[nom de page]]
- Toutes les pages accessibles depuis une page donnée : links:[[nom de page]]
- Les éléments d’une catégorie : [[:Catégorie:nom de catégorie]]
Notes :
- Les commandes NAVIGATEUR, SPLIT, IMPORT supposent qu’on leur indique un nom de page.
- Les pages d’auteur, ainsi que toute page n’appartenant pas à l’espace principal (Main en anglais), sont épargnées.
[modifier] Commandes
- Note concernant la syntaxe :
- Il est possible d’inclure le symbole pipe | dans les paramètres, en tapant \| à la place.
- Pour inclure des modèles, écrire \{ et \} à la place de { et }.
- Pour inclure des liens, utiliser \[ et \] à la place de [ et ].
- Dans les expressions régulières, utiliser \\[ \\] \\{ \\} \\| à la place de \[, \], \{, \} et \|.
- Nouveau: Dans les commandes regexp et replace, \L est remplacé par le nom du lien qui a permis d’accéder à une page.
[modifier] DELETE
Suppression d’une chaine. Syntaxe :
- {{Requete|commentaire|[[page]]|DELETE|chaîne à supprimer|}}
- {{Requete|commentaire|links:[[page]]|DELETE|chaîne à supprimer|}}
[modifier] REPLACE
Remplacer une chaine de caractère :
- {{Requete|commentaire|[[page]]|REPLACE|chaine à remplacer|remplacement}}
- {{Requete|commentaire|links:[[page]]|REPLACE|chaine à remplacer|remplacement}}[1]
[modifier] REGEXP
Remplacer à partir d’une expression régulière (syntaxe python re.sub, voir le HOWTO) :
- {{Requete|commentaire|[[page]]|REGEXP|pattern|remplacement}}
- {{Requete|commentaire|links:[[page]]|REGEXP|pattern|remplacement}}
[modifier] MATCH, SPLIT
- commandes périmées ; utiliser le gadget
