# Utilisation

Ce chapitre explique comment lancer WeeChat, les touches utilisées par défaut, les commandes internes et IRC, le fichier de configuration et l'utilisation du tube FIFO.

## Lancer WeeChat

Paramètres de ligne de commande :

Paramètre | Description
--- | ---
`-a, --no-connect` | Supprimer la connexion automatique aux serveurs lors du démarrage
`-d, --dir <répertoire>` | Définir le répertoire comme étant la base de WeeChat (utilisé pour les fichiers de configuration, logs, extensions et scripts de l'utilisateur). La valeur par défaut est "`~/.weechat`". NB: le répertoire est créé s'il n'est pas trouvé par WeeChat.
`-h, --help` | Afficher l'aide
`-k, --keys` | Afficher les touches par défaut de WeeChat
`-l, --license` | Afficher la licence de WeeChat
`-p, --no-plugin` | Supprimer le chargement automatique des extensions au démarrage
`-v, --version` | Afficher la version de WeeChat
`extension:option` | Option pour l'extension (voir la doc de chaque extension)

Il est également possible de passer une URL pour un ou plusieurs serveurs IRC, de la forme :

    irc[6][s]://[pseudo[:mot_passe]@]irc.exemple.org[:port][/canal][,canal[...]

Exemple pour rejoindre #weechat et #toto sur le serveur "`irc.freenode.net`", port par défaut (6667), sous le pseudo "nono" :

    $ weechat-curses irc://nono@irc.freenode.net/#weechat,#toto

Pour lancer WeeChat, tapez cette commande :

- pour l'interface Curses : `weechat-curses`

- pour l'interface Gtk : `weechat-gtk`

- pour l'interface wxWidgets : `weechat-wxwidgets`

- pour l'interface Qt : `weechat-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.conf`"

Vous pouvez éditer ce fichier pour configurer WeeChat à votre convenance ou vous pouvez modifier les paramètres dans WeeChat avec la commande "`/set`" (voir )

## Raccourcis clavier

Touche | Action
--- | ---
Flèche gauche / Ctrl + B | Aller au caractère précédent sur la ligne de commande
Flèche droite / Ctrl + F | Aller au caractère suivant sur la ligne de commande
Ctrl + flèche gauche | Aller au mot précédent sur la ligne de commande
Ctrl + flèche droite | Aller au mot suivant sur la ligne de commande
Home / Ctrl + A | Aller au début de la ligne de commande
Ctrl + C puis B | Insérer le code pour mettre le texte en gras.
Ctrl + C puis C | Insérer le code pour écrire en couleur.
Ctrl + C puis O | Insérer le code pour réinitaliser la couleur.
Ctrl + C puis R | Insérer le code pour écrire en couleur inversée.
Ctrl + C puis U | Insérer le code pour écrire en souligné.
End / Ctrl + E | Aller à la fin de la ligne de commande
Ctrl + K | Effacer du curseur jusqu'à la fin de la ligne de commande
Ctrl + L | Réafficher toute la fenêtre
Ctrl + R | Chercher du texte dans l'historique du tampon (deux appuis successifs pour rechercher du texte exact)
Ctrl + S puis Ctrl + U | Positionner le marqueur de données non lues sur tous les tampons
Ctrl + T | Inverser deux caractères
Ctrl + U | Effacer du curseur jusqu'au début de la ligne de commande
Ctrl + W | Effacer le mot précédent sur la ligne de commande
Ctrl + Y | Coller le contenu du presse-papiers
Backspace / Ctrl + H | Effacer le caractère précédent sur la ligne de commande
Delete / Ctrl + D | Effacer le caractère suivant sur la ligne de commande
Tab | Compléter la commande ou le pseudo (Tab de nouveau: trouver la complétion suivante)
Shift + Tab | Sans complétion, effectue une complétion partielle. Avec une complétion en cours, complète avec la complétion précécente.
Tout caractère | Insérer le caractère à la position du curseur sur la ligne de commande
Entrée / Ctrl + J / Ctrl + M | Exécuter la commande ou envoyer le message (en mode recherche: arrêter la recherche)
Flèche haut / flèche bas | Rappeler les dernières commandes ou messages (en mode recherche: chercher en haut/bas)
Ctrl + flèche haut / Ctrl + flèche bas | Rappeler les dernières commandes ou messages dans l'historique global (commun à tous les tampons)
PageUp / PageDown | Monter / descendre d'une page dans l'historique du tampon
Alt + PageUp / Alt + PageDown | Monter / descendre de quelques lignes dans l'historique du tampon
Alt + Home / Alt + End | Aller au début / à la fin du tampon
F5 / Alt + flèche gauche | Aller au tampon précédent
F6 / Alt + flèche droite | Aller au tampon suivant
F7 | Aller à la fenêtre précédente
F8 | Aller à la fenêtre suivante
F9 / F10 | Faire défiler le titre du canal
F11 / F12 | Faire défiler la liste des pseudos
Alt + F11 / Alt + F12 | Aller au début / à la fin de la liste des pseudos
Alt + A | Sauter au prochain 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 | Vider la hotlist (notification d'activité sur les autres tampons)
Alt + I | Effacer le dernier message de la barre d'informations
Alt + J puis Alt + L | Sauter au dernier tampon
Alt + J puis Alt + P | Sauter au tampon affiché précédemment
Alt + chiffre (0-9) | Sauter au tampon qui porte ce numéro (0 = 10)
Alt + J puis nombre (01-99) | Sauter au tampon qui porte ce numéro
Alt + K | Capturer une touche et insérer son code sur la ligne de commande
Alt + N | Se positionner sur le highlight suivant
Alt + P | Se positionner sur le highlight précédent
Alt + R | Effacer entièrement la ligne de commande
Alt + S | Changer de serveur sur le tampon des serveurs (si l'option "look_one_server_buffer" est activée)
Alt + U | Se positionner sur la première ligne non lue du tampon
Alt + W puis Alt + flèche | Sauter à une fenêtre avec une direction
Alt + = | Active/désactive les filtres

## La ligne de commande

La ligne de commande WeeChat (située en bas de la fenêtre) permet d'exécuter des commandes ou d'envoyer du texte vers le tampon.

Les commandes débutent par un caractère "/", suivi du nom de la commande. Par exemple pour afficher la liste de toutes les options :

    /set

Le texte envoyé à un tampon est tout texte ne commençant pas par le caractère "/", par exemple pour envoyer "`bonjour`" sur le tampon courant :

    bonjour

Il est cependant possible de faire débuter un texte par "/" en le doublant. Par exemple pour envoyer le texte "`/set`" sur le tampon courant :

    //set

Pour certaines extensions comme IRC, il est possible d'utiliser des codes couleur et attributs cmome suit (appuyer sur Ctrl-C puis sur la lettre qui suit et éventuellement une valeur) :

Code | Description
--- | ---
^Cb | texte gras
^Ccxx | couleur du texte "`xx`" (voir le tableau des couleurs ci-dessous)
^Ccxx,yy | couleur du texte "`xx`" et du fond "`yy`" (voir le tableau des couleurs ci-dessous)
^Co | désactiver la couleur et tous les attributs
^Cr | vidéo inverse (inversion de la couleur d'écriture et du fond)
^Cu | texte souligné

NB: le même code (sans le numéro pour ^Cc) peut être utilisé pour stopper l'attribut défini.

Les codes couleur pour ^Cc sont :

Code | Couleur
--- | ---
00 | blanc
01 | noir
02 | bleu foncé
03 | vert foncé
04 | rouge clair
05 | rouge foncé
06 | magenta
07 | orange
08 | jaune
09 | vert clair
10 | cyan
11 | cyan clair
12 | bleu clair
13 | magenta clair
14 | gris
15 | gris clair (blanc)

Exemple : affichage de "`bonjour tout le monde !`" avec "`bonjour`" en bleu clair gras, et "`tout le monde`" en rouge clair souligné :

    ^Cc12^Cbbonjour^Cb^Cc04^Cu tout le monde^Cu^Cc !

## Commandes WeeChat

Ce chapitre liste toutes les commandes WeeChat.

## Fichier de configuration

Liste des options du fichier de configuration :

Option | Type | Valeurs | Défaut | Description
--- | --- | --- | --- | ---

Les couleurs pour l'interface Curses sont :

Mot clé | Couleur
--- | ---
`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