1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-12 14:14:48 +02:00

Update FAQ (new format for website and some updates/additions)

This commit is contained in:
Sebastien Helleu
2009-03-01 09:26:04 +01:00
parent b0c058fc20
commit 1a69bbcb1e
2 changed files with 433 additions and 420 deletions
+207 -201
View File
@@ -1,257 +1,263 @@
WeeChat FAQ, 2009-01-31
WeeChat FAQ, 2009-03-01
=======================
Intended audience:
Users of WeeChat >= 0.2.7.
Before reading the following:
The following Q/A list is *not* exhaustive.
It is also possible that you won't find any Q/A that matches your problem.
Please read them anyway, they may provide you help in fixing your problem
anyway.
And even if your problem is listed below, it is possible that the answers don't
help you anymore to solve it. Then, please contact us, we will try to help you
finding a solution.
1 - Compiling
2 - Using WeeChat
3 - Development
1.1
================================================================================
Q: I heard about many GUI for WeeChat. How can I compile/use them?
A: Today only Curses GUI is available.
Other GUI will be available as remote client (currently udner
development).
1 - General
2 - Compilation / install
3 - Using WeeChat
4 - Development
1.2
================================================================================
Q: I can't compile WeeChat after cloning git repository.
------------------------------------------------------------------------------
1.1: Why choosing WeeChat? X-Chat and Irssi are so good...
A: If you're compiling with autotools (and not cmake), check that you have
latest version of autoconf and automake.
WeeChat has been developed with autoconf version 2.61 and automake
version 1.10.
You should have at least these versions in order to compile WeeChat.
If you can't or don't want to install these versions, you can download
and install "devel package", a package built almost every day using git
repository.
Note that this package may not correspond exactly to git base.
Because WeeChat is very light and has new features.
Some features (version >= 0.2.7):
* multi-protocols support via plugins (IRC, Jabber)
* many deported GUI in addition to Curses (coming soon)
* available in many languages
* extensible with plugins (C, Perl, Python, Ruby, Lua, Tcl)
* buffers with free content
* display filtering by tags and regular expressions
* horizontal and vertical window split
* customizable and extensible bars
* nicklist available in all GUI
* incremental text search in buffers, jump to highlights
* FIFO pipe for remote control
* aspell support
* double charset (encoding/decoding)
* developed from scratch (not based on any other client)
* multi-platform
* 100% GPL and free
More info on this page: http://weechat.flashtux.org/features.php
2.1
================================================================================
Q: Why using WeeChat ? X-Chat and Irssi are so good...
------------------------------------------------------------------------------
2.1: I heard about many GUI for WeeChat. How can I compile/use them?
A: Because WeeChat is very light and has new features.
Some new features:
* multi-protocols support via plugins (IRC, Jabber)
* many deported GUI in addition to Curses (coming soon)
* available in many languages
* extensible with plugins (C, Perl, Python, Ruby, Lua, Tcl)
* buffers with free content
* display filtering by tags and regular expressions
* horizontal and vertical window split
* customizable and extensible bars
* nicklist available in all GUI
* infobar highlight
* incremental text search in buffers, jump to highlights
* FIFO pipe for remote control
* aspell support
* double charset (encoding/decoding)
* developed from scratch (not based on any other client)
* multi-platform
* 100% GPL and free
More info on this page: http://weechat.flashtux.org/features.php
Today only Curses GUI is available. Other GUI will be available as remote
client (currently udner development).
2.2
================================================================================
Q: I've launched WeeChat, but I'm lost, what can I do?
------------------------------------------------------------------------------
2.2: I can't compile WeeChat after cloning git repository, why?
A: For help you can type /help. For help about a command, type /help command.
Keys and commands are listed in documentation.
If you're new to WeeChat, it's recommended to read quickstart guide
(see doc page on website).
Recommended way to compile WeeChat is with cmake.
If you're compiling with autotools (and not cmake), check that you have latest
version of autoconf and automake (WeeChat is developed with autoconf 2.61 and
automake 1.10.1).
Other way is to install "devel package", which needs less dependencies. This
package is built almost every day using git repository. Note that this package
may not correspond exactly to git base and that it's less convenient than git
cloning for installing updates.
2.3
================================================================================
Q: I heard about "buffers" and "windows", what's the difference?
------------------------------------------------------------------------------
3.1: I've launched WeeChat, but I'm lost, what can I do?
A: A window is used when you split screen vertically or horizontally.
A buffer is a "view" for a window. Each window displays a buffer, and
many windows may display same buffer.
Examples of buffers: server messages, channel, xfer control, ..
For help you can type /help. For help about a command, type /help command.
Keys and commands are listed in documentation.
It's recommended for new users to read quickstart guide (see doc page on
website).
2.4
================================================================================
Q: I don't see some chars with accents, what can I do?
------------------------------------------------------------------------------
3.2: I heard about "buffers" and "windows", what's the difference?
A: For versions < 0.2.3, please upgrade to last stable version.
For versions >= 0.2.3 :
- check that weechat-curses is linked to libncursesw (warning: needed
on most distributions but not all) :
ldd /path/to/weechat-curses
- check that "Charset" plugin is loaded with /plugin command
(if it is not, then you probably need "weechat-plugins" package)
- check charset line (on server buffer), you should see ISO-XXXXXX or
UTF-8 for terminal charset. If you see ANSI_X3.4-1968 or other values,
probably your locale is wrong.
- setup global decode value, for example:
with WeeChat <= 0.2.6: /setp charset.global.decode = ISO-8859-15
with WeeChat >= 0.2.7: /set charset.default.decode "ISO-8859-15"
- if you are using UTF-8 locale, check that your terminal is UTF-8
ready. Terminal recommended for UTF-8 is rxvt-unicode.
A window is used when you split screen vertically or horizontally.
A buffer is a "view" for a window. Each window displays a buffer, and many
windows may display same buffer.
Examples of buffers: server messages, channel, xfer control, ..
2.5
================================================================================
Q: Bars like title and status are not filled, background color stops after
text, why?
------------------------------------------------------------------------------
3.3: I don't see some chars with accents, what can I do?
A: This may be caused by bad value of TERM variable (look at echo $TERM).
Depending on where you launch WeeChat, you should have:
- if WeeChat runs locally or on a remote machine without screen, it
depends on terminal used: "xterm", "rxvt", ..
- if WeeChat runs under screen, you should have "screen".
If needed, fix your TERM variable (export TERM="xxx").
For versions < 0.2.3, please upgrade to last stable version.
For versions >= 0.2.3:
- check that weechat-curses is linked to libncursesw (warning: needed on most
distributions but not all):
ldd /path/to/weechat-curses
- check that "Charset" plugin is loaded with /plugin command (if it is not,
then you probably need "weechat-plugins" package)
- check charset line (on server buffer), you should see ISO-XXXXXX or UTF-8
for terminal charset. If you see ANSI_X3.4-1968 or other values, probably
your locale is wrong.
- setup global decode value, for example:
with WeeChat <= 0.2.6:
/setp charset.global.decode = ISO-8859-15
with WeeChat >= 0.2.7:
/set charset.default.decode "ISO-8859-15"
- if you are using UTF-8 locale, check that your terminal is UTF-8 ready.
Terminal recommended for UTF-8 is rxvt-unicode.
2.6
================================================================================
Q: When I'm using weechat under screen, I have weird chars, when I switch
window for example, how to fix that?
------------------------------------------------------------------------------
3.4: Bars like title and status are not filled, background color stops after
text, why?
A: This may be caused by bad value of TERM variable (look at echo $TERM).
For example, "xterm-color" displays such weird chars, use "xterm" which
is ok (like many other values).
If needed, fix your TERM variable (export TERM="xxx").
This may be caused by bad value of TERM variable (look at echo $TERM).
Depending on where you launch WeeChat, you should have:
- if WeeChat runs locally or on a remote machine without screen, it depends on
terminal used: "xterm", "rxvt", ..
- if WeeChat runs under screen, you should have "screen".
If needed, fix your TERM variable (export TERM="xxx").
2.7
================================================================================
Q: How can I customize key bindings?
------------------------------------------------------------------------------
3.5: When I'm using weechat under screen, I have weird chars, when I switch
window for example, how to fix that?
A: Key bindings are customizable with /key command.
Default key Meta-k (usually Alt-k) lets you grab key code and insert it
in input zone.
This may be caused by bad value of TERM variable (look at echo $TERM).
For example, "xterm-color" displays such weird chars, use "xterm" which is ok
(like many other values).
If needed, fix your TERM variable (export TERM="xxx").
2.8
================================================================================
Q: How can I load Perl/Python/Ruby/Lua/Tcl scripts?
Are scripts compatible with other IRC clients ?
------------------------------------------------------------------------------
3.6: How can I customize key bindings?
A: You can use commands /perl, /python, /ruby, /lua and /tcl to load
scripts (default path for scripts is ~/.weechat/<language>/).
Note that scripts in ~/.weechat/<language>/autoload are automatically
loaded when WeeChat is starting up.
Scripts are not compatible with other IRC clients.
Key bindings are customizable with /key command.
Default key Meta-k (usually Alt-k) lets you grab key code and insert it in
command line.
2.9
================================================================================
Q: I want to change language used by WeeChat for messages, but without
exiting WeeChat, is it possible?
------------------------------------------------------------------------------
3.7: I'm using OpenBSD and WeeChat does not load any plugin, what's wrong?
A: Yes, you have to use python script shell.py (available on WeeChat
website) and issue these commands when script is loaded:
/shell setenv LANG=en_US.UTF-8
/upgrade
(to have english messages with UTF-8 encoding for terminal, for ISO
users, you can issue: /shell setenv LANG=en_US)
Under OpenBSD, plugin filename ends with ".so.0.0" (".so" for Linux).
You must setup that:
- with WeeChat <= 0.2.6:
/set plugins_extension = ".so.0.0"
/plugin autoload
- with WeeChat >= 0.2.7:
/set weechat.plugin.extension ".so.0.0"
/plugin autoload
2.10
================================================================================
Q: With Curses GUI, how can I copy/paste text without pasting nicklist ?
------------------------------------------------------------------------------
3.8: How can I load Perl/Python/Ruby/Lua/Tcl scripts? Are scripts compatible
with other IRC clients?
A: You can use a terminal with rectangular selection (like rxvt-unicode,
konsole, ...).
Other solution is to move nicklist to top or bottom, for example:
with WeeChat <= 0.2.6: /set look_nicklist_position = top
with WeeChat >= 0.2.7: /bar set nicklist position top
You can use commands /perl, /python, /ruby, /lua and /tcl to load scripts
(default path for scripts is ~/.weechat/<language>/).
Scripts are not compatible with other IRC clients.
Notes:
- scripts in ~/.weechat/<language>/autoload are automatically loaded when
WeeChat is starting up.
- plugin "tcl" is available with version 0.2.7 or newer.
2.11
================================================================================
Q: How to be warned when someone highlights me on a channel ?
------------------------------------------------------------------------------
3.9: I want to change language used by WeeChat for messages, but without
exiting WeeChat, is it possible?
A: You can use sound.pl script (available on scripts page), and then
setup a system command (to play sound, display message, ..) with this
command :
with WeeChat <= 0.2.6:
/setp perl.sound.cmd_highlight = "/path/command arguments"
with WeeChat >= 0.2.7:
/set plugins.var.perl.sound.cmd_highlight "/path/command arguments"
Yes, you have to use python script shell.py (available on WeeChat website) and
issue these commands when script is loaded:
/shell setenv LANG=en_US.UTF-8
/upgrade
To have english messages with UTF-8 encoding for terminal, for ISO users, you
can issue:
/shell setenv LANG=en_US
3.1
================================================================================
Q: How should I report bugs?
------------------------------------------------------------------------------
3.10: With Curses GUI, how can I copy/paste text without pasting nicklist?
A: There is 3 ways to report bugs:
1. you can join us on IRC: irc.freenode.net, channel #weechat
2. you can submit your bug at this URL:
http://savannah.nongnu.org/bugs/?func=addbug&group=weechat
3. you can mail your problem, look at support page for developer's mails:
http://weechat.flashtux.org/support.php
(you can subscribe and send to "support" mailing list)
You can use a terminal with rectangular selection (like rxvt-unicode,
konsole, ...). Key is usually ctrl + alt + mouse selection.
Other solution is to move nicklist to top or bottom, for example:
- with WeeChat <= 0.2.6:
/set look_nicklist_position = top
- with WeeChat >= 0.2.7:
/bar set nicklist position top
3.2
================================================================================
Q: How should I submit patches?
------------------------------------------------------------------------------
3.11: How to be warned when someone highlights me on a channel?
A: There is 3 ways to submit patches:
1. you can join us on IRC: irc.freenode.net, channel #weechat
2. you can submit your patch at this URL:
http://savannah.nongnu.org/patch/?func=addpatch&group=weechat
3. you can mail your patch, look at support page for developer's mails:
http://weechat.flashtux.org/support.php
(you can subscribe and send to "support" mailing list)
You can use sound.pl script (available on scripts page), and then setup a
system command (to play sound, display message, ..) with this command:
- with WeeChat <= 0.2.6:
/setp perl.sound.cmd_highlight = "/path/command arguments"
- with WeeChat >= 0.2.7:
/set plugins.var.perl.sound.cmd_highlight "/path/command arguments"
3.3
================================================================================
Q: How should I submit new feature request?
------------------------------------------------------------------------------
3.12: How can I filter join/part/quit messages on IRC channels?
A: There is 2 ways to submit your feature request:
1. you can join us on IRC: irc.freenode.net, channel #weechat
2. you can mail your feature request, look at support page for developer's
mails:
http://weechat.flashtux.org/support.php
(you can subscribe and send to "support" mailing list)
According to WeeChat version:
- with WeeChat <= 0.2.6:
/ignore * join #weechat freenode
/ignore * part #weechat freenode
/ignore * quit #weechat freenode
(channel and/or server may be "*")
(/help ignore for help)
- with WeeChat >= 0.2.7:
- smart filter (keep join/part/quit from users who spoke recently):
/set irc.look.smart_filter on
/filter add irc_smart * irc_smart_filter *
(/help irc.look.smart_filter and /help filter for help)
- global filter (hide ALL join/part/quit):
/filter add jpk * irc_join,irc_part,irc_quit *
(/help filter for help)
3.4
================================================================================
Q: What is the list of supported platforms for WeeChat?
Will WeeChat be ported to other operating systems?
------------------------------------------------------------------------------
4.1: How should I report bugs?
A: Full list is on this page:
http://weechat.flashtux.org/download.php?view=supported_os
We do our best to run on as many platforms as possible. Help is welcome
for some OS we don't have, to test WeeChat.
There is 3 ways to report bugs:
1. you can join us on IRC: irc.freenode.net, channel #weechat
2. you can submit your bug at this URL:
http://savannah.nongnu.org/bugs/?func=addbug&group=weechat
3. you can mail your problem, look at support page for developer's mails:
http://weechat.flashtux.org/support.php
(you can subscribe and send to "support" mailing list)
3.5
================================================================================
Q: I want to help WeeChat developers. What can I do?
------------------------------------------------------------------------------
4.2: How should I submit patches?
A: There's many tasks to do (code, documentation, ...)
Please contact us with IRC or mail, look at support page:
http://weechat.flashtux.org/support.php
There is 3 ways to submit patches:
1. you can join us on IRC: irc.freenode.net, channel #weechat
2. you can submit your patch at this URL:
http://savannah.nongnu.org/patch/?func=addpatch&group=weechat
3. you can mail your patch, look at support page for developer's mails:
http://weechat.flashtux.org/support.php
(you can subscribe and send to mailing list called "support")
3.6
================================================================================
Q: Can I give money or other things to WeeChat developers?
------------------------------------------------------------------------------
4.3: How should I submit new feature request?
A: You can give us money to help development.
Details on http://weechat.flashtux.org/donate.php
There is 2 ways to submit your feature request:
1. you can join us on IRC: irc.freenode.net, channel #weechat
2. you can mail your feature request, look at support page for developer's
mails:
http://weechat.flashtux.org/support.php
(you can subscribe and send to mailing list called "support")
------------------------------------------------------------------------------
4.4: What is the list of supported platforms for WeeChat? Will it be ported to
other operating systems?
Full list is on this page:
http://weechat.flashtux.org/download.php?view=supported_os
We do our best to run on as many platforms as possible. Help is welcome for
some OS we don't have, to test WeeChat.
------------------------------------------------------------------------------
4.5: I want to help WeeChat developers. What can I do?
There's many tasks to do (testing, code, documentation, ...)
Please contact us with IRC or mail, look at support page:
http://weechat.flashtux.org/support.php
------------------------------------------------------------------------------
4.6: Can I give money or other things to WeeChat developers?
You can give us money to help development.
Details on http://weechat.flashtux.org/donate.php
+226 -219
View File
@@ -1,275 +1,282 @@
WeeChat FAQ, 2009-01-31
WeeChat FAQ, 2009-03-01
=======================
Public concerné :
Utilisateurs de WeeChat >= 0.2.7.
Avant de lire la suite ceci :
La liste suivante de questions/réponses n'est *pas* exhaustive.
Il est donc possible que vous ne trouviez pas de question/réponse correspondant
à votre problème.
Lisez les quand même SVP, elles peuvent vous aider à corriger votre problème.
Et même si votre problème est mentionné ci-dessous, il est possible que la
réponse ne vous aide pas à corriger le problème. Dans ce cas, contactez-nous,
nous essaierons de vous aider à trouver une solution.
1 - Compilation
2 - Utilisation de WeeChat
3 - Développement
1.1
================================================================================
Q: J'ai entendu parler de plusieurs interfaces pour WeeChat.
Comment puis-je les compiler/utiliser ?
R: Aujourd'hui seule l'interface Curses est disponible.
D'autres interfaces seront disponibles en mode distant (actuellement
en développement).
1 - Général
2 - Compilation / installation
3 - Utilisation de WeeChat
4 - Développement
1.2
================================================================================
Q: Je ne peux pas compiler WeeChat après avoir cloné la base git.
------------------------------------------------------------------------------
1.1: Pourquoi choisir WeeChat ? X-Chat et Irssi sont si bien...
R: Si vous compilez avec les autotools (et non cmake), vérifiez que vous avez
bien la dernière version d'autoconf et automake.
WeeChat a été développé avec autoconf version 2.61 et automake
version 1.10.
Vous devez avoir au moins ces versions pour compiler WeeChat.
Si vous n'avez pas ou ne souhaitez pas installer ces versions, vous
pouvez télécharger et installer le paquet "devel", un paquet construit
quasiment tous les jours à partir de la base git.
Notez que ce paquet peut ne pas correspondre exactement à la base git.
Parce que WeeChat est très léger et a de nouvelles fonctionnalités.
Quelques fonctionnalités (version >= 0.2.7) :
* 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://weechat.flashtux.org/features.php
2.1
================================================================================
Q: Pourquoi utiliser WeeChat ? X-Chat et Irssi sont si bien...
------------------------------------------------------------------------------
2.1: J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je
les compiler/utiliser ?
R: Parce que WeeChat est très léger et a de nouvelles fonctionnalités.
Quelques nouvelles fonctionnalités :
* 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
* highlight dans la barre d'infos
* 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://weechat.flashtux.org/features.php
Aujourd'hui seule l'interface Curses est disponible.
D'autres interfaces seront disponibles en mode distant (actuellement
en développement).
2.2
================================================================================
Q: J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ?
------------------------------------------------------------------------------
2.2: Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ?
R: 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.
Si vous démarrez avec WeeChat, il est recommandé de lire le guide de
démarrage rapide (voir la page de doc sur le site).
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.
2.3
================================================================================
Q: J'ai entendu parler de "buffers" et "windows", quelle est la
différence ?
------------------------------------------------------------------------------
3.1: J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ?
R: Une fenêtre ("window") est utilisée quand vous partagez l'écran
verticalement ou horizontalement.
Un tampon ("buffer") est une "vue" pour une fenêtre. Chaque fenêtre
affiche un tampon, et plusieurs fenêtres peuvent afficher le même
tampon.
Exemples de tampons: messages serveur, canal, contrôle xfer, etc...
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).
2.4
================================================================================
Q: Je ne vois pas bien certains accents dans WeeChat, que faire ?
------------------------------------------------------------------------------
3.2: J'ai entendu parler de "buffers" et "windows", quelle est la différence ?
R: 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.2.7: /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.
Une fenêtre ("window") est utilisée quand vous partagez l'écran verticalement
ou horizontalement.
Un tampon ("buffer") est une "vue" pour une fenêtre. Chaque fenêtre affiche un
tampon, et plusieurs fenêtres peuvent afficher le même tampon.
Exemples de tampons : messages serveur, canal, contrôle xfer, etc...
2.5
================================================================================
Q: 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 ?
------------------------------------------------------------------------------
3.3: Je ne vois pas bien certains accents dans WeeChat, que faire ?
R: Cela peut être du à la variable TERM qui n'a pas la bonne valeur
(regardez echo $TERM).
Selon la façon de lancer WeeChat, vous devriez avoir :
- si WeeChat tourne en local ou sur une machiine distante sans screen :
cela dépend du terminal utilisé : "xterm", "rxvt", ..
- si WeeChat tourne sous screen, vous devriez avoir "screen".
Si besoin, corrigez la variable TERM (export TERM="xxx").
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.2.7 :
/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.
2.6
================================================================================
Q: Quand j'utilise weechat sous screen, j'ai des caractères bizarres
notamment en changeant de fenêtre, comment corriger ça ?
------------------------------------------------------------------------------
3.4: 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 ?
R: Cela peut être du à la variable TERM qui n'a pas la bonne valeur
(regardez echo $TERM). 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").
Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez
echo $TERM).
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").
2.7
================================================================================
Q: Comment puis-je configurer les raccourcis clavier ?
------------------------------------------------------------------------------
3.5: Quand j'utilise weechat sous screen, j'ai des caractères bizarres,
notamment en changeant de fenêtre, comment corriger ça ?
R: 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 zone de saisie.
Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez
echo $TERM). 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").
2.8
================================================================================
Q: Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ?
Les scripts sont-ils compatibles avec d'autres clients IRC ?
------------------------------------------------------------------------------
3.6: Comment puis-je configurer les raccourcis clavier ?
R: Les commandes /perl, /python, /ruby, /lua et /tcl permettent de charger
les scripts Perl (le chemin par défaut est ~/.weechat/<langage>/).
Notez que les scripts dans ~/.weechat/<langage>/autoload sont
automatiquement chargés par WeeChat lorsqu'il démarre.
Les scripts ne sont pas compatibles avec d'autres clients IRC.
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.
2.9
================================================================================
Q: Je souhaite changer la langue des messages affichés par WeeChat, mais
sans quitter WeeChat, est-ce possible ?
------------------------------------------------------------------------------
3.7: J'utilise OpenBSD et WeeChat ne charge aucune extension, pourquoi ?
R: 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=en_US.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=en_US)
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"
/plugin autoload
- avec WeeChat >= 0.2.7 :
/set weechat.plugin.extension ".so.0.0"
/plugin autoload
2.10
================================================================================
Q: Avec l'interface Curses, comment puis-je copier/coller du texte sans
coller la liste des pseudos ?
------------------------------------------------------------------------------
3.8: Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ? Les scripts
sont-ils compatibles avec d'autres clients IRC ?
R: Vous pouvez utiliser un terminal qui propose la sélection rectangulaire
(comme rxvt-unicode, konsole, etc...).
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.2.7: /bar set nicklist position top
Les commandes /perl, /python, /ruby, /lua et /tcl permettent de charger les
scripts Perl (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.2.7.
2.11
================================================================================
Q: Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ?
------------------------------------------------------------------------------
3.9: Je souhaite changer la langue des messages affichés par WeeChat, mais sans
quitter WeeChat, est-ce possible ?
R: Vous pouvez utiliser le script sound.pl (disponible sur la page des
scripts), puis configurer une commande système (jouant un son, affichant
un message à l'écran, etc...) comme ceci :
avec WeeChat <= 0.2.6:
/setp perl.sound.cmd_highlight = "/chemin/commande parametres"
avec WeeChat >= 0.2.7:
/set plugins.var.perl.sound.cmd_highlight "/chemin/commande parametres"
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
3.1
================================================================================
Q: Comment dois-je reporter les bugs ?
------------------------------------------------------------------------------
3.10: Avec l'interface Curses, comment puis-je copier/coller du texte sans
coller la liste des pseudos ?
R: Il y a 3 manières de reporter les bugs :
1. vous pouvez nous joindre sur IRC: irc.freenode.net, canal #weechat
2. vous pouvez soumettre votre bug à cette adresse :
http://savannah.nongnu.org/bugs/?func=addbug&group=weechat
3. vous pouvez envoyer votre problème par mail, consultez la page
support pour les mails des développeurs :
http://weechat.flashtux.org/support.php
(vous pouvez souscrire et envoyer à la liste de diffusion
"support")
Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme
rxvt-unicode, konsole, 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.2.7 :
/bar set nicklist position top
3.2
================================================================================
Q: Comment dois-je soumettre les patches ?
------------------------------------------------------------------------------
3.11: Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ?
R: Il y a 3 manières de soumettre les patches :
1. vous pouvez nous joindre sur IRC: irc.freenode.net, canal #weechat
2. vous pouvez soumettre votre patch à cette adresse :
http://savannah.nongnu.org/patch/?func=addpatch&group=weechat
3. vous pouvez envoyer votre patch par mail, consultez la page
support pour les mails des développeurs :
http://weechat.flashtux.org/support.php
(vous pouvez souscrire et envoyer à la liste de diffusion
"support")
Vous pouvez utiliser le script sound.pl (disponible sur la page des scripts),
puis configurer une commande système (jouant un son, affichant un message à
l'écran, etc...) comme ceci :
- avec WeeChat <= 0.2.6 :
/setp perl.sound.cmd_highlight = "/chemin/commande parametres"
- avec WeeChat >= 0.2.7 :
/set plugins.var.perl.sound.cmd_highlight "/chemin/commande parametres"
3.3
================================================================================
Q: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ?
------------------------------------------------------------------------------
3.12: Comment puis-je filter les messages join/part/quit sur les canaux IRC ?
R: Il y a 2 manières :
1. vous pouvez nous joindre sur IRC: irc.freenode.net, channel #weechat
2. vous pouvez envoyer un mail, consultez la page support pour les
mails des développeurs :
http://weechat.flashtux.org/support.php
(vous pouvez souscrire et envoyer à la liste de diffusion
"support")
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.2.7 :
- filtre interlligent (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)
3.4
================================================================================
Q: Quelle est la liste des plate-formes supportées par WeeChat ?
WeeChat sera-t-il porté sur d'autres systèmes d'exploitation ?
------------------------------------------------------------------------------
4.1: Comment dois-je reporter les bugs ?
R: La liste complète est sur cette page :
http://weechat.flashtux.org/download.php?view=supported_os
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.
Il y a 3 manières de reporter les bugs :
1. vous pouvez nous joindre sur IRC : irc.freenode.net, canal #weechat
2. vous pouvez soumettre votre bug à cette adresse :
http://savannah.nongnu.org/bugs/?func=addbug&group=weechat
3. vous pouvez envoyer votre problème par mail, consultez la page support
pour les mails des développeurs :
http://weechat.flashtux.org/support.php
(vous pouvez souscrire et envoyer à la liste de diffusion nommée
"support")
3.6
================================================================================
Q: Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ?
------------------------------------------------------------------------------
4.2: Comment dois-je soumettre les patches ?
R: Il y a plusieurs choses à faire (code, documentation, ...)
Merci de prendre contact avec nous par IRC ou mail, consultez la page
support :
http://weechat.flashtux.org/support.php
Il y a 3 manières de soumettre les patches :
1. vous pouvez nous joindre sur IRC : irc.freenode.net, canal #weechat
2. vous pouvez soumettre votre patch à cette adresse :
http://savannah.nongnu.org/patch/?func=addpatch&group=weechat
3. vous pouvez envoyer votre patch par mail, consultez la page support pour
les mails des développeurs :
http://weechat.flashtux.org/support.php
(vous pouvez souscrire et envoyer à la liste de diffusion nommée
"support")
3.7
================================================================================
Q: Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ?
------------------------------------------------------------------------------
4.3: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ?
R: Vous pouvez donner de l'argent pour aider le développement.
Plus de détails sur http://weechat.flashtux.org/donate.php
Il y a 2 manières :
1. vous pouvez nous joindre sur IRC : irc.freenode.net, canal #weechat
2. vous pouvez envoyer un mail, consultez la page support pour les mails des
développeurs :
http://weechat.flashtux.org/support.php
(vous pouvez souscrire et envoyer à la liste de diffusion nommée
"support")
------------------------------------------------------------------------------
4.4: 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://weechat.flashtux.org/download.php?view=supported_os
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.
------------------------------------------------------------------------------
4.5: 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://weechat.flashtux.org/support.php
------------------------------------------------------------------------------
4.6: 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://weechat.flashtux.org/donate.php