diff options
author | Sebastien Helleu <flashcode@flashtux.org> | 2009-03-01 09:26:04 +0100 |
---|---|---|
committer | Sebastien Helleu <flashcode@flashtux.org> | 2009-03-01 09:26:04 +0100 |
commit | 1a69bbcb1eff2e322fa3b1477db289fb9267f1eb (patch) | |
tree | 66f838425c739198c8b6cf1b848feae860c5ea5d | |
parent | b0c058fc20095a9c133ef518be0c79ed6b833599 (diff) | |
download | weechat-1a69bbcb1eff2e322fa3b1477db289fb9267f1eb.zip |
Update FAQ (new format for website and some updates/additions)
-rw-r--r-- | FAQ | 474 | ||||
-rw-r--r-- | FAQ.fr | 553 |
2 files changed, 520 insertions, 507 deletions
@@ -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.2 -================================================================================ -Q: I can't compile WeeChat after cloning git repository. - -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. - - -2.1 -================================================================================ -Q: Why using WeeChat ? X-Chat and Irssi are so good... - -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 - - -2.2 -================================================================================ -Q: I've launched WeeChat, but I'm lost, what can I do? - -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). - - -2.3 -================================================================================ -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, xfer control, .. - - -2.4 -================================================================================ -Q: I don't see some chars with accents, what can I do? - -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. - - -2.5 -================================================================================ -Q: 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). - 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.6 -================================================================================ -Q: When I'm using weechat under screen, I have weird chars, when I switch - window for example, how to fix that? - -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"). - - -2.7 -================================================================================ -Q: How can I customize key bindings? - -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. - - -2.8 -================================================================================ -Q: How can I load Perl/Python/Ruby/Lua/Tcl scripts? - Are scripts 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.9 -================================================================================ -Q: I want to change language used by WeeChat for messages, but without - exiting WeeChat, is it possible? - -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) +1 - General +2 - Compilation / install +3 - Using WeeChat +4 - Development + + +------------------------------------------------------------------------------ +1.1: Why choosing WeeChat? X-Chat and Irssi are so good... + +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: I heard about many GUI for WeeChat. How can I compile/use them? + +Today only Curses GUI is available. Other GUI will be available as remote +client (currently udner development). -2.10 -================================================================================ -Q: With Curses GUI, how can I copy/paste text without pasting nicklist ? +------------------------------------------------------------------------------ +2.2: I can't compile WeeChat after cloning git repository, why? + +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. + -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 +------------------------------------------------------------------------------ +3.1: I've launched WeeChat, but I'm lost, what can I do? + +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). + + +------------------------------------------------------------------------------ +3.2: I heard about "buffers" and "windows", what's the difference? +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, .. + + +------------------------------------------------------------------------------ +3.3: I don't see some chars with accents, what can I do? + +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. + + +------------------------------------------------------------------------------ +3.4: Bars like title and status are not filled, background color stops after +text, why? + +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"). + + +------------------------------------------------------------------------------ +3.5: When I'm using weechat under screen, I have weird chars, when I switch +window for example, how to fix that? + +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"). + + +------------------------------------------------------------------------------ +3.6: How can I customize key bindings? + +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. + + +------------------------------------------------------------------------------ +3.7: I'm using OpenBSD and WeeChat does not load any plugin, what's wrong? + +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 + + +------------------------------------------------------------------------------ +3.8: How can I load Perl/Python/Ruby/Lua/Tcl scripts? Are scripts compatible +with other IRC clients? + +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. + + +------------------------------------------------------------------------------ +3.9: I want to change language used by WeeChat for messages, but without +exiting WeeChat, is it possible? -2.11 -================================================================================ -Q: How to be warned when someone highlights me on a channel ? +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 -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" - - -3.1 -================================================================================ -Q: How should I report bugs? - -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) +------------------------------------------------------------------------------ +3.10: With Curses GUI, how can I copy/paste text without pasting nicklist? -3.2 -================================================================================ -Q: How should I submit patches? +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.11: How to be warned when someone highlights me on a channel? + +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" -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) +------------------------------------------------------------------------------ +3.12: How can I filter join/part/quit messages on IRC channels? -3.3 -================================================================================ -Q: How should I submit new feature request? +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) -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) +------------------------------------------------------------------------------ +4.1: How should I report bugs? -3.4 -================================================================================ -Q: What is the list of supported platforms for WeeChat? - Will WeeChat be ported to other operating systems? +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) -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. +------------------------------------------------------------------------------ +4.2: How should I submit patches? + +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.5 -================================================================================ -Q: I want to help WeeChat developers. What can I do? -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 +------------------------------------------------------------------------------ +4.3: How should I submit new feature request? +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") -3.6 -================================================================================ -Q: Can I give money or other things to WeeChat developers? -A: You can give us money to help development. - Details on http://weechat.flashtux.org/donate.php +------------------------------------------------------------------------------ +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 @@ -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.2 -================================================================================ -Q: Je ne peux pas compiler WeeChat après avoir cloné la base git. - -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. - - -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 : - * 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 - - -2.2 -================================================================================ -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. - 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). - - -2.3 -================================================================================ -Q: J'ai entendu parler de "buffers" et "windows", quelle est la - différence ? - -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... - - -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. - 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.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 ? - -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"). - - -2.6 -================================================================================ -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). - Si besoin, corrigez la variable TERM (export TERM="xxx"). - - -2.7 -================================================================================ -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 - d'une touche et de l'inclure dans la zone de saisie. - - -2.8 -================================================================================ -Q: Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ? - Les scripts sont-ils 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.9 -================================================================================ -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é : - /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) - - -2.10 -================================================================================ -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 - (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 - - -2.11 -================================================================================ -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 : - 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 : - 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") - - -3.2 -================================================================================ -Q: Comment dois-je 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 : - 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") - - -3.3 -================================================================================ -Q: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ? - -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") - - -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 ? - -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. - - -3.6 -================================================================================ -Q: Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ? - -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 - - -3.7 -================================================================================ -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 +1 - Général +2 - Compilation / installation +3 - Utilisation de WeeChat +4 - Développement + + +------------------------------------------------------------------------------ +1.1: 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.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: 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). + + +------------------------------------------------------------------------------ +2.2: 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. + + +------------------------------------------------------------------------------ +3.1: 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). + + +------------------------------------------------------------------------------ +3.2: J'ai entendu parler de "buffers" et "windows", quelle est la différence ? + +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... + + +------------------------------------------------------------------------------ +3.3: Je ne vois pas bien certains accents dans WeeChat, que faire ? + +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. + + +------------------------------------------------------------------------------ +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 ? + +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"). + + +------------------------------------------------------------------------------ +3.5: Quand j'utilise weechat sous screen, j'ai des caractères bizarres, +notamment en changeant de fenêtre, comment corriger ça ? + +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"). + + +------------------------------------------------------------------------------ +3.6: 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. + + +------------------------------------------------------------------------------ +3.7: 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" + /plugin autoload +- avec WeeChat >= 0.2.7 : + /set weechat.plugin.extension ".so.0.0" + /plugin autoload + + +------------------------------------------------------------------------------ +3.8: 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 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. + + +------------------------------------------------------------------------------ +3.9: 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 + + +------------------------------------------------------------------------------ +3.10: Avec l'interface Curses, 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, 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.11: Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ? + +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.12: 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.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) + + +------------------------------------------------------------------------------ +4.1: Comment dois-je reporter les bugs ? + +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") + + +------------------------------------------------------------------------------ +4.2: Comment dois-je soumettre les patches ? + +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") + + +------------------------------------------------------------------------------ +4.3: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ? + +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 |