pegasus/weechat
1
0
Fork 0
mirror of https://github.com/weechat/weechat.git synced 2026-06-28 13:56:37 +02:00
Code Activity

Update FAQs

Browse Source
This commit is contained in:
Sebastien Helleu
2009-01-03 10:46:40 +01:00
parent 2115f3f675
commit fbb3295e96
2 changed files with 130 additions and 189 deletions
Download Patch File Download Diff File Expand all files Collapse all files
FAQ
+32 -61
View File
@@ -1,4 +1,4 @@
WeeChat FAQ, 2008-01-02
WeeChat FAQ, 2009-01-03
=======================
Intended audience:
@@ -33,15 +33,17 @@ A: Curses GUI is built by default.
1.2
================================================================================
Q: I can't compile WeeChat CVS.
Q: I can't compile WeeChat after cloning git repository.
A: Check that you have latest version of autoconf and automake.
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 CVS.
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, based on CVS.
Note that this package may not correspond exactly to CVS base.
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.
2.1
@@ -50,17 +52,17 @@ Q: Why using WeeChat ? X-Chat and Irssi are so good...
A: Because WeeChat is very light and has new features.
Some new features:
* many GUI (Curses, Gtk, wxWidgets, Qt)
* multi-protocols support via plugins (IRC and other soon)
* many deported GUI in addition to Curses (coming soon)
* available in many languages
* nicklist available in all GUI
* extensible with plugins (C, Perl, Python, Ruby, Lua)
* extensible with plugins (C, Perl, Python, Ruby, Lua, Tcl)
* horizontal and vertical window split
* infobar highlight
* FIFO pipe for remote control
* developed from scratch (not based on any other IRC client)
* developed from scratch (not based on any other client)
* multi-platform
* 100% GPL and free
This is the "geekest" IRC client ;)
More info on this page: http://weechat.flashtux.org/features.php
@@ -80,7 +82,7 @@ Q: I heard about "buffers" and "windows", what's the difference?
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, DCC list, ..
Examples of buffers: server messages, channel, xfer control, ..
2.4
@@ -98,7 +100,8 @@ A: For versions < 0.2.3, please upgrade to last stable version.
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:
/setp charset.global.decode = ISO-8859-15
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.
@@ -114,54 +117,18 @@ A: Key bindings are customizable with /key command.
2.6
================================================================================
Q: How can I load Perl scripts?
Are Perl scripts compatible with other IRC clients ?
Q: How can I load Perl/Python/Ruby/Lua/Tcl scripts?
Are scripts compatible with other IRC clients ?
A: You can use /perl command to load scripts (default path is
~/.weechat/perl).
Note that scripts in ~/.weechat/perl/autoload are automatically loaded
when WeeChat is starting up.
Perl scripts are not compatible with other IRC clients.
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.
2.7
================================================================================
Q: How can I load Python scripts?
Are Python scripts compatible with other IRC clients ?
A: You can use /python command to load scripts (default path is
~/.weechat/python).
Note that scripts in ~/.weechat/python/autoload are automatically loaded
when WeeChat is starting up.
Python scripts are not compatible with other IRC clients.
2.8
================================================================================
Q: How can I load Ruby scripts?
Are Ruby scripts compatible with other IRC clients ?
A: You can use /ruby command to load scripts (default path is
~/.weechat/ruby).
Note that scripts in ~/.weechat/ruby/autoload are automatically loaded
when WeeChat is starting up.
Ruby scripts are not compatible with other IRC clients.
2.9
================================================================================
Q: How can I load Lua scripts?
Are Lua scripts compatible with other IRC clients ?
A: You can use /lua command to load scripts (default path is
~/.weechat/lua).
Note that scripts in ~/.weechat/lua/autoload are automatically loaded
when WeeChat is starting up.
Lua scripts are not compatible with other IRC clients.
2.10
================================================================================
Q: When I'm using weechat under screen, I have weird chars, when I switch
window for example, how to fix that?
@@ -170,7 +137,7 @@ A: This may be caused by bad value of TERM variable (look at echo $TERM).
is ok (like many other values).
2.11
2.8
================================================================================
Q: I want to change language used by WeeChat for messages, but without
exiting WeeChat, is it possible?
@@ -183,24 +150,28 @@ A: Yes, you have to use python script shell.py (available on WeeChat
users, you can issue: /shell setenv LANG=en_US)
2.12
2.9
================================================================================
Q: With Curses GUI, how can I copy/paste text without pasting nicklist ?
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:
/set look_nicklist_position = top
with WeeChat <= 0.2.6: /set look_nicklist_position = top
with WeeChat >= 0.2.7: /bar set nicklist position top
2.13
2.10
================================================================================
Q: How to be warned when someone highlights me on a channel ?
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 :
/setp perl.sound.cmd_highlight = "/usr/bin/command arguments..."
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.1
FAQ.fr
+98 -128
View File
@@ -1,115 +1,117 @@
WeeChat FAQ, 2008-01-02
WeeChat FAQ, 2009-01-03
=======================
Public concerné :
Public concerné :
Tous les utilisateurs de WeeChat.
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.
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
3 - Développement
1.1
================================================================================
Q: J'ai entendu parler de plusieurs interfaces pour WeeChat.
Comment puis-je les compiler/utiliser ?
R: L'interface Curses est construite par défaut.
Pour construire l'interface Gtk, wxWidgets ou Qt, vous devez spécifier des
R: L'interface Curses est construite par défaut.
Pour construire l'interface Gtk, wxWidgets ou Qt, vous devez spécifier des
options pour le script ./configure :
--enable-gtk pour activer l'interface Gtk
--enable-wxwidgets pour activer l'interface wxWidgets
--enable-qt pour activer l'interface Qt
Tapez ./configure --help pour voir les options disponibles.
ATTENTION : seule l'interface Curses est ok aujourd'hui.
Les autres interfaces sont en développement.
Les autres interfaces sont en développement.
1.2
================================================================================
Q: Je ne peux pas compiler le CVS WeeChat.
Q: Je ne peux pas compiler WeeChat après avoir cloné la base git.
R: 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
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 le CVS WeeChat.
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, basé sur le CVS.
Notez que ce paquet peut ne pas correspondre exactement à la base CVS.
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.
2.1
================================================================================
Q: Pourquoi utiliser WeeChat ? X-Chat et Irssi sont si bien...
R: Parce que WeeChat est très léger et a de nouvelles fonctionnalités.
Quelques nouvelles fonctionnalités :
* plusieurs interfaces (Curses, Gtk, wxWidgets, Qt)
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 et d'autres bientôt)
* plusieurs interfaces déportées en plus de Curses (à venir bientôt)
* disponible en plusieurs langues
* liste des pseudos disponible dans toutes les interfaces
* extensible par des extensions (C, Perl, Python, Ruby, Lua)
* découpage de la fenêtre horizontalement et verticalement
* extensible par des extensions (C, Perl, Python, Ruby, Lua, Tcl)
* découpage de la fenêtre horizontalement et verticalement
* highlight dans la barre d'infos
* tube FIFO pour contrôle à distance
* développé à partir de zéro (non basé sur un quelconque client IRC)
* tube FIFO pour contrôle à distance
* développé à partir de zéro (non basé sur un quelconque client)
* multi-platformes
* 100% GPL et libre
C'est le client IRC le plus "geek" ;)
Plus d'infos sur cette page: http://weechat.flashtux.org/features.php
2.2
================================================================================
Q: J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ?
Q: J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ?
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.
Les touches et commandes sont listées dans la documentation.
2.3
================================================================================
Q: J'ai entendu parler de "buffers" et "windows", quelle est la
différence ?
différence ?
R: Une fenêtre ("window") est utilisée quand vous partagez l'écran
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
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, liste des DCC, etc...
Exemples de tampons: messages serveur, canal, contrôle xfer, etc...
2.4
================================================================================
Q: Je ne vois pas bien certains accents dans WeeChat, que faire ?
R: Pour les versions < 0.2.3, merci d'installer la dernière version stable.
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) :
- 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
- 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
- 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 :
/setp charset.global.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.
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.5
@@ -117,75 +119,39 @@ R: Pour les versions < 0.2.3, merci d'installer la derni
Q: Comment puis-je configurer les raccourcis clavier ?
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
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.
2.6
================================================================================
Q: Comment puis-je charger des scripts Perl ?
Les scripts Perl sont-ils compatibles avec d'autres clients IRC ?
Q: Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ?
Les scripts sont-ils compatibles avec d'autres clients IRC ?
R: La commande /perl permet de charger les scripts Perl (le chemin par défaut
est ~/.weechat/perl).
Notez que les scripts dans ~/.weechat/perl/autoload sont automatiquement
chargés par WeeChat lorsqu'il démarre.
Les scripts Perl ne sont pas compatibles avec d'autres clients IRC.
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.
2.7
================================================================================
Q: Comment puis-je charger les scripts Python ?
Les scripts Python sont-ils compatibles avec d'autres clients IRC ?
Q: Quand j'utilise weechat sous screen, j'ai des caractères bizarres
notamment en changeant de fenêtre, comment corriger ça ?
R: La commande /python permet de charger les scripts Python (le chemin par
défaut est ~/.weechat/python).
Notez que les scripts dans ~/.weechat/python/autoload sont automatiquement
chargés par WeeChat lorsqu'il démarre.
Les scripts Python ne sont pas compatibles avec d'autres clients IRC.
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).
2.8
================================================================================
Q: Comment puis-je charger des scripts Ruby ?
Les scripts Ruby sont-ils compatibles avec d'autres clients IRC ?
R: La commande /ruby permet de charger les scripts Ruby (le chemin par
défaut est ~/.weechat/ruby).
Notez que les scripts dans ~/.weechat/ruby/autoload sont automatiquement
chargés par WeeChat lorsqu'il démarre.
Les scripts Ruby ne sont pas compatibles avec d'autres clients IRC.
2.9
================================================================================
Q: Comment puis-je charger des scripts Lua ?
Les scripts Lua sont-ils compatibles avec d'autres clients IRC ?
R: La commande /lua permet de charger les scripts Lua (le chemin par
défaut est ~/.weechat/lua).
Notez que les scripts dans ~/.weechat/lua/autoload sont automatiquement
chargés par WeeChat lorsqu'il démarre.
Les scripts Lua ne sont pas compatibles avec d'autres clients IRC.
2.10
================================================================================
Q: Quand j'utilise weechat sous screen, j'ai des caractères bizarres
notamment en changeant de fenêtre, comment corriger ça ?
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).
2.11
================================================================================
Q: Je souhaite changer la langue des messages affichés par WeeChat, mais
Q: Je souhaite changer la langue des messages affichés par WeeChat, mais
sans quitter WeeChat, est-ce possible ?
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é :
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,
@@ -193,40 +159,44 @@ R: Oui, il faut utiliser le script python shell.py (disponible sur le site
/shell setenv LANG=en_US)
2.12
2.9
================================================================================
Q: Avec l'interface Curses, comment puis-je copier/coller du texte sans
coller la liste des pseudos ?
R: Vous pouvez utiliser un terminal qui propose la sélection rectangulaire
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
Une autre solution est de déplacer la liste des pseudos en haut ou en
bas, par exemple :
/set look_nicklist_position = top
avec WeeChat <= 0.2.6: /set look_nicklist_position = top
avec WeeChat >= 0.2.7: /bar set nicklist position top
2.13
2.10
================================================================================
Q: Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ?
Q: Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ?
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 :
/setp perl.sound.cmd_highlight = "/usr/bin/commande parametres..."
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.1
================================================================================
Q: Comment dois-je reporter les bugs ?
R: Il y a 3 manières de reporter les bugs :
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 :
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 :
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
(vous pouvez souscrire et envoyer à la liste de diffusion
"support")
@@ -234,51 +204,51 @@ R: Il y a 3 mani
================================================================================
Q: Comment dois-je soumettre les patches ?
R: Il y a 3 manières de soumettre les patches :
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 :
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 :
support pour les mails des développeurs :
http://weechat.flashtux.org/support.php
(vous pouvez souscrire et envoyer à la liste de diffusion
(vous pouvez souscrire et envoyer à la liste de diffusion
"support")
3.3
================================================================================
Q: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ?
Q: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ?
R: Il y a 2 manières :
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 :
mails des développeurs :
http://weechat.flashtux.org/support.php
(vous pouvez souscrire et envoyer à la liste de diffusion
(vous pouvez souscrire et envoyer à la liste de diffusion
"support")
3.4
================================================================================
Q: Quelle est la liste des plate-formes supportées par WeeChat ?
Q: Quelle est la liste des plate-formes supportées par WeeChat ?
R: La liste complète est sur cette page :
R: La liste complète est sur cette page :
http://weechat.flashtux.org/download.php?lang=fr&view=supported_os
3.5
================================================================================
Q: WeeChat sera-t-il porté sur QNX ou d'autres systèmes d'exploitation ?
Q: WeeChat sera-t-il porté sur QNX ou d'autres systèmes d'exploitation ?
R: Oui. Les futures versions seront disponibles pour ces OS.
Nous avons besoin d'aide pour ces systèmes, toute aide est la bienvenue :)
Nous avons besoin d'aide pour ces systèmes, toute aide est la bienvenue :)
3.6
================================================================================
Q: Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ?
Q: Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ?
R: Il y a plusieurs choses à faire (code, documentation, ...)
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
@@ -286,7 +256,7 @@ R: Il y a plusieurs choses
3.7
================================================================================
Q: Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ?
Q: Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ?
R: Vous pouvez donner de l'argent pour aider le développement.
Plus de détails sur http://weechat.flashtux.org/donate.php
R: Vous pouvez donner de l'argent pour aider le développement.
Plus de détails sur http://weechat.flashtux.org/donate.php