Guide simplifié d'utilisation du bot IRC
Commande principale
Le bot réagit à certaines commandes lorsqu'elle sont annoncées sur le canal. Certaines de ces commandes ne sont accessible que pour les utilisateurs configurés (et avec les bons droits) dans le bot, d'autre sont accessible à tous.
Il est aussi possible de parler au bot en privé, ceci notamment impératif pour les commandes où un mot de passe est requis.
!list [<module>] : permet de lister les différents modules / commandes du module.
!help <commande> : affiche l'aide (en anglais) de la commande.
!op : permet de passer opérateur du canal, ou de faire passer quelqu'un opérateur du cannal.
!deop : permet de retirer le statut d'opérateur
!topic
list : permet de lister les différents éléments du topic (séparé par “ | ”)
add <text> : permet de rajouter un texte au topic
remove <number> : permet de retirer l'élément <number> du topic
replace <number> <text> : remplace l'élément <number> par le nouveau <text>
change <number> <regex> : execute l'expression régulière <regex> sur l'élément <number>
!kick <pseudo> [<raison>] : Kick le <pseudo> du chan avec si spécifier la raison
!channelstats : affiche les statistiques du canal
!more : Permet d'afficher les lignes suivantes (lorsque le résultat d'une commande dépasse un certain nombre de ligne). Le bot affiche (X more message)
Enregistrement (utilisateur)
Ces commandes sont a envoyer au bot en message privé.
user register <pseudo> <password> : Permet de s'enregistrer sur le bot
identify <pseudo> <password> : Permet de se connecter
hostmask add <pseudo> [<hostmask>] [<password>] : Permet d'indiquer au bot que le hostmask (combinaison pseudo+adresse ip) est à associer avec le nom d'utilisateur <pseudo>. Ceci permet de pas a avoir à se connecter avec son mot de passe pour être reconnu par le bot.
hostmask remove : Voir add.
admin capability add <pseudo> <capability> : Permet de définir un utilisateur (préalablement enregistré) avec certains droits (user, admin, owner).
admin capability remove <pseudo> <capability> : Voir add.
A savoir, il semble que pour pouvoir passer opérateur, les droits de l'utilisateur doivent être défini sur owner.
Seul un owner peut rajouter un owner.
Commandes pour les réunions IRC
Le bot permet d'organiser des réunions IRC et par la suite d'effectuer un compte rendu automatiquement.
C'est le plugin MeetBot dont la documentation complète est disponible ici http://meetbot.debian.net/Manual.html
Les comptes rendu sont présents ici : http://toulibre.org/pub/irc/ en fin de réunion.
#startmeeting : permet de commencer la réunion (utilisable par tous)
#endmeeting : Devine.
#chair /
#unchair <pseudo> : permet de désigner / retirer une personne supplémentaire comme responsable de la réunion. Le créateur de la réunion est automatiquement responsable.
#meetingtopic <texte> : Permet de définir le thème général de la réunion. Ne peut être utilisé que par le responsable.
#topic <texte> : permet de définir le point actuel à débattre (change le topic). Ne peut être utilisé que par le responsable. Ne pas de faire de liste, le changer une fois le débat clos.
#idea <texte> : permet de noter une idée par rapport au sujet débattu
#action <texte> : permet de noter une action à réaliser (toujours par rapport au sujet en question), si un ou plusieurs pseudo sont présents ils seront assignés à l'action spécifiée.
#info <texte> : note un commentaire
#link <lien> <texte> : permet de noter un site à retenir avec le commentaire associé. Attention à bien commencer par le lien.
Commandes Twitter <-> IRC
Le plugin Twitter est installé ce qui permet de poster des tweets depuis IRC.
Le détail est ici : https://github.com/rubinlinux/supybot-twitter
!post <texte> : Poste le texte sur Twitter, le pseudo de la personne qui a fait cette commande est rajouté au tweet.
!mentions <nombre> : Affiche les <nombre> dernières mentions
!tweets : affiche la timeline (actuellement, ne marche pas, provoque une traceback mais ne plante ni le bot ni le plugin)
!listfriends : liste les comptes following
!listfollowers : liste les followers