Wantzel

Wantzel, est le nom du bot IRC de la Quadrature du Net.

Commandes

!rp

!rp permet d'inclure une url dans notre revue de presse. Utiliser c (!rpc) si elle cite la Quadrature («Selon la Quadrature, [...]»), utiliser p (!rpp) si ça parle de la Quadrature («La Quadrature est un collectif qui [...]»). On peut également utiliser les deux à la fois : !rpcp

!stats

!stats permet de voir des statistiques d'articles publiés/non publiés dernièrement.

!tc

Pour signaler un événement dans les débats à l'Assemblée Nationale, tapez !tc<espace>suivi du texte décrivant l'évènement : n'oubliez pas le Nom de l'intervenant ainsi que le verbe décrivant son action.

Par exemple : « !tc Albanel parle de fabrication d'adresses IP », ou encore : « !tc Billard / Brard défendent les auteurs plutôt que les majors »"

!help

!help wantzel pour obtenir de l'aide.

Améliorations

Liste des idées d'améliorations à apporter au bot

!rp(c|p|cp) <note> <url>

Ajouter la possibilité d'indiquer une note, comprise entre -1 et 2, lors de l'enregistrement d'une URL dans rp/. Dans la mesure où 50% des gens qui enregistrent des articles savent comment fonctionne notre notation, et que les autres peuvent l'apprendre rapidement, les cas d'abus seront très rare.

Est-il préférable qu'on ne retienne que la note du dernier ayant tenté d'ajouter un même article, ou doit-on faire la moyenne des notes proposées ?

!todo

Faire une fonction qui permette de lister les tâches simples et rapides à faire que le bot pourra diffuser de temps à autres sur le/les chans. Avec une version pour avoir une réponse discrète en query.

Exemples de commandes :

• !todo add
• !todo done
• !todo update

multichan et broadcast

Permettre au bot de joindre plusieurs chans à la fois (#lqdn, #lqdn-travail, ...).

Broadcast d'un canal vers les autres.

Récupération automatique d'URL

Voir comment associer au mieux un nouveau canal d'ajout automatique d'entrées dans la RP (via GNews, et d'autres si on en trouve, ixquick ? Exalead ? Voila.fr ? Dir.com).

Trafiquer le bot ? Ou simplement pouvoir lui envoyer des messages en query pour ne pas encombrer le canal (et donc coder un plugin irssi).

Poster des messages courts sur identi.ca

Avec devanture officielle LQDN ? Non pour la devanture officielle, en tout cas, pas si tout le chan peut publier.

Plutôt twitter chaque publication de CP, et chaque ajout de RP. (Géré par Drupal ?)

RT le lendemain à 13h les entrées (nocturnes: 22h-6h) de la RP.

Coder le !help :-p

Le !help (alias !aide) ne doit pas flooder le chan. Il doit dire ce qu'il a a dire en une ligne. Il peut éventuellement :

• Renvoye actuellement sur cette page.
• Prendre des options (par exemple !help rp ou !help !rp).
• Répondre en privé tout le temps (toute demande d'aide est satisfaite en privé), ou seulement lorsqu'on lui demande (par exemple en faisant !help en query. Autre exemple, quelqu'un, que nous appellerons kevin, demande comment fonctionne !rp, n'importe qui pourra alors utiliser !help rp kevin pour demander au bot d'expliquer à kevin en query comment ça fonctionne).

Futur

Tout ce qui se trouve sous la prochaine ligne fait partie de la future documentation à valider : ---

Wantzel, est le nom du bot IRC de la Quadrature du Net chargé d'aider les bénévoles.

Fonctionnement

Il est possible, grâce à Wantzel, de soumettre des urls à la revue de presse de La Quadrature du Net. Chaque url pointe vers une ressource plus ou moins liée aux sujets de La Quadrature. Si plusieurs personnes soumettent la même url, cela veut dire qu'il y a potentiellement des informations pertinentes sur ce sujet et l'url sera alors utilisée pour la revue de presse.

Lorsqu'une url est soumise au bot, celui-ci l'enregistre et lui attribue une note de 1. À chaque fois que quelqu'un soumet à nouveau l'url, son score se voit augmenté de 1. Dès que le score atteint une valeur supérieure ou égale à 3, on considère que l'information est suffisamment pertinente pour être publiée.

Pour obtenir plus d'informations concernant le fonctionnement de la revue de presse, il suffit d'aller sur la page correspondante ou bien de se connecter sur le canal IRC #lqdn-rp afin d'y poser vos questions.

De plus, Wantzel sert à tweeter les articles de la revue de presse. Pour cela, il s'appuie sur le flux RSS de la revue de presse du site web de La Quadrature en français *et* en anglais (il suit donc deux flux RSS). Ainsi, la date de publication sur le site sert à Wantzel pour savoir quoi twitter et quand. Tout article publié à une date antérieure ne sera pas twitté.

Les commandes

Les commandes de Wantzel sont regroupées sous deux catégories :

• Celles utilisables par tout un chacun sur le canal
  • rp et ses variantes
  • help
  • status
  • stats
• Celles que seuls les administrateurs peuvent utiliser
  • kill
  • admin
  • flag

Les commandes utilisables par tout le monde

rp

Cette commande permet de soumettre une url à la revue de presse. L'url peut se situer avant ou après la commande. Wantzel va rechercher la première url située dans le message commençant par http.

Il est possible de spécifier certaines informations en même temps :

• !rpc : si l'url cite La Quadrature («Selon la Quadrature, [...]»)
• !rpp : si l'url parle de La Quadrature («La Quadrature est un collectif qui [...]»)
• !rpa : si l'url est à archiver pour information (celle-ci ne sera donc pas publiée)
• !rpm : si l'url pointe vers un média destiné au mediakit

Il est également possible d'utiliser n'importe quelle combinaison d'options: !rpcp, !rppac, !rpam, etc...

help

Cette commande fournit une aide succinte à l'utilisateur en message privé (query) afin de ne pas surcharger le canal de discussion utilisé.

De plus, la commande redirige vers cette page pour plus d'informations.

status

Cette commande permet de connaitre le statut d'une url au niveau de la revue de presse. Le retour se fait sous la forme :

   note X / cite LQdN / parle de LQdN / archivé / publié (url) / non publié

Les informations s'affichent uniquement suivant les flags, par exemple le statut d'un article qui parle de LQdN et qui est publié se présentera ainsi :

   note 5 / parle de LQdN / publié (https://www.laquadrature.net/fr/node/9849)

stats

Cette commande permet d'afficher les statistiques des articles non publiés dernièrement pour les notes supérieures ou égales à 0, 3, et 4, et pour les périodes des 1, 3, 7, et 15 derniers jours.

Typiquement, Wantzel comptabilise les urls soumises et non publiées depuis moins de 3 jours et dont la note vaut 0 par exemple.

Les commandes soumises à droit d'accès

kill

Cette commande permet de fixer la note d'une url à -100, ce qui réduit très fortement les possibilités qu'elle soit finalement publiée. Cette commande sert généralement lors d'une erreur.

flag

Cette commande permet de manipuler les flags d'une url sans toucher à sa note. Utiliser deux fois la même commande inverse la modification faite précédemment. Utilisée conjointement avec la commande status elle permet aux administrateurs de bien spécifier les informations d'une url en cas d'erreur.

Il existe actuellement 4 drapeaux utilisables :

• c : l'url cite LQdN
• p : l'url parle de LQdN
• a : l'url ne doit pas être publiée, elle est simplement archivée
• m : l'url pointe un média intéressant, elle ne doit être traitée que lorsque le média est présent sur le médiakit.

admin

Cette commande permet d'utiliser des sous-commandes :

• list
• add
• del
• timer

list

Liste les identifiants IRC considérés comme des administrateurs.

add

Ajoute les identifiants donnés (séparés par une virgule) à la liste des administrateurs.

del

Retire les identifiants donnés (séparés par une virgule) de la liste des administrateurs.

timer

Cette commande sert à relancer le timer de Wantzel. Lorsqu'on se rend compte que Wantzel est peut-être bloqué et qu'aucun administrateur n'est à disposition, il peut être intéressant de relancer le timer. À utiliser avec beaucoup de parcimonie, cela ne résoud pas tous les problèmes !

Présence

Le bot est présent sur les canaux ci-après : #laquadrature, #lqdn-rp, #lqdn-travail