Guide de démarrage rapide WeeChat (version française)
=====================================================

1. Démarrer weechat

     Lancer "weechat-curses" depuis votre shell.

     Un émulateur de terminal recommandé pour X (mais pas obligatoire) est
     rxvt-unicode (il a un bon support UTF-8, et aucun problème avec les
     touches par défaut).

2. Aide en ligne / options

     WeeChat dispose d'aide pour toutes les commandes, tapez simplement /help
     Pour avoir de l'aide sur une commande, tapez /help commande

     Pour modifier des options, utilisez /set config.section.option = valeur
     (où "config" est le nom de la configuration ("weechat" pour le coeur, ou
     un nom d'extension), "section" la section de cette configuration et
     "option" le nom de l'option).

     WeeChat utilise immédiatement la nouvelle valeur (vous n'avez *jamais*
     besoin de redémarrer WeeChat après avoir changé la configuration).

     Vous pouvez utiliser /set avec un nom partiel d'option et le caractère
     joker "*" au début ou à la fin pour afficher toutes les options contenant
     ces lettres.
     Par exemple :
       /set            => affiche toutes les options (WeeChat et extensions)
       /set weechat.*  => affiche les options WeeChat
       /set irc.*      => affiche les options de l'extension IRC

     Vous pouvez afficher de l'aide sur une option avec /help, par exemple :
       /help weechat.look.highlight

     Toutes les options sont sauvées quand WeeChat quitte (ou avec la commande
     "/save" pour forcer une écriture des options).

     Vous pouvez éditer les fichiers de configuration (*.conf) à la main et les
     recharger par la commande /reload si vous ne souhaitez pas utiliser la
     commande /set.

3. Coeur vs extensions

     Le coeur de WeeChat ("core") ne fait qu'afficher les données à l'écran et
     interagir avec l'utilisateur, cela signifie que le coeur sans extension
     n'a pas grand intérêt (utilisateurs fidèles: IRC faisait partie du coeur
     dans les versions <= 0.2.6).

     Tous les protocoles réseau comme IRC sont fournis sous forme d'extensions.

     Utilisez la commande /plugin pour voir les extensions chargées, vous
     devriez voir "irc" et d'autres extensions dans cette liste.

4. Créer un serveur IRC

     Vous pouvez ajouter un serveur IRC par la commande /server, par exemple :
       /server add oftc irc.oftc.org  6667

     Comme d'habitude, de l'aide est disponible si vous êtes perdus :
       /help server

5. Définir les options du serveur IRC

     WeeChat utilise des valeurs par défaut pour tous les serveurs, si vous ne
     spécifiez pas de valeur spécifique pour une option de serveur.
     Ces options par défaut sont "irc.server_default.*".

     Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et
     vous pouvez les écraser pour le serveur oftc avec la commande suivante :
       /set irc.server.oftc.nicks = "pseudo1,pseudo2,pseudo3,pseudo4,pseudo5"

     Pour modifier le nom d'utilisateur et nom réel :
       /set irc.server.oftc.username = "Mon nom d'utilisateur"
       /set irc.server.oftc.realname = "Mon nom réel"

     Pour activer la connexion automatique au serveur lors du démarrage :
       /set irc.server.oftc.autoconnect = on

     Pour lancer une commande après connexion au serveur, par exemple pour
     s'identifier auprès de nickserv :
       /set irc.server.oftc.command = "/msg nickserv identify xxxxxx"

     Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
       /set irc.server.oftc.autojoin = "#canal1,#canal2"

     Autres options :
       Vous pouvez modifier les autres options avec la commande suivante :
         /set irc.server.oftc.xxx = valeur
       où "xxx" est le nom d'une option - vous pouvez vois les options possibles
       avec :
         /set irc.server_default.*

6. Se connecter au serveur IRC et rejoindre les canaux

     /connect oftc

     Note : cette commande peut aussi être utilisée pour créer et se connecter
     au serveur sans utiliser la commande /server (devrais-je répéter que vous
     pouvez voir l'aide pour cette commande avec /help connect ? ;)

7. Joindre/quitter les canaux IRC

     Joindre un canal :
       /join #channel
     Quitter un canal :
       /part [message de fin]
     Quitter un canal et fermer le tampon :
       /close [message de fin]
     (/close est un alias sur /buffer close)

8. Gérer les tampons/fenêtres

     Un tampon ("buffer") est un composant lié à une extension, avec une
     catégorie et un nom. Le tampon contient les données affichées à l'écran.

     Une fenêtre ("window") est une vue sur un tampon. Par défaut il n'y a
     qu'une fenêtre affichant un tampon. Si vous divisez l'écran, vous verrez
     alors plusieurs fenêtres avec plusieurs tampons en même temps.

     Commandes pour gérer les tampons et les fenêtres :
       /buffer
       /window
     (je ne répéterai pas que vous pouvez avoir de l'aide sur ces commandes
     avec /help)

     Par exemple, pour découper verticalement l'écran en une petite fenêtre
     (1/3 de la largeur) et une large (2/3), utilisez la commande :
       /window splitv 33

9. Raccourcis clavier

     WeeChat utilise un certain nombre de touches par défaut. Toutes ces
     touches sont dans la documentation, mais vous devriez connaître au moins
     les touches vitales :
     - alt + flèches gauche/droite (ou F5/F6): aller au tampon précédent/suivant
     - F7/F8: aller à la fenêtre précédente/suivante (quand l'écran est divisé)
     - F9/F10: faire défiler la barre de titre
     - F11/F12: faire défiler la liste des pseudos
     - tab: compléter le texte de la barre d'entrée, comme avec votre shell
     - page préc/suiv: faire défiler le texte dans le tampon courant
     - alt + A: sauter au tampon avec de l'activité (dans la "hotlist")
     
     Selon votre clavier et/ou vos besoins, vous pouvez associer n'importe
     quelle touche à une commande avec la commande "/key".
     Une touche utile est meta-k (alt-k) pour trouver le code des touches.

     Par exemple, pour associer meta-y (alt-y) à la commande "/buffer close" :
       /key (pressez meta-k) (pressez meta-y) /buffer close
     Vous aurez une ligne de commande qui ressemble à ceci :
       /key meta-y /buffer close
     Pour enlever la touche :
       /key unbind meta-y

10. Extensions/scripts

     Sur certaines distributions comme Debian, les extensions sont disponibles
     via un paquet séparé (par exemple weechat-plugins).
     Les extensions sont automatiquement chargées lorsqu'elles sont trouvées.

     Des extensions permettent d'utiliser des scripts dans WeeChat (dans
     différent langages comme Perl, Python, Ruby et Lua). Ces extensions
     doivent être chargées avec la commande /plugin et elles fournissent des
     commandes telles que /perl, utilisées pour charger les scripts.

     Plusieurs extensions/scripts (de contributeurs) sont disponibles pour
     WeeChat, voir ici :
       http://weechat.flashtux.org/plugins.php

     Merci de regarder la documentation WeeChat pour charger/décharger des
     extensions ou des scripts.

11. Plus de documentation

     Vous pouvez maintenant utiliser WeeChat et lire la FAQ/documentation pour
     toute autre question :
       http://weechat.flashtux.org/faq.php
       http://weechat.flashtux.org/doc.php

     Bon WeeChat !

--
(c) 2006-2008, écrit par FlashCode <flashcode@flashtux.org>
Dernière édition le 11/10/2008.
Ce document fait partie de WeeChat et est distribué sous license GPL 3.
