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
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
|
WeeChat FAQ (Questions Fréquemment Posées)
==========================================
Sébastien Helleu <flashcode@flashtux.org>
Général
-------
[[why_choose_weechat]]
Pourquoi choisir WeeChat ? X-Chat et Irssi sont si bien...
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Parce que WeeChat est très léger et a de nouvelles fonctionnalités.
Quelques fonctionnalités (version > = 0.3.x) :
* support multi-protocoles via extensions (IRC, Jabber)
* plusieurs interfaces déportées en plus de Curses (à venir bientôt)
* disponible en plusieurs langues
* extensible par des extensions (C, Perl, Python, Ruby, Lua, Tcl)
* tampons avec contenu libre
* filtrage de l'affichage avec tags et expressions régulières
* découpage de la fenêtre horizontalement et verticalement
* barres personnalisables et extensibles
* liste des pseudos disponible dans toutes les interfaces
* recherche incrémentale de texte dans les tampons, saut aux highlights
* tube FIFO pour contrôle à distance
* support aspell
* double encodage (décodage/encodage)
* développé à partir de zéro (non basé sur un quelconque client)
* multi-platformes
* 100% GPL et libre
Plus d'infos sur cette page : http://www.weechat.org/features
[[compilation_install]]
Compilation / installation
--------------------------
[[gui]]
J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je les compiler/utiliser ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Aujourd'hui seule l'interface Curses est disponible.
D'autres interfaces seront disponibles en mode distant (actuellement
en développement).
[[compile_git]]
Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
La méthode recommandée pour compiler WeeChat est d'utiliser cmake.
Si vous compilez avec les autotools (et non cmake), vérifiez que vous avez bien
la dernière version d'autoconf et automake (WeeChat est développé avec autoconf
2.61 et automake 1.10.1).
Une autre façon de faire est de compiler le "paquet devel", qui nécessite moins
de dépendences. Ce paquet est construit quasiment tous les jours à partir de la
base git. Notez que ce paquet peut ne pas correspondre exactement à la base
git et qu'il est moins pratique que de cloner la base git pour installer des
mises à jour.
[[lost]]
J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Pour obtenir de l'aide tapez `/help`. Pour de l'aide sur une commande, tapez
`/help commande`. Les touches et commandes sont listées dans la documentation.
Il est recommandé pour les nouveaux utilisateurs de lire le guide de démarrage
rapide (voir la page de doc sur le site).
[[display]]
Affichage
---------
[[charset]]
Je ne vois pas bien certains accents dans WeeChat, que faire ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
C'est un problème courant, merci de lire attentivement et vérifier *TOUS* les
points ci-dessous.
Pour les versions < 0.2.3, merci d'installer la dernière version stable.
Pour les versions > = 0.2.3 :
* vérifiez que weechat-curses est lié avec libncursesw (attention : nécessaire
sur beaucoup de distributions, mais pas toutes) :
`ldd /chemin/vers/weechat-curses`
* vérifiez que l'extension "Charset" est chargée avec la commande `/plugin`
(s'il ne l'est pas, vous devez peut-être installer le paquet
"weechat-plugins")
* vérifiez la ligne charset (sur le tampon serveur), vous devriez voir
'ISO-XXXXXX' ou 'UTF-8' pour le charset du terminal. Si vous voyez
'ANSI_X3.4-1968' ou d'autres valeurs, votre locale est probablement erronée.
* affectez la valeur pour le décodage global, par exemple :
** avec WeeChat < = 0.2.6 : `/setp charset.global.decode = ISO-8859-15`
** avec WeeChat > = 0.3.x : `/set charset.default.decode "ISO-8859-15"`
* si vous utilisez la locale UTF-8 :
** vérifiez que votre terminal est compatible UTF-8
(un terminal conseillé pour l'UTF-8 est rxvt-unicode)
** si vous utilisez screen, vérifiez qu'il est lancé en mode UTF-8
("`defutf8 on`" dans ~/.screenrc ou `screen -U` pour lancer screen)
[NOTE]
La locale UTF-8 est recommandée pour WeeChat. Si vous utilisez ISO ou une autre
locale, assurez-vous que *tout* soit configuré en ISO (terminal, screen, ...)
et *pas* en UTF-8.
[[bars_background]]
Des barres telles que le titre et le statut ne sont pas remplies, la couleur de fond s'arrête après le texte, pourquoi ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez la
sortie de `echo $TERM` dans votre terminal).
Selon la façon de lancer WeeChat, vous devriez avoir :
* si WeeChat tourne en local ou sur une machine distante sans screen :
cela dépend du terminal utilisé : 'xterm', 'rxvt', etc...
* si WeeChat tourne sous screen, vous devriez avoir 'screen'.
Si besoin, corrigez la variable TERM : `export TERM="xxx"`.
[[screen_weird_chars]]
Quand j'utilise weechat sous screen, j'ai des caractères bizarres et aléatoires, comment corriger ça ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez la
sortie de `echo $TERM` dans votre terminal).
Par exemple 'xterm-color' provoque ce genre de problèmes, utilisez
'xterm' qui est ok (comme plein d'autres valeurs).
Si besoin, corrigez la variable TERM : `export TERM="xxx"`.
[[osx_display_broken]]
J'ai compilé WeeChat sous OS X, et je vois des "(null)" partout sur l'écran, pourquoi ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Si vous avez compilé ncursesw vous-même, essayez avec le ncurses standard (celui
fourni avec le système).
De plus, sous OS X, il est recommandé d'installer WeeChat avec le gestionnaire
de paquets Homebrew.
[[buffer_vs_window]]
J'ai entendu parler de "buffer" et "window", quelle est la différence ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Un tampon ('buffer') est composé d'un numéro, un nom, des lignes affichées
(ainsi que d'autres données).
Une fenêtre ('window') est une zone de l'écran affichant un tampon. Il est
possible de découper l'écran horizontaleent ou verticalement en plusieurs
fenêtres.
Chaque fenêtre affiche un tampon. Un tampon peut être caché (affiché par
aucune fenêtre) ou affiché par une ou plusieurs fenêtres.
[[terminal_copy_paste]]
Comment puis-je copier/coller du texte sans coller la liste des pseudos ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme
rxvt-unicode, konsole, gnome-terminal, etc...). La touche est habituellement
ctrl + alt + sélection à la souris.
Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par
exemple :
* avec WeeChat < = 0.2.6 : +
`/set look_nicklist_position = top`
* avec WeeChat > = 0.3.x : +
`/bar set nicklist position top`
[[urls]]
Comment puis-je cliquer sur les longs URLs (plus d'une ligne) ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
WeeChat affiche l'heure et un préfixe pour chaque ligne avec des barres
optionnelles autour de la zone de discussion, donc il n'est pas possible
d'afficher les longs URLs sans les tronquer.
Vous pouvez utiliser un des scripts suivants :
urlbar.py::
affiche les URLs dans une barre
urlgrab.py::
enregistre les URLs et les ouvre dans un navigateur
url_shorten.rb::
tinyurl.py::
shortenurl.py::
réduit les URLs longs
Liste des scripts manipulant des URLs :
http://www.weechat.org/scripts/stable/tag/url
[[change_locale_without_quit]]
Je souhaite changer la langue des messages affichés par WeeChat, mais sans quitter WeeChat, est-ce possible ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Oui, il faut utiliser le script python shell.py (disponible sur le site de
WeeChat) et taper ces commandes une fois le script chargé :
----------------------------------------
/shell setenv LANG=fr_FR.UTF-8
/upgrade
----------------------------------------
Pour avoir des messages anglais avec encodage UTF-8 pour le terminal, pour les
utilisateurs en ISO, vous pouvez taper : `/shell setenv LANG=fr_FR`.
[[key_bindings]]
Raccourcis clavier
------------------
[[meta_keys]]
Quelques touches meta (alt + touche) ne fonctionnent pas, pourquoi ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Si vous utilisez certains terminaux comme xterm ou uxterm, quelques touches
meta ne fonctionnent pas par défaut. Vous pouvez ajouter cette ligne dans le
fichier '~/.Xresources':
* pour xterm:
----------------------------------------
XTerm*metaSendsEscape: true
----------------------------------------
* pour uxterm:
----------------------------------------
UXTerm*metaSendsEscape: true
----------------------------------------
Puis recharger les ressources (`xrdb -override ~/.Xresources`) ou redémarrez X.
[[customize_key_bindings]]
Comment puis-je configurer les raccourcis clavier ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Les raccourcis clavier sont modifiables avec la commande `/key`.
La touche par défaut Meta-k (souvent Alt-k) permet de capturer le code d'une
touche et de l'inclure dans la ligne de commande.
[[irc]]
IRC
---
[[ignore_vs_filter]]
Quelle est la différence entre les commandes /ignore et /filter ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
La commande `/ignore` est une commande IRC, donc elle s'applique uniquement aux
tampons IRC (serveurs et canaux).
Elle permet d'ignorer des pseudos ou nom d'hôtes pour un serveur ou un canal
(la commande ne s'applique pas au contenu des messages).
Les messages corespondants sont supprimés par l'extension IRC avant affichage
(donc vous ne les verrez jamais).
La commande `/filter` est une commande "core", donc elle s'applique à n"importe
quel tampon.
Elle permet de filtrer des lignes dans les tampons à l'aide de tags ou
d'expression régulière pour le préfixe et contenu de la ligne.
Les lignes filtrées sont simplement cachées, pas supprimées, et il est possible
de les voir en désactivant les filtres (par défaut, la touche alt + "="
active/désactive les filtres).
[[filter_irc_join_part_quit]]
Comment puis-je filter les messages join/part/quit sur les canaux IRC ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Selon la version de WeeChat :
* avec WeeChat < = 0.2.6 : +
`/ignore * join #weechat freenode` +
`/ignore * part #weechat freenode` +
`/ignore * quit #weechat freenode` +
(le canal et/ou le serveur peuvent être "*", `/help ignore` pour l'aide)
* avec WeeChat > = 0.3.x :
** filtre intelligent (pour garder les join/part/quit des utilisateurs qui ont
parlé récemment) : +
`/set irc.look.smart_filter on` +
`/filter add irc_smart * irc_smart_filter *` +
(`/help irc.look.smart_filter` et `/help filter` pour l'aide)
** filtre global (pour cacher *tous* les join/part/quit) : +
`/filter add irc_jpk * irc_join,irc_part,irc_quit *` +
(`/help filter` pour l'aide)
[[filter_irc_channel_names]]
Comment puis-je filtrer les noms affichés quand je rejoins un canal IRC ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Vous devez ajouter un filtre sur l'étiquette "irc_366" :
----------------------------------------
/filter add irc_names * irc_366 *
----------------------------------------
[[filter_voice_messages]]
Comment puis-je filtrer les messages voice (par exemple sur le serveur Bitlbee) ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Il n'est pas facile de filtrer les messages voice, car le mode voice peut être
positionné avec d'autres modes dans le même message IRC.
Si vous souhaitez faire cela, c'est probablement parce que Bitlbee utilise le
voice pour montrer les utilisateurs absents, et vous recevez plein de messages
voice. Par conséquent, vous pouvez changer cela et laisser WeeChat utiliser une
couleur spéciale pour les pseudos absents dans la liste des pseudos.
Sur le canal '&bitlbee', faites :
----------------------------------------
set away_devoice false
----------------------------------------
Pour vérifier les pseudos absents dans WeeChat, voir la question à propos des
<<color_away_nicks,pseudos absents>>.
[[color_away_nicks]]
Comment puis-je voir les pseudos absents dans la liste des pseudos ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Vous devez positionner l'option 'irc.server_default.away_check' avec une valeur
positive (minutes entre chaque vérification des pseudos absents).
Vous pouvez aussi positionner l'option 'irc.server_default.away_check_max_nicks'
pour limiter la vérification d'absence sur les petits canaux seulement.
Par exemple, pour vérifier les pseudos absents toutes les 5 minutes, pour les
canaux avec maximum 25 pseudos :
----------------------------------------
/set irc.server_default.away_check 5
/set irc.server_default.away_check_max_nicks 25
----------------------------------------
[NOTE]
Pour WeeChat < = 0.3.3, les options sont 'irc.network.away_check' et
'irc.network.away_check_max_nicks'.
[[highlight_notification]]
Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Selon la version de WeeChat :
* avec WeeChat < = 0.2.6 : utilisez le script 'sound.pl' (disponible sur la
page des scripts), puis configurez une commande système (jouant un son,
affichant un message à l'écran, etc...) comme ceci : +
`/setp perl.sound.cmd_highlight = "/chemin/vers/commande parametres"`
* avec WeeChat > = 0.3.x : utilisez le script 'launcher.pl' (disponible sur la
page des scripts), puis configurez une commande système (jouant un son,
affichant un message à l'écran, etc...) comme ceci : +
`/set plugins.var.perl.launcher.signal.weechat_highlight "/chemin/vers/commande parametres"`
De nombreux autres scripts de notification existent, merci de consulter la
liste des extensions/scripts : http://www.weechat.org/scripts
[[plugins_scripts]]
Extensions / scripts
--------------------
[[openbsd_plugins]]
J'utilise OpenBSD et WeeChat ne charge aucune extension, pourquoi ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Sous OpenBSD, le nom des extensions se termine par ".so.0.0" (".so" sous
Linux).
Vous devez configurer ça :
* avec WeeChat < = 0.2.6 : +
`/set plugins_extension = ".so.0.0"`
* avec WeeChat > = 0.3.x : +
`/set weechat.plugin.extension ".so.0.0"`
Puis: `/plugin autoload`.
[[load_scripts]]
Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ? Les scripts sont-ils compatibles avec d'autres clients IRC ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Les commandes `/perl`, `/python`, `/ruby`, `/lua` et `/tcl` permettent de
charger les scripts (le chemin par défaut est '~/.weechat/<langage>/').
Les scripts ne sont pas compatibles avec d'autres clients IRC.
Notes :
* les scripts dans '~/.weechat/<langage>/autoload/' sont automatiquement chargés
par WeeChat lorsqu'il démarre.
* l'extension 'tcl' est disponible à partir de la version 0.3.0.
[[settings]]
Réglages
--------
[[memory_usage]]
Comment configurer WeeChat pour consommer moins de mémoire ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire :
* utiliser la dernière version stable (elle est supposée avoir moins de fuites
de mémoire que les versions plus anciennes)
* ne pas charger les extensions si vous ne les utilisez pas, par exemple :
aspell, fifo, logger, perl, python, ruby, lua, tcl, xfer (utilisé pour les
DCC)
* charger uniquement les scripts dont vous avez vraiment besoin
* réduire la valeur de l'option 'weechat.history.max_lines' (nombre de lignes
sauvées en mémoire pour chaque tampon)
* réduire la valeur de l'option 'weechat.history.max_commands' (nombre de
commandes utilisateur sauvées en mémoire)
[[development]]
Développement
-------------
[[bug_task_patch]]
Comment puis-je reporter un bug, demander une nouvelle fonctionnalité ou envoyer un patch ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Il y a 3 possibilités :
. vous pouvez nous joindre sur IRC : 'irc.freenode.net', canal '#weechat'
. vous pouvez utiliser le site savannah :
* reporter un bug: https://savannah.nongnu.org/bugs/?group=weechat
* demander une nouvelle fonctionnalité: https://savannah.nongnu.org/task/?group=weechat
* envoyer un patch: https://savannah.nongnu.org/patch/?group=weechat
. vous pouvez envoyer un mail aux développeurs, consultez la page support
pour les mails des développeurs : http://www.weechat.org/about
(vous pouvez souscrire et envoyer à la liste de diffusion nommée "support")
[[supported_os]]
Quelle est la liste des plate-formes supportées par WeeChat ? Sera-t-il porté sur d'autres systèmes d'exploitation ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
La liste complète est sur cette page : http://www.weechat.org/download
Nous faisons le maximum pour supporter le plus de plate-formes possible.
Toute aide est la bienvenue pour les systèmes que nous n'avons pas, pous y
tester WeeChat.
[[help_developers]]
Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Il y a plusieurs choses à faire (test, code, documentation, etc...)
Merci de prendre contact avec nous par IRC ou mail, consultez la page
support : http://www.weechat.org/about
[[donate]]
Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Vous pouvez donner de l'argent pour aider le développement.
Plus de détails sur http://www.weechat.org/donate
|