1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
|
Guide de démarrage rapide WeeChat (version française, pour WeeChat >= 0.2.7)
============================================================================
1. Démarrer weechat
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).
Lancer "weechat-curses" depuis votre shell.
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.*".
Pour chaque option d'un serveur, WeeChat utilise sa valeur si elle est
définie (non "null"). Sinon WeeChat utilise la valeur par défaut
(irc.server_default.xxx).
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"
NB: plusieurs commandes peuvent être séparées par ';' (point-virgule)
Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
/set irc.server.oftc.autojoin "#canal1,#canal2"
Pour supprimer la valeur d'une option du serveur et utiliser sa valeur par
défaut à la place, par exemple pour utiliser les pseudos par défaut
(irc.server_default.nicks) :
/set irc.server.oftc.nicks null
Autres options :
Vous pouvez modifier les autres options avec la commande suivante ("xxx"
est le nom d'une option) :
/set irc.server.oftc.xxx valeur
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, Lua et Tcl). 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-2009, écrit par FlashCode <flashcode@flashtux.org>
Dernière édition le 02/01/2009.
Ce document fait partie de WeeChat et est distribué sous license GPL 3.
|
