Aide:Robots
La bibliothèque libre.
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.
- Trois robots sont disponibles et librement utilisables sur Wikisource :
ThomasBot, 
YannBot et 
MarcBot.
- Ils obéissent à des requêtes placées sur leur page de discussion.
Cette page décrit la syntaxe des requêtes.
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. pages non trouvé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}}
[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] SPLIT
La commande split sert à découper automatiquement un texte pour qu’il se trouve inséré dans chaque page en regard de l’image djvu.
- {{Requete|commentaire|[[page]]|SPLIT}}
Il faut que dans le texte chaque page soit distinguée comme un paragraphe == ayant pour nom le nom exact de la page à créer.
Le travail est d’autant facilité que le fichier comporte déjà les numéros des pages. Les titres des sections doivent être de la forme :
==[[Page:nomdepage]]==
Exemple :
==Page:Anonyme - Les Aventures de Til Ulespiegle.djvu/15==
[modifier] MATCH
Cette commande permet de comparer le texte d’une page à la couche texte d’un fichier djvu, afin de déterminer quelles sont les limites entre pages. La commande "match" effectue donc une pagination automatique, en vue d’un découpage.
Il faut indiquer au robot un fichier djvu avec couche texte, la page à paginer, ainsi que le numéro de la première page dans le texte.
La syntaxe est la suivante:
{{Requete|ThomasV|[[Les forceurs de blocus]]|match|[[:File:Verne - Une ville flottante, 1872.djvu]]|129}}
Résultat ; http://fr.wikisource.org/w/index.php?title=Les_forceurs_de_blocus&oldid=1210772
Une inspection du résultat est souhaitable avant d’utiliser la commande "split".
Nouvelle syntaxe :
{{Requete|ThomasV|[[nom_de_page]]|match}}
et indiquer la page de départ au sein du texte comme ceci :
==__MATCH__:[[Page:Verne - Voyage au centre de la Terre.djvu/161]]==
