Aide:Robots

La bibliothèque libre.

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, laissez un message sur le scriptorium.

Sommaire 1 Déroulement d'une requête 2 Description de la syntaxe 2.1 Commentaire 2.2 Destination 2.3 Commandes 2.3.1 DELETE 2.3.2 REPLACE 2.3.3 REGEXP 2.3.4 TEXT, TEXTE 2.3.5 NAVIGATEUR 2.3.6 SPLIT 3 Voir aussi

[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 templates, é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] TEXT, TEXTE

Ajout de la classe "text" (<div class="text">) à une page, sauf si elle s'y trouve déjà :

• {{Requete|commentaire|[[page]]|TEXT}}
• {{Requete|commentaire|links:[[page]]|TEXT}}

[modifier] NAVIGATEUR

Ajout d'un template de navigation aux sous-pages d'une page donnée.

{{Requete|commentaire|[[page]]|NAVIGATEUR}}

Attention: Après avoir utilisé cette fonction, il peut être nécessaire de faire une requête DELETE ou REPLACE, pour faire disparaître des liens les caractères en trop qui séparent le titre et le numéro de chapitre par exemple " - ". Par exemple :

{{Requete|Yann|links:[[Le Théâtre en Italie]]|replace|\| - |\|}}

[modifier] SPLIT

Découper un livre en chapitres, selon les sections ==

• {{Requete|commentaire|[[page]]|SPLIT}} : titre du livre + nom des sections
• {{Requete|commentaire|[[page]]|SPLIT| }} : titre du livre + numéro (mettre une espace après |)
• {{Requete|commentaire|[[page]]|SPLIT|nom des divisions}} : titre du livre + "nom des divisions" + numéro
• {{Requete|commentaire|[[page]]|SPLIT|NOPREFIX}} : nom des sections seul

Note 0: si SPLIT ne donne aucun résultat, c'est probablement que vous avez une page découpée en sections ===, au lieu de ==

Note 1 : Le dernier paramètre (exemple : "chapitre") est optionnel. S’il est absent le robot utilise les noms de sections pour créer les pages en plus du titre de l'ouvrage. S'il existe, les sous-pages sont formées avec ce nom suivi d'un numéro. S'il contient seulement une espace, les pages sont créées avec seulement un numéro. Si NOPREFIX est indiqué, le robot crée des pages qui ont les mêmes noms que les chapitres.

Note 2 : Lors d'un split, si une page à créer existe déjà, le robot vérifie que le contenu à ajouter est différent du contenu existant. Si c'est le cas, une nouvelle page est créée, avec le même nom suivi d'un numéro. Sinon aucune page n'est créée.

Note 3 : Il arrive que la création de page échoue, par exemple si les serveurs renvoient une erreur. Dans ce cas, la page principale contient des liens en rouge. Si c'est le cas, il est possible de recommencer l'opération "split", en annulant les changements sur la page principale et en effectuant une nouvelle requête. il est conseillé de ne pas modifier les pages entre-temps, sinon des pages inutiles seront créées, pour la raison indiquée ci-dessus (note 2).

Note 4 : il peut aussi y avoir des liens en rouge si les pages à créer sont vides (sections vides dans le texte de départ)

[modifier] Voir aussi

• Importer des images avec un robot