======= WeeChat =======
====== Installation ======
La version présente sur **perso** est la 0.3.8 qui est ancienne par rapport à la dernière version 0.4.3 (au 22/02/2014).

===== Sur son serveur personnel =====
Utilisation des paquets :
  - Utiliser votre gestionnaire de paquet favori et cherchez weechat ou bien
  - Récupérer sur http://www.weechat.org/download/ les paquets correspondant à votre distribution
  - Les installer avec votre gestionnaire de paquets, par exemple : ''dpkg -i weechat-curses_0.4.0-1_amd64.deb''



===== Sur perso, compiler à partir des sources =====
<code>
mkdir -p ~/build/weechat/
cd ~/build/weechat/
wget http://www.weechat.org/files/src/weechat-0.4.3.tar.bz2
tar xvfj weechat-0.4.3.tar.bz2
cd weechat-0.4.3
mkdir build
cd build
cmake .. -DPREFIX=~/usr/ -DCMAKE_BUILD_TYPE=Debug
make
make install
</code>

ou 

<code>
mkdir -p ~/build/weechat/
cd ~/build/weechat/
wget https://weechat.org/files/src/weechat-2.3.tar.bz2
tar xvfj weechat-0.4.3.tar.bz2
cd weechat-0.4.3
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=~/usr/ -DCMAKE_BUILD_TYPE=Debug
make
make install
</code>

Et dans son fichier ''.bashrc'', ajouter :
<code>
alias weechat="$HOME/usr/bin/weechat-ncurses"
</code>

====== Configuration ======
===== Locale =====
Afin que weechat gère correctement l'utf-8, vous devez avoir une bonne locale configurée.
Vous pouvez paramétrer ces variables avant de lancer weechat ou bien carrément les renseigner dans botre ''.bashrc''.
<code>
export LANG=en_GB.utf8
export LANGUAGE=en_GB.utf8
export LC_ALL=en_GB.utf8
</code>
Vous pouvez vérifier la valeur de ces variables avec la commande ''locale''. La valeur de ces variable doit être une des valeure affichée par ''locale -a''.
===== Screen =====
Lancer weechat dans un screen compatible utf-8:
<code>
screen -U -S weechat weechat
</code>
===== Pour ceux qui ont l'habitude d'irssi =====
La première commande à taper pour ne pas être perturbé :
<code>
/alias win buffer
/alias wc /buffer close
</code>
Oui sous WeeChat les salons de discussions sont dans des tampons (buffers) et non des fenêtres (windows sous irssi). Les fenêtres existent aussi sous weechat mais n'ont pas le même rôle.
===== Ajout d'un serveur IRC =====
<code>
/server add iiens irc.iiens.net/7000 -ssl
/set irc.server.iiens.ssl_dhkey_size 1024
</code>
C'est important de mettre l'option ssl_dhkey_size à 1024 sinon vous ne pourrez pas vous connecter en ssl.
===== Connexion =====
<code>
/connect iiens
</code>

===== Petites astuces =====
==== Zoom++ ====

Petite astuce pour retirer/mettre les bars des buffers et la nicklist.
C'est pratique quand on veut avoir rapidement juste la fenêtre de discussion. Utile si on est dans un petit terminal, comme sur les smartphones.

Création de la commande **/zoom2** :
<code>
/alias zoom2 /window zoom;/set weechat.bar.buffers.hidden toggle;/set weechat.bar.nicklist.hidden toggle
</code>

Création du raccourci **Alt+z** :
<code>
/key bind meta-z /zoom2
</code>


====== Plugins intéressants ======

Les plugins sont gérés avec la commande ''/script'' sur weechat 0.4.0+. Les instructions sont disponible avec ''/help script''.

===== iset =====
Plugin permettant de se balader en ncurses dans la configuration de WeeChat.

===== autojoin_on_invite =====
Pour rejoindre automatiquement un chan suite à une invitation.

===== buffers =====
Liste des buffers ouverts qui s'affiche à gauche.

===== cmd_help =====
Aide interactive pour la ligne de commande.

===== colorize_nicks =====
Utilise la couleur pour les pseudos cité dans l'aire de chat.

===== completion =====
Pour faire de l'autocomplétion sur les mots.

===== go =====
Un script sympa pour switcher de buffer facilement.

===== grep =====
Pour faire une recherche dans un buffer ou un log.

===== kikoo =====
Un classique.

===== prism =====
Pour écrire un texte multicolore.

===== screen_away =====
Pour être mis/retiré du status away automatiquement quand on se détache ou se rattache à son screen.

===== shell =====
Permet de lancer des commandes shell directement depuis weechat.

===== weefish =====
Pour avoir une communication chiffrée de bout en bout en utilisant FiSH.

===== zerotab =====
Permet d'insérer le pseudo de la dernière personne ayant parlé sur le chat lorsque l'on appuie sur tab lorsque la ligne est vide.