Introduction
************

Description
===========

WeeChat (Wee Enhanced Environment for Chat) est un client IRC libre, rapide et léger, concu pour différents systèmes d'exploitation.

Ses principales caractéristiques sont les suivantes :

  - connexion multi-serveurs (avec SSL, IPv6, proxy)

  - plusieurs interfaces : Curses, wxWidgets, Gtk et Qt

  - petit, rapide et léger

  - paramétrable et extensible avec des scripts

  - conforme aux RFCs 1459, 2810, 2811, 2812, et 2813

  - multi-plateformes (Gnu/Linux, *BSD, MacOS X, Windows et d'autres systèmes)

  - 100% GPL, logiciel libre

La page d'accueil de WeeChat est ici :

http://weechat.flashtux.org

Pré-requis
==========

Pour installer WeeChat, vous devez avoir :

  * Un système Gnu/Linux (avec le compilateur et les outils associés pour le paquet des sources)

  * Droits "root" (pour installer WeeChat)

  * Selon l'interface, une des bibliothèques suivantes :

       - Curses: la librairie ncurses,

       - Gtk: *** interface non développée ***,

       - Qt: *** interface non développée ***,

Installation
************

Paquet binaire
==============

Les paquets binaires sont disponibles pour les distributions suivantes :

  * Debian (ou toute distribution compatible Debian)

     Pour installer : dpkg -i /chemin/weechat_x.y.z-1_i386.deb

  * Mandrake/Redhat (ou toute distribution compatible avec les RPM)

     Pour installer : rpm -i /chemin/weechat-x.y.z-1.i386.rpm

  * Gentoo

     Pour installer : emerge weechat

  * *BSD (non disponible !)

  * Slackware (non disponible !)

  * Windows (non disponible !)

où x.y.z est la version (par exemple 0.0.1)

Paquet source
=============

Tapez simplement dans une console ou un terminal :

./configure

make

Note: pour ne construire que certaines interfaces, vous pouvez passer des paramètres à ./configure, tapez ./configure --help pour de l'aide sur ces options.

Obtenez les droits root et installez WeeChat :

su

(entrez le mot de passe de root)

make install

Sources CVS
===========

Attention: les sources CVS sont réservés aux utilisateurs avancés : il se peut que WeeChat ne compile pas et qu'il soit trs̀ instable. Vous êtes prévenus !

Pour récupérer les sources CVS, tapez ces commandes :

cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/weechat login

cvs -z3 -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/weechat co weechat

(lorsqu'un mot de passe est demandé, tapez simplement sur Entrée)

Exécutez ce script :

./autogen.sh

Suivez alors les instructions du paquet sources - see Paquet source.

Utilisation
***********

Lancer WeeChat
==============

Paramètres de ligne de commande
-------------------------------

-c, --config
     Afficher l'aide sur le fichier de config (liste des options)

-h, --help
     Afficher l'aide

-f, --key-functions
     Afficher la liste des fonctions internes WeeChat pour les touches

-i, --irc-commands
     Afficher la liste des commandes IRC

-l, --license
     Afficher la licence de WeeChat

-v, --version
     Afficher la version de WeeChat

-w, --weechat-commands
     Afficher la liste des commandes WeeChat

Lancer WeeChat
--------------

Tapez simplement cette commande pour lancer WeeChat :

weechat-curses (pour l'interface Curses)

ou weechat-wxwidgets (pour l'interface wxWidgets)

ou weechat-gtk (pour l'interface Gtk)

ou weechat-qt (pour l'interface Qt)

Lorsque vous lancez WeeChat pour la première fois, un fichier de configuration par défaut est créé, avec les options par défaut.

Le fichier de configuration par défaut est : ~/.weechat/weechat.rc

Vous pouvez éditer ce fichier pour configurer WeeChat à votre convenance, ou vous pouvez modifier les paramètres dans WeeChat avec la commande /set - see Commandes WeeChat.

Fichier de configuration
========================

Liste des options du fichier de configuration :

look_set_title
     Définit le titre de la fenêtre (terminal pour l'interface Curses) avec le nom et la version

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_startup_logo
     Afficher le logo WeeChat au démarrage

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_startup_version
     Afficher la version de WeeChat au démarrage

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_weechat_slogan
     Slogan WeeChat (si vide, le slogan ne sera pas utilisé)

     Type: chaîne (toute chaîne), valeur par défaut: 'the geekest IRC client!'

look_charset_decode
     Jeu de caractères pour décoder les messages du serveur, exemples: UTF-8, ISO-8859-1 (si non renseigné, les messages ne sont pas convertis)

     Type: chaîne (toute chaîne), valeur par défaut: 'UTF-8'

look_charset_encode
     Jeu de caractères pour encoder les messages envoyés au serveur, exemples: UFT-8, ISO-8859-1 (si non renseigné, le jeu de caractères local est utilisé)

     Type: chaîne (toute chaîne), valeur par défaut: ''

look_charset_internal
     Jeu de caractères interne à WeeChat, devrait être ISO-xxxx même si la locale est UTF-8 (si non renseigné, le jeu de caractères local est utilisé)

     Type: chaîne (toute chaîne), valeur par défaut: 'ISO-8859-1'

look_buffer_timestamp
     Horodatage pour les tampons

     Type: chaîne (toute chaîne), valeur par défaut: '[%H:%M:%S]'

look_color_nicks
     Afficher les utilisateurs avec différentes couleurs

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_color_actions
     Afficher les actions avec différentes couleurs

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_remove_colors_from_msgs
     Supprimer les couleurs dans les messages entrants

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_nicklist
     Afficher la fenêtre des utilisateurs (pour les fenêtres de canaux)

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_nicklist_position
     Position de la fenêtre d'utilisateurs (haut (top), gauche (left), droite (right, par défaut), bas (bottom))

     Type: chaîne (valeurs: 'left', 'right', 'top', 'bottom'), valeur par défaut: 'right'

look_nicklist_min_size
     Taille minimum pour la fenêtre d'utilisateurs (largeur ou hauteur, selon look_nicklist_position (0 = pas de taille minimum))

     Type: entier (valeurs: entre 0 et 100), valeur par défaut: 0

look_nicklist_max_size
     Taille maximum pour la fenêtre d'utilisateurs (largeur ou hauteur, selon look_nicklist_position (0 = pas de taille maximum; si min == max et > 0, alors la taille est fixe))

     Type: entier (valeurs: entre 0 et 100), valeur par défaut: 0

look_no_nickname
     Texte à afficher en lieu et place du nom d'utilisateur lorsque la connexion n'est pas active

     Type: chaîne (toute chaîne), valeur par défaut: '-cmd-'

look_nickmode
     Afficher le mode de l'utilisateur ((half)op/voice) devant chaque utilisateur

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_nickmode_empty
     Afficher un espace si le mode utilisateur n'est pas (half)op/voice

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

look_nick_completor
     La chaîne affichée après la complétion des utilisateurs

     Type: chaîne (toute chaîne), valeur par défaut: ':'

look_infobar
     Active la barre d'infos

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_infobar_timestamp
     Horodatage pour les conversations sauvegardées

     Type: chaîne (toute chaîne), valeur par défaut: '%B, %A %d %Y'

look_infobar_seconds
     Afficher les secondes pour l'heure dans la barre d'infos

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_infobar_delay_highlight
     Délai (en secondes) pour la notification des messages dans la barre d'infos (0 = désactiver les notifications dans la barre d'infos)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 7

col_title
     Couleur pour la barre de titre

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_title_bg
     Couleur de fond pour la barre de titre

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'blue'

col_chat
     Couleur pour le texte de discussion

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_chat_time
     Couleur pour l'heure dans la fenêtre de discussion

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_chat_time_sep
     Couleur pour la séparation de l'heure (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'brown'

col_chat_prefix1
     Couleur pour le 1er et le 3ème caractère du préfixe

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightcyan'

col_chat_prefix2
     Couleur pour le caractère du milieu du préfixe

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_chat_nick
     Couleur pour les noms d'utilisateurs dans les actions (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightcyan'

col_chat_host
     Couleur pour les noms de machines (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'cyan'

col_chat_channel
     Couleur pour les canaux dans les actions (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_chat_dark
     Couleur pour les séparateurs sombres (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'green'

col_chat_highlight
     Couleur pour le pseudo surligné (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'yellow'

col_chat_bg
     Couleur de fond pour la fenêtre de discussion

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_status
     Couleur pour la barre de statut

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_status_delimiters
     Couleur pour les délimiteurs de la barre de statut

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'cyan'

col_status_data_msg
     Couleur pour une fenêtre avec de nouvelles infos (barre de statut)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'yellow'

col_status_highlight
     Couleur pour une fenêtre avec un highlight (barre de statut)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightmagenta'

col_status_data_other
     Couleur pour une fenêtre avec des nouvelles données (pas des infos) (barre de statut)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_status_more
     Couleur pour une fenêtre avec des nouvelles données (barre de statut)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_status_bg
     Couleur de fond pour la fenêtre de statut

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'blue'

col_infobar
     Couleur pour la barre d'infos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'black'

col_infobar_delimiters
     Couleur pour les délimiteurs de la barre d'infos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'blue'

col_infobar_highlight
     Couleur pour la notification dans la barre d'infos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_infobar_bg
     Couleur de fond pour la fenêtre de barre d'infos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'cyan'

col_input
     Couleur pour le texte saisi

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_input_channel
     Couleur pour le texte saisi (nom du canal)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_input_nick
     Couleur pour le texte saisi (pseudo)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightgreen'

col_input_bg
     Couleur de fond pour la fenêtre de saisie

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_nick
     Couleur pour les pseudos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_nick_away
     Couleur pour les pseudos absents

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'cyan'

col_nick_chanowner
     Couleur pour le symbole du propriétaire du canal (spécifique à unrealircd)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightgreen'

col_nick_chanadmin
     Couleur pour le symbole administrateur du canal (spécifique à unrealircd)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightgreen'

col_nick_op
     Couleur pour le symbole opérateur

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightgreen'

col_nick_halfop
     Couleur pour le symbole demi-opérateur

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightmagenta'

col_nick_voice
     Couleur pour le symbole voix

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'yellow'

col_nick_more
     Couleur pour les '+' lors du scroll sur les pseudos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightmagenta'

col_nick_sep
     Couleur pour le séparateur de pseudo

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'blue'

col_nick_self
     Couleur pour le pseudo local

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_nick_private
     Couleur pour l'autre pseudo dans la fenêtre privée

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_nick_bg
     Couleur de fond pour les pseudos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_chat_dcc_selected
     Couleur pour le DCC sélectionné (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_dcc_waiting
     Couleur pour le statut dcc "attente"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightcyan'

col_dcc_connecting
     Couleur pour le statut dcc "connexion"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'yellow'

col_dcc_active
     Couleur pour le statut dcc "actif"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightblue'

col_dcc_done
     Couleur pour le statut dcc "terminé"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightgreen'

col_dcc_failed
     Couleur pour le statut dcc "échoué"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightred'

col_dcc_aborted
     Couleur pour le statut dcc "interrompu"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightred'

history_max_lines
     Nombre maximum de lignes dans l'historique pour un serveur/fenêtre/fenêtre privée (0 = sans limite)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 4096

history_max_commands
     Nombre maximum de commandes utilisateur dans l'historique (0 = sans limite)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 100

log_auto_server
     Enregistrer automatiquement les messages du serveur

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

log_auto_channel
     Enregistrer automatiquement les conversations des canaux

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

log_auto_private
     Enregistrer automatiquement les conversations privées

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

log_plugin_msg
     Enregistrer les messages des plugins (scripts)

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

log_path
     Chemin pour les conversations sauvegardées par WeeChat

     Type: chaîne (toute chaîne), valeur par défaut: '~/.weechat/logs/'

log_timestamp
     Horodatage pour les conversations sauvegardées (voir man strftime pour le format de date/heure)

     Type: chaîne (toute chaîne), valeur par défaut: '%Y %b %d %H:%M:%S'

log_hide_nickserv_pwd
     Masquer le mot de passe affiché par nickserv

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

irc_display_away
     Affiche un message sur tous les canaux pour l'absence/le retour

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

irc_default_msg_away
     Message par défaut pour l'absence

     Type: chaîne (toute chaîne), valeur par défaut: 'away'

irc_default_msg_part
     Message par défaut pour le part (quitte un canal)

     Type: chaîne (toute chaîne), valeur par défaut: 'WeeChat %v'

irc_default_msg_quit
     Message de fin par défaut ('%v' sera remplacé par la version de WeeChat dans la chaîne)

     Type: chaîne (toute chaîne), valeur par défaut: 'WeeChat %v'

irc_away_check
     Intervalle entre deux vérifications des absences (en minutes, 0 = ne jemais vérifier)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 0

irc_lag_check
     Intervalle entre deux mesures de lag (en secondes)

     Type: entier (valeurs: entre 30 et 2147483647), valeur par défaut: 60

irc_lag_min_show
     Lag minimum à afficher (en secondes)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 1

irc_lag_disconnect
     Déconnexion après un lag important (en minutes, 0 = ne jamais se déconnecter)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 5

irc_fifo_pipe
     Créer un tube FIFO pour le contrôle à distance

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

dcc_auto_accept_files
     Accepte automatiquement les fichiers dcc entrants

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

dcc_auto_accept_chats
     Accepte automatiquement les demandes de discussion dcc (à utiliser avec précaution !)

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

dcc_timeout
     Délai d'attente pour les requêtes dcc (en secondes)

     Type: entier (valeurs: entre 1 et 2147483647), valeur par défaut: 300

dcc_blocksize
     Taille de bloc pour les paquets dcc en octets (défaut: 65536)

     Type: entier (valeurs: entre 1024 et 102400), valeur par défaut: 65536

dcc_download_path
     Chemin pour écrire les fichiers reçus par dcc (par défaut: répertoire de l'utilisateur)

     Type: chaîne (toute chaîne), valeur par défaut: '~'

dcc_upload_path
     Chemin pour lire les fichiers lorsqu'ils sont envoyés par dcc (quand aucun chemin n'est spécifié)

     Type: chaîne (toute chaîne), valeur par défaut: '~'

dcc_convert_spaces
     Convertir les espaces en underscores lors d'envoi de fichiers

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

dcc_auto_rename
     Renommer les fichiers reçus s'ils existent déjà (ajoute '.1', '.2', ...)

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

dcc_auto_resume
     Continuer automatiquement les transferts dcc si la connexion avec la machine distante a été perdue

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

proxy_use
     Utiliser un proxy pour se connecter au serveur irc

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

proxy_type
     Type de proxy (http (défaut), socks4, socks5)

     Type: chaîne (valeurs: 'http', 'socks4', 'socks5'), valeur par défaut: 'http'

proxy_ipv6
     Se connecter au proxy en ipv6

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

proxy_address
     Adresse du serveur proxy (IP ou nom)

     Type: chaîne (toute chaîne), valeur par défaut: ''

proxy_port
     Port pour se connecter au serveur proxy

     Type: entier (valeurs: entre 0 et 65535), valeur par défaut: 3128

proxy_username
     Nom d'utilisateur pour le serveur proxy

     Type: chaîne (toute chaîne), valeur par défaut: ''

proxy_password
     Mot de passe pour le serveur proxy

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_name
     Nom associé au serveur IRC (pour affichage seulement)

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_autoconnect
     Connexion automatique au serveur quand WeeChat démarre

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

server_autoreconnect
     Reconnexion automatique au serveur après une déconnexion

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

server_autoreconnect_delay
     Délai (en secondes) avant de tenter une reconnexion au serveur

     Type: entier (valeurs: entre 0 et 65535), valeur par défaut: 30

server_address
     Adresse IP ou nom du serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_port
     Port pour se connecter au serveur

     Type: entier (valeurs: entre 0 et 65535), valeur par défaut: 6667

server_ipv6
     Utiliser le protocole IPv6 pour la communication avec le serveur

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

server_ssl
     Utiliser SSL pour la communication avec le serveur

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

server_password
     Mot de passe pour le serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_nick1
     Pseudo à utiliser sur le serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_nick2
     Pseudo alternatif pour le serveur IRC (si le pseudo est déjà utilisé)

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_nick3
     2nd pseudo alternatif pour le serveur IRC (si le pseudo alternatif est déjà utilisé)

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_username
     Nom d'utilisateur pour le serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_realname
     Nom réel pour le serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_command
     Commande à exécuter en premier lorsque connecté au serveur

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_command_delay
     Délai (en secondes) après exécution de la commande (exemple: donner du temps pour l'authentification)

     Type: entier (valeurs: entre 0 et 5), valeur par défaut: 0

server_autojoin
     Liste des canaux (séparés par des virgules) à rejoindre lorsque connecté au serveur

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_autorejoin
     Rejoindre automatiquement les canaux quand mis dehors

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

server_notify_levels
     Liste des niveaux de notifications (séparés par des virgules) pour les canaux de ce serveur (format: #canal:1,..)

     Type: chaîne (toute chaîne), valeur par défaut: ''

Les couleurs pour l'interface Curses sont :

  - default: couleur par défaut (transparent pour le fond)

  - black: noir

  - red: rouge foncé

  - lightred: rouge clair

  - green: vert foncé

  - lightgreen: vert clair

  - brown: marron

  - yellow: jaune

  - blue: bleu foncé

  - lightblue: bleu clair

  - magenta: violet foncé

  - lightmagenta: violet clair

  - cyan: cyan foncé

  - lightcyan: cyan clair

  - white: blanc

Raccourcis clavier
==================

Flèche gauche / Flèche droite
     Aller au caractère précédent / suivant sur la ligne de commande

Ctrl + flèche gauche / Ctrl + flèche droite
     Aller au mot précédent / suivant sur la ligne de commande

Home / Ctrl + A
     Aller au début de la ligne de commande

End / Ctrl + E
     Aller à la fin de la ligne de commande

Ctrl + K
     Efface jusqu'à la fin de la ligne

Ctrl + L
     Réaffiche toute la fenêtre

Ctrl + U
     Efface jusqu'au début de la ligne

Ctrl + W
     Effacer le mot précédent sur la ligne de commande

Backspace / Delete
     Effacer le mot précédent / suivant sur la ligne de commande

Tab
     Compléter la commande ou le pseudo (Tab à nouveau : trouver la complétion suivante)

Tout caractère
     Insérer le caractère à la position du curseur sur la ligne de commande

Entrée
     Exécuter la commande ou envoyer le message

Flèche haut / Flèche bas
     Rappeler les dernières commandes/messages

PageUp / PageDown
     Afficher l'historique du tampon

F5 / F6
     Aller au tampon précédent / suivant

F7 / F8
     Aller à la fenêtre précédente / suivante

F10
     Effacer le dernier message de la barre d'infos

F11 / F12
     Faire défiler la liste des pseudos

Alt + flèche gauche / Alt + flèche droite
     Identique à F5 / F6

Alt + A
     Sauter au tampon avec activité (avec priorité: highlight, message, autre)

Alt + B
     Aller au mot précédent

Alt + D
     Effacer le mot suivant

Alt + F
     Aller au mot suivant

Alt + H
     Vide la hotlist (notification d'activit� sur les autres tampons)

Alt + J puis Alt + D
     Afficher les DCC en cours

Alt + J puis Alt + S
     Sauter au tampon du serveur

Alt + J then Alt + X
     Sauter au premier canal du serveur suivant (ou tampon du serveur si aucun canal ouvert)

Alt + chiffre (1-9)
     Sauter au tampon avec ce numéro

Alt + J puis nombre (01-99)
     Sauter au tampon avec ce numéro

Alt + R
     Effacer la ligne entière

Alt + PageUp / Alt + PageDown / Alt + Home / Alt + End
     Faire défiler la liste des pseudos

Commandes WeeChat
=================

Commandes internes WeeChat :

alias  [nom_alias [commande [paramètres]]
     créer un alias pour une commande

     nom_alias: nom de l'alias

     commande: nom de la commande (commande WeeChat ou IRC, sans le premier '/')

     paramètres: paramètres pour la commande

buffer  [action | nombre]
     gestion des buffers

     action: action à effectuer:

     move: déplacer le tampon dans la liste (peut être relatif, par exemple -1)

     close: fermer le tampon (pour un canal: équivalent à /part sans message de fin)

     list: liste les tampons ouverts (pas de paramètre affiche cette liste)

     notify: fixer le niveau de notification (0=jamais, 1=highlight, 2=1+msg, 3=2+join/part)

     nombre: sauter au tampon qui a ce numéro

clear  [-all]
     affacer la/les fenêtre(s)

     -all: effacer toutes les fenêtres

connect  [nom_serveur]
     se connecter à un serveur

     nom_serveur: nom du serveur pour se connecter

disconnect  [nom_serveur]
     se déconnecter d'un serveur

     nom_serveur: nom du serveur pour se déconnecter

debug  dump
     affiche des messages de debuggage

     dump: affiche les variables mémoire WeeChat dans le fichier log (les mêmes messages sont affichés lorsque WeeChat plante)

help  [commande]
     afficher l'aide sur les commandes

     commande: nom d'une commande WeeChat ou IRC

key  [touche fonction/commande] [unbind touche] [functions] [reset -yes]
     associer/libérer des touches

     touche: associer cette touche à une fonction interne ou une commande (commençant par "/")

     unbind: supprimer l'association à une touche (si "all", toutes les associations de touches par défaut sont restaurées)

     functions: lister la liste des fonctions internes pour les associations de touches

     reset: restaur les touches aux valeurs par défaut et supprime TOUTES les touches personnelles (utiliser avec précaution !)

perl  [load fichier] | [autoload] | [reload] | [unload]
     liste/charge/décharge des scripts Perl

     fichier: script Perl (fichier) à charger

     Sans paramètre, la commande /perl liste tous les scripts Perl chargés.

python  [load fichier] | [autoload] | [reload] | [unload]
     liste/charge/décharge des scripts Python

     fichier: script Python (fichier) à charger

     Sans paramètre, la commande /python liste tous les scripts Python chargés.

server  [nom_serveur] | [nom_serveur nom/IP port [-auto | -noauto] [-ipv6] [-ssl] [-pwd mot_de_passe] [-nicks pseudo1 [pseudo2 [pseudo3]]] [-username nom_utilisateur] [-realname nom_réel] [-command commande] [-autojoin canal[,canal]] ] | [del nom_serveur]
     liste, ajoute ou retire des serveurs

     nom_serveur: nom du serveur, pour usage interne et affichage

     nom/IP: nom ou adresse IP du serveur

     port: port pour le serveur (nombre entier)

     ipv6: utiliser le protocole IPv6

     ssl: utiliser le protocole SSL

     mot_de_passe: mot de passe pour le serveur

     pseudo1: premier pseudo pour le serveur

     pseudo2: pseudo alternatif pour le serveur

     pseudo3: second pseudo alternatif pour le serveur

     nom_utilisateur: nom d'utilisateur

     nom_réel: nom réel de l'utilisateur

save  [fichier]
     sauvegarder la configuration sur disque

     fichier: fichier pour sauvegarder la configuration

set  [option[=valeur]]
     modifier des paramètres de configuration

     option: nom d'une option

     valeur: valeur pour l'option

unalias  nom_alias
     supprimer un alias

     nom_alias: nom de l'alias à supprimer

window  [list | splith | splitv | [merge [down | up | left | right | all]]]
     gestion des fenêtres

     list: liste les fenêtres ouvertes (pas de paramètre affiche cette liste)

     splith: éclate la fenêtre en deux horizontalement

     splitv: éclate la fenêtre en deux verticalement

     merge: fusionne la fenêtre avec une autre

Commandes IRC :

admin  [cible]
     trouver les informations sur l'administrateur du serveur

     cible: serveur

away  [-all] [message]
     basculer le statut absent

     -all: basculer le statut absent sur tous les serveurs connectés

     message: message pour l'absence (si pas de message donné, le statut d'absence est supprimé)

ban  [canal] [pseudo [pseudo ...]]
     bannit des pseudos ou masques

     canal: nom du canal pour le bannissement

     pseudo: pseudo ou masque pour le bannissement

ctcp  pseudo type
     envoyer un message ctcp

     pseudo: utilisateur pour envoyer le ctcp

     type: "action" ou "version"

dcc  action [pseudo [fichier]]
     démarre le DCC (fichier ou discussion) ou ferme une discussion

     action: 'send' (envoi de fichier) ou 'chat' (discussion) ou 'close' (fermeture discussion)

     pseudo: pseudo pour envoyer le fichier ou discuter

     fichier: nom du fichier (sur la machine locale)

dehalfop  pseudo [pseudo]
     retire le statut de demi-opérateur du canal à/aux nick(s)

deop  pseudo [pseudo]
     retire le statut d'opérateur du canal à/aux nick(s)

devoice  pseudo [pseudo]
     retire la voix du/des pseudo(s)

die
     arrêter le serveur

halfop  pseudo [pseudo]
     donner le statut de demi-opérateur à un/des utilisateur(s)

info  [cible]
     voir les informations décrivant le serveur

     cible: nom du serveur

invite  pseudo canal
     inviter un utilisateur sur un canal

     pseudo: utilisateur à inviter

     channel: canal pour l'invitation

ison  pseudo [pseudo ...]
     vérifier si un utilisateur est actuellement sur IRC

     pseudo: pseudo

join  canal[,canal] [clé[,clé]]
     joindre un canal

     canal: nom du canal à rejoindre

     clé: clé pour rejoindre le canal

kick  [canal] pseudo [commentaire]
     retirer par la force un utilisateur d'un canal

     canal: canal où l'utilisateur se trouve

     pseudo: utilisateur à éliminer

     commentaire: commentaire pour l'élimination

kickban  [canal] pseudo [commentaire]
     retirer par la force un utilisateur d'un canal et le bannir

     canal: canal où l'utilisateur se trouve

     pseudo: utilisateur à éliminer et bannir

     commentaire: commentaire pour l'élimination

kill  pseudo commentaire
     fermer la connexion client-serveur

     pseudo: utilisateur

     commentaire: commentaire pour la mort

links  [[serveur] masque_serveur]
     lister tous les noms de serveurs connus du serveur qui répondent à la requête

     serveur: ce serveur doit répondre à la requête

     masque_serveur: liste des serveurs correspondant au masque

list  [canal[,canall] [serveur]]
     lister les canaux et leur sujet

     canal: canal à lister

     serveur: nom du serveur

lusers  [masque [cible]]
     obtenir des statistiques sur la taille du réseau IRC

     masque: serveurs qui correspondent au masque seulement

     cible: serveur pour faire suivre la requête

me  message
     envoyer une action ctcp au canal courant

     message: message à envoyer

mode  { canal {[+|-]|o|p|s|i|t|n|b|v} [limite] [utilisateur] [masque de banissement] } | { nick {[+|-]|i|w|s|o} }
     changer le mode du canal ou de l'utilisateur

     modes de canaux :

     canal: nom du canal à modifier

     o: donner/reprendre le statut privilégié d'opérateur

     p: indicateur de canal privé

     s: indicateur de canal secret

     i: indicateur de canal avec invitation seulement

     t: le titre est modifiable seulement par un opérateur du canal

     n: aucun message au canal depuis l'extérieur

     m: canal modéré

     l: fixer la limite d'utilisateurs pour le canal

     b: paramétrer un masque de banissement pour garder des utilisateurs dehors

     v: donner/reprendre la possibilité de parler sur un canal modéré

     k: définir une clé (mot de passe) pour accéder au canal

     modes utilisateur :

     pseudo: utilisateur à modifier

     i: marquer un utilisateur comme invisible

     s: marquer un utilisateur pour recevoir les notices du serveur

     w: l'utilisateur reçoit les wallops

     o: drapeau opérateur

motd  [cible]
     obtenir le message du jour

     cible: nom du serveur

msg  cible[,cible] texte
     envoyer un message à un utilisateur ou canal

     cible: utilisateur ou canal (peut-être un masque, '*' = canal courant)

     texte: texte à envoyer

names  [canal[,canal]]
     lister les utilisateurs sur des canaux

     canal: nom du canal

nick  [-all] pseudo
     changer le pseudo courant

     -all: définir le nouveau pseudo sur tous les serveurs connectés

     pseudo: nouveau pseudo

notice  pseudo texte
     envoyer un message notice à un utilisateur

     pseudo: utilisateur cible pour la notice

     texte: texte à envoyer

op  pseudo [pseudo]
     donner le statut opérateur à un/des utilisateur(s)

oper  utilisateur mot_de_passe
     obtenir le statut d'opérateur

     utilisateur/mot_de_passe: utilisé pour obtenir les privilèges sur le serveur IRC courant

part  [canal[,canall] [message_de_fin]
     quitter un canal

     canal: canal à quitter

     message_de_fin: message de fin (affiché aux autres utilisateurs)

ping  serveur1 [serveur2]
     pinguer un serveur

     serveur1: serveur à pinguer

     serveur2: faire suivre le ping à ce serveur

pong  démon [démon2]
     répondre à un message ping

     démon: démon qui a répondu au message Ping

     démon2: faire suivre le message à ce démon

query  pseudo [texte]
     envoyer un message privé à un utilisateur

     pseudo: utilisateur pour la conversation privée

     texte: texte à envoyer

quit  [message_de_fin]
     fermer toutes les connexions et quitter

     message_de_fin: message de fin (affiché aux autres utilisateurs)

quote  données
     envoyer des données brutes au serveur sans analyse

     données: données brutes à envoyer

rehash
     demander au serveur de recharger son fichier de configuration

restart
     demander au serveur de redémarrer

service  pseudo réservé distribution type réservé info
     enregister un nouveau service

     distribution: visibilité du service

     type: réservé pour une utilisation future

servlist  [masque [type]]
     lister les services actuellement connectés au réseau

     masque: lister seulement les services qui correspondent à ce masque

     type: lister seulement les services de ce type

squery  service texte
     envoyer un message à un service

     service: nom du service

     texte: texte à envoyer

squit  serveur commentaire
     déconnecter les liens vers un serveur

     serveur: nom du serveur

     commentaire: commentaire pour quitter

stats  [requête [serveur]]
     demander des statistiques sur le serveur

     requête: c/h/i/k/l/m/o/y/u (voir la RFC1459)

     serveur: nom du serveur

summon  utilisateur [cible [canal]]
     envoyer aux utilisateurs d'un serveur IRC un message leur demandant de rejoindre IRC

     utilisateur: nom d'utilisateur

     cible: nom du serveur

     canal: nom du canal

time  [cible]
     demander l'heure locale de serveur

     cible: demander l'heure de ce serveur

topic  [canal] [titre]
     recevoir/définir le titre du canal

     canal: nom du canal

     titre: nouveau titre pour le canal (si le titre est "-delete" alors le titre est supprimé)

trace  [cible]
     trouver le chemin jusqu'à un serveur spécifique

     cible: serveur

unban  [canal] pseudo [pseudo ...]
     supprime le bannissement sur des pseudos ou masques

     canal: nom du canal pour supprimer le bannissement

     pseudo: pseudo ou masque pour supprimer le bannissement

userhost  pseudo [pseudo ...]
     retourne une liste d'informations sur des utilisateurs

     pseudo: pseudo

users  [cible]
     liste des utilisateurs connectés au serveur

     cible: serveur

version  [serveur | pseudo]
     retourne la version de l'utilisateur ou du serveur (courant ou spécifié)

     serveur: nom du serveur

     pseudo: utilisateur

voice  pseudo [pseudo]
     donne la voix à/aux utilisateur(s)

wallops  texte
     envoyer un message à tous les utilisateurs connectés qui ont activé le mode utilisateur 'w' pour eux-mêmes

     texte à envoyer

who  [masque ["o"]]
     génère une requête qui retourne une liste d'information

     masque: information qui correspond à ce masque uniquement

     o: seul les opérateurs sont retournés correspondant au masque fourni

whois  [serveur] pseudo[,pseudo]
     demande les informations sur le(s) utilisateur(s)

     serveur: nom du serveur

     pseudo: utilisateur (peut être un masque)

whowas  pseudo [,pseudo [,pseudo ...]] [nombre [cible]]
     demander de l'information sur un nick qui n'existe plus

     pseudo: pseudo à chercher

     nombre: nombre de réponses à retourner (recherche complète si nombre négatif)

     cible: la réponse doit correspondre à ce masque

Fonctions internes pour les touches :

return
     terminer la ligne

tab
     compléter le mot

backspace
     effacer le caractère précédent

delete
     effacer le caractère suivant

delete_end_line
     effacer jusqu'à la fin de la ligne

delete_beginning_line
     effacer jusqu'au début de la ligne

delete_line
     effacer la ligne entière

delete_previous_word
     effacer le mot précédent

delete_next_word
     effacer le mot suivant

home
     aller au début de la ligne

end
     aller à la fin de la ligne

left
     se déplacer d'un caractère à gauche

previous_word
     se déplacer au mot précédent

right
     se déplacer d'un caractère à droite

next_word
     se déplacer au mot suivant

up
     appeler la commande précédente dans l'historique

down
     appeler la commande suivante dans l'historique

page_up
     faire défiler d'une page vers le haut

page_down
     faire défiler d'une page vers le bas

infobar_clear
     effacer la barre d'infos

nick_page_up
     faire défiler la liste des pseudos d'une page vers le haut

nick_page_down
     faire défiler la liste des pseudos d'une page vers le bas

nick_beginning
     afficher le début de la liste des pseudos

nick_end
     afficher la fin de la liste des pseudos

refresh
     rafraichir l'écran

jump_smart
     sauter au tampon avec de l'activité

jump_dcc
     sauter au tampon DCC

jump_server
     sauter au tampon du serveur

jump_next_server
     sauter au prochain serveur

hotlist_clear
     effacer la liste d'activité

Tube FIFO
=========

Vous pouvez contrôler WeeChat à distance, en envoyant des commandes ou du texte dans un tube FIFO (l'option "irc_fifo_pipe" doit être activée, elle est désactivée par défaut).

Le tube FIFO est dans le répertoire ~/.weechat/ et s'appelle "weechat_fifo_xxxxx" (où xxxxx est l'ID du processus (PID) du WeeChat qui tourne).

Donc si plusieurs WeeChat tournent, vous avez plusieurs tubes FIFO, un pour chaque session.

La syntaxe pour envoyer des commandes ou du texte dans le tube FIFO est la suivante :

serveur,canal *texte ou commande ici

où le serveur et le canal sont facultatifs, mais si le canal est là, le serveur doit l'être aussi.

Quelques exemples :

* changement du pseudo sur freenode en "pseudo|absent":
     echo "freenode */nick pseudo|absent" >~/.weechat/weechat_fifo_12345

* affichage de texte sur le canal #weechat :
     echo "freenode,#weechat *bonjour tout le monde !" >~/.weechat/weechat_fifo_12345

* affichage de texte sur le canal courant (le tampon affiché par WeeChat):
     echo "*bonjour !" >~/.weechat/weechat_fifo_12345

     Attention : ceci est dangereux et vous ne devriez pas le faire sauf si vous savez ce que vous faites !

* envoyer deux commandes pour décharger/recharger les scripts Perl (vous devez les séparer par \n):
     echo -e "freenode */perl unload\nfreenode */perl autoload" >~/.weechat/weechat_fifo_12345

Vous pouvez écrire un script qui envoie les commandes à tous les WeeChat qui tournent en même temps, par exemple :

 #!/bin/sh
 if [ $# -eq 1 ]; then
     for fifo in $(/bin/ls ~/.weechat/weechat_fifo_* 2>/dev/null); do
         echo -e "$1" >$fifo
     done
 fi
Si le script s'appelle "auto_weechat_command", vous pouvez le lancer ainsi :

./auto_weechat_command "freenode,#weechat *bonjour"

Extensions
**********

Scripts Perl
============

Charger/décharger des scripts Perl
----------------------------------

Les scripts Perl sont chargés et déchargés avec la commande /perl (tapez /help perl dans WeeChat pour obtenir de l'aide sur la commande).

Exemples :

  * Charger un script Perl : /perl load /tmp/essai.pl

  * Décharger tous les scripts Perl : /perl unload

  * Lister les scripts Perl chargés : /perl

Interface WeeChat / Perl
------------------------

  * weechat::register ( nom, version, fonction_de_fin, description );

     C'est la première fonction à appeler dans le script Perl.

     Tout script Perl pour WeeChat doit appeler cette fonction.

     Paramètres :

       - nom: nom unique pour identifier le script (chaque script doit avoir un nom différent)

       - version: version du script

       - fonction_de_fin: fonction Perl appelée quand le script est déchargé (paramètre facultatif, une chaîne vide signifiant qu'il n'y a pas de fonction à appeler)

       - description: description brève du script.

     Exemple :

     weechat::register ("essai", "1.0", "fin_essai", "Script d'essai !");

  * weechat::print ( message, [canal, [serveur]] );

     Affiche un message dans un canal.

     Paramètres :

       - message: message à afficher

       - canal: nom du canal

       - serveur: nom interne du serveur

     Exemple :

     weechat::print ("message");

     weechat::print ("message", "#weechat");

     weechat::print ("message", "#weechat", "freenode");

  * weechat::print_infobar ( délai, message );

     Affiche un message dans la barre d'infos.

     Paramètres :

       - délai: délai (en secondes) pendant lequel le message est affiché (si 0, le message ne sera pas effacé).

       - message: message à afficher

     Exemple :

     weechat::print_infobar (5, "message");

  * weechat::add_message_handler ( nom, fonction );

     Attache une fonction Perl à un message IRC particulier.

     La fonction sera appelée à chaque fois que le message IRC sera reçu.

     Paramètres :

       - nom: nom du message IRC pour lequel la fonction est appelée
          Pour connaître la liste des messages IRC disponibles, merci de consulter les RFC 1459 et/ou 2812 :

          RFC 1459 : ftp://ftp.rfc-editor.org/in-notes/rfc1459.txt

          RFC 2812 : ftp://ftp.rfc-editor.org/in-notes/rfc2812.txt

       - fonction: fonction Perl appelée lorsque le message est reçu

     Exemple :

     weechat::add_message_handler ("privmsg", ma_fonction);

     sub ma_fonction

     {

         weechat::print ("serveur=$_[0]\n");

         ($null, $canal, $message) = split ":",$_[1],3;

         ($masque, $null, $canal) = split " ", $canal;

         weechat::print ("masque=$masque, canal=$canal, message=$message\n");

     }

  * weechat::add_command_handler ( nom, fonction );

     Créé une nouvelle commande WeeChat, associée à une fonction Perl.

     La fonction sera appelée lorsque l'utilisateur lancera la commande par /nom.

     Paramètres :

       - nom: nom de la nouvelle commande
          Il peut s'agir d'une commande existante, auquel cas celle-ci est écrasée par la fonction Perl. Soyez prudent en écrasant les commandes WeeChat, car elles ne seront plus accessibles tant que le script Perl sera chargé.

       - fonction: fonction Perl associée à la commande

     Exemple :

     weechat::add_command_handler ("commande", ma_commande);

     sub ma_commande

     {

         weechat::print("Serveur: $_[0], paramètres: $_[1]\n");

         return 0;

     }

  * weechat::command ( commande, [canal, [serveur]] );

     Exécute une commande ou envoie un message á un canal.

     Paramètres :

       - commande: commande á exécuter (ou message á envoyer au canal)

       - canal: nom du canal

       - serveur: nom interne du serveur

     Exemples :

     weechat::command ("bonjour tout le monde !");

     weechat::command ("/kick toto merci de quitter ce canal", "#weechat");

     weechat::command ("/nick newnick", "", "freenode");

  * weechat::get_info ( nom, [serveur] );

     Obtenir des informations variées sur WeeChat, le serveur ou l'utilisateur.

     Paramètres :

       - nom: nom de l'info à obtenir :

       - serveur: nom interne du serveur

            - 0 ou version: obtenir la version de WeeChat

            - 1 ou nick: obtenir le pseudo

            - 2 ou channel: obtenir le nom du canal

            - 3 ou server: obtenir le nom du serveur

            - 4 ou weechatdir: obtenir le répertoire maison de WeeChat

            - 5 ou away: obtenir le drapeau "away" du serveur

     Exemples :

     $version = get_info("version");

     $nick = get_info("nick", "freenode");

Scripts Python
==============

Charger/décharger des scripts Python
------------------------------------

Les scripts Python sont chargés et déchargés avec la commande /python (tapez /help python dans WeeChat pour obtenir de l'aide sur la commande).

Exemples :

  * Charger un script Python : /python load /tmp/essai.py

  * Décharger tous les scripts Python : /python unload

  * Lister les scripts Python chargés : /python

Interface WeeChat / Python
--------------------------

  * weechat.register ( nom, version, fonction_de_fin, description )

     C'est la première fonction à appeler dans le script Python.

     Tout script Python pour WeeChat doit appeler cette fonction.

     Paramètres :

       - nom: nom unique pour identifier le script (chaque script doit avoir un nom différent)

       - version: version du script

       - fonction_de_fin: fonction Python appelée quand le script est déchargé (paramètre facultatif, une chaîne vide signifiant qu'il n'y a pas de fonction à appeler)

       - description: description brève du script.

     Exemple :

     weechat.register ("essai", "1.0", "fin_essai", "Script d'essai !")

  * weechat.prnt ( message, [canal, [serveur]] )

     Affiche un message dans un canal.

     Paramètres :

       - message: message à afficher

       - canal: nom du canal

       - serveur: nom interne du serveur

     Exemple :

     weechat.prnt ("message")

     weechat.prnt ("message", "#weechat")

     weechat.prnt ("message", "#weechat", "freenode")

  * weechat.print_infobar ( délai, message )

     Affiche un message dans la barre d'infos.

     Paramètres :

       - délai: délai (en secondes) pendant lequel le message est affiché (si 0, le message ne sera pas effacé).

       - message: message à afficher

     Exemple :

     weechat.print_infobar (5, "message")

  * weechat.add_message_handler ( nom, fonction )

     Attache une fonction Python à un message IRC particulier.

     La fonction sera appelée à chaque fois que le message IRC sera reçu.

     Paramètres :

       - nom: nom du message IRC pour lequel la fonction est appelée
          Pour connaître la liste des messages IRC disponibles, merci de consulter les RFC 1459 et/ou 2812 :

          RFC 1459 : ftp://ftp.rfc-editor.org/in-notes/rfc1459.txt

          RFC 2812 : ftp://ftp.rfc-editor.org/in-notes/rfc2812.txt

       - fonction: fonction Python appelée lorsque le message est reçu

     Exemple :

     weechat.add_message_handler ("privmsg", ma_fonction)

     def ma_fonction(serveur, args):

         weechat.prnt("serveur="+serveur)

         null, canal, message = string.split(args, ":", 2)

         masque, null, canal = string.split(string.strip(canal), " ", 2)

         weechat.prnt("masque="+masque+", canal="+canal+", message="+message)

  * weechat.add_command_handler ( nom, fonction )

     Créé une nouvelle commande WeeChat, associée à une fonction Python.

     La fonction sera appelée lorsque l'utilisateur lancera la commande par /nom.

     Paramètres :

       - nom: nom de la nouvelle commande
          Il peut s'agir d'une commande existante, auquel cas celle-ci est écrasée par la fonction Python. Soyez prudent en écrasant les commandes WeeChat, car elles ne seront plus accessibles tant que le script Python sera chargé.

       - fonction: fonction Python associée à la commande

     Exemple :

     weechat.add_command_handler ("commande", ma_commande)

     def ma_commande(serveur, args):

         weechat.prnt("serveur:"+serveur+" paramètres:"+args)

  * weechat.command ( commande, [canal, [serveur]] )

     Exécute une commande ou envoie un message á un canal.

     Paramètres :

       - commande: commande á exécuter (ou message á envoyer au canal)

       - canal: nom du canal

       - serveur: nom interne du serveur

     Exemples :

     weechat.command ("bonjour tout le monde !")

     weechat.command ("/kick toto merci de quitter ce canal", "#weechat")

     weechat.command ("/nick newnick", "", "freenode")

  * weechat.get_info ( nom, [serveur] )

     Obtenir des informations variées sur WeeChat, le serveur ou l'utilisateur.

     Paramètres :

       - nom: nom de l'info à obtenir :

       - serveur: nom interne du serveur

            - 0 ou version: obtenir la version de WeeChat

            - 1 ou nick: obtenir le pseudo

            - 2 ou channel: obtenir le nom du canal

            - 3 ou server: obtenir le nom du serveur

            - 4 ou weechatdir: obtenir le répertoire maison de WeeChat

            - 5 ou away: obtenir le drapeau "away" du serveur

     Exemples :

     $version = weechat.get_info("version")

     $nick = weechat.get_info("nick", "freenode")

Scripts Ruby
============

Non développé !

Auteurs / Support
*****************

Auteurs
=======

WeeChat est développé par :

  * FlashCode <flashcode AT flashtux.org>

Obtenir du support
==================

Avant de faire appel au support, merci de lire la documentation et la FAQ de WeeChat.

(la documentation est le document que vous êtes en train de lire, si vous n'avez pas tout lu jusqu'ici, il est encore temps de recommencer !)

  * Support par IRC:

     - serveur : irc.freenode.net

     - canal : #weechat

  * Forum WeeChat : http://forums.flashtux.org

  * Support par la liste de diffusion :

     - pour souscrire/désinscrire :
     http://mail.nongnu.org/mailman/listinfo/weechat-support.

     - pour envoyer un mail à la liste de diffusion, envoyer à :
     weechat-support@nongnu.org.

     Les archives de la liste de diffusion sont ici :

     http://mail.nongnu.org/archive/html/weechat-support

  * Voir la page support WeeChat pour plus de détails :

     http://weechat.flashtux.org/support.php