foxiepaws
/
weechat
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Convert some docs to asciidoc format, add tester's guide, remove some obsolete docs

v2.8-utf8proc
Sebastien Helleu 2009-05-15 23:03:35 +02:00
parent 420d294498
commit 041b754980
39 changed files with 2302 additions and 2603 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
AUTHORS
View File

@ -1,47 +1,42 @@
WeeChat - Wee Enhanced Environment for Chat
===========================================
WeeChat Authors
===============
Developers:
Developers
----------
* General code
FlashCode <flashcode@flashtux.org>
Web : http://weechat.flashtux.org
IRC : nick is "FlashCode" @ irc.freenode.net
* Scripts plugins
kolter <kolter@openics.org>
IRC : nick is "kolter" @ irc.freenode.net
** FlashCode <flashcode@flashtux.org>
*** Web: http://weechat.flashtux.org/
*** IRC: 'FlashCode' on irc.freenode.net
Debian packager:
---------------
* Scripts plugins, debian packager
Julien Louis <ptitlouis@sysif.net>
IRC : nick is "ptitlouis" @ irc.freenode.net
Jabber: ptitlouis@amessage.info
** kolter <kolter@openics.org>
*** IRC: 'kolter' on irc.freenode.net
Contributors:
Contributors
------------
Rudolf Polzer <rpolzer-rp@durchnull.de>, IRC: "divVerent"
Jiri Golembiovsky <golemj@gmail.com>, IRC: "GolemJ"
Jim Ramsay <i.am@jimramsay.com>, IRC: "lack"
Odin <odin@dtdm.org>, IRC: "Odin"
Pistos, IRC: "pistos"
Gwenn, IRC: "gwenn"
Voroskoi, IRC: "voroskoi"
Frank Zacharias
Pavel Shevchuk, IRC: "Stalwart"
* Julien Louis <ptitlouis@sysif.net>, IRC: 'ptitlouis'
* Rudolf Polzer <rpolzer-rp@durchnull.de>, IRC: 'divVerent'
* Jiri Golembiovsky <golemj@gmail.com>, IRC: 'GolemJ'
* Jim Ramsay <i.am@jimramsay.com>, IRC: 'lack'
* Odin <odin@dtdm.org>, IRC: 'Odin'
* Pistos, IRC: 'pistos'
* Gwenn, IRC: 'gwenn'
* Voroskoi, IRC: 'voroskoi'
* Frank Zacharias
* Pavel Shevchuk, IRC: 'Stalwart'
=====
Contact
-------
Whole team is connected to IRC:
server: irc.freenode.net, channels: #weechat and #weechat-fr (french)
server: 'irc.freenode.net', channels: '#weechat' (english) and '#weechat-fr' (french)
See README file for licence detail.

5
BUGS
View File

@ -1,5 +0,0 @@
WeeChat - Wee Enhanced Environment for Chat
===========================================
WeeChat known bugs:
please look at https://savannah.nongnu.org/bugs/?group=weechat

1469
ChangeLog
View File

File diff suppressed because it is too large Load Diff

283
FAQ
View File

@ -1,283 +0,0 @@
WeeChat FAQ, 2009-05-11
=======================
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.3.x):
* 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.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.
------------------------------------------------------------------------------
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, your locale
is probably wrong.
- setup global decode value, for example:
with WeeChat <= 0.2.6:
/setp charset.global.decode = ISO-8859-15
with WeeChat >= 0.3.x:
/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)
- if you are using screen, check that it is run with UTF-8 mode
("defutf8 on" in ~/.screenrc or "screen -U")
------------------------------------------------------------------------------
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.3.x:
/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.3.x.
------------------------------------------------------------------------------
3.9: I want to change language used by WeeChat for messages, but without
exiting WeeChat, is it possible?
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.10: With Curses GUI, how can I copy/paste text without pasting nicklist?
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.3.x:
/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.3.x:
/set plugins.var.perl.sound.cmd_highlight "/path/command arguments"
------------------------------------------------------------------------------
3.12: How can I filter join/part/quit messages on IRC channels?
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.3.x:
- 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.13: What is the difference between /ignore and /filter commands?
The /ignore command is an IRC command, so it applies only for IRC buffers
(servers and channels).
It lets you ignore some nicks or hostname for a server or channel (command
will not apply on content of messages).
Matching messages are deleted by IRC plugin before display (so you'll
never see them).
The /filter command is a core command, so it applies on any buffer.
It lets you filter some lines in buffers with tags or regular expression for
prefix and content of line.
Filtered lines are only hidden, not deleted, and you can see them if you
disable filters (by default, key alt + "=" toggle filters).
------------------------------------------------------------------------------
4.1: How should I report bugs?
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)
------------------------------------------------------------------------------
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")
------------------------------------------------------------------------------
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")
------------------------------------------------------------------------------
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

304
FAQ.fr
View File

@ -1,304 +0,0 @@
WeeChat FAQ, 2009-05-11
=======================
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.3.x) :
* support multi-protocoles via extensions (IRC, Jabber)
* plusieurs interfaces déportées en plus de Curses (à venir bientôt)
* disponible en plusieurs langues
* extensible par des extensions (C, Perl, Python, Ruby, Lua, Tcl)
* tampons avec contenu libre
* filtrage de l'affichage avec tags et expressions régulières
* découpage de la fenêtre horizontalement et verticalement
* barres personnalisables et extensibles
* liste des pseudos disponible dans toutes les interfaces
* recherche incrémentale de texte dans les tampons, saut aux highlights
* tube FIFO pour contrôle à distance
* support aspell
* double encodage (décodage/encodage)
* développé à partir de zéro (non basé sur un quelconque client)
* multi-platformes
* 100% GPL et libre
Plus d'infos sur cette page : http://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.3.x :
/set charset.default.decode "ISO-8859-15"
- si vous utilisez la locale UTF-8 :
- vérifiez que votre terminal est compatible UTF-8
(un terminal conseillé pour l'UTF-8 est rxvt-unicode)
- si vous utilisez screen, vérifiez qu'il est lancé en mode UTF-8
("defutf8 on" dans ~/.screnrc ou "screen -U")
------------------------------------------------------------------------------
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.3.x :
/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.3.x.
------------------------------------------------------------------------------
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.3.x :
/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.3.x :
/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.3.x :
- 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.13: Quelle est la différence entre les commandes /ignore et /filter ?
La commande /ignore est une commande IRC, donc elle s'applique uniquement aux
tampons IRC (serveurs et canaux).
Elle permet d'ignorer des pseudos ou nom d'hôtes pour un serveur ou un canal
(la commande ne s'applique pas au contenu des messages).
Les messages corespondants sont supprimés par l'extension IRC avant affichage
(donc vous ne les verrez jamais).
La commande /filter est une commande "core", donc elle s'applique à n"importe
quel tampon.
Elle permet de filtrer des lignes dans les tampons à l'aide de tags ou
d'expression régulière pour le préfixe et contenu de la ligne.
Les lignes filtrées sont simplement cachées, pas supprimées, et il est possible
de les voir en désactivant les filtres (par défaut, la touche alt + "="
active/désactive les filtres).
------------------------------------------------------------------------------
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

35
INSTALL
View File

@ -1,25 +1,34 @@
WeeChat - Installation instructions
===================================
WeeChat Installation instructions
=================================
You can build WeeChat with cmake (recommended way) or autotools.
- with cmake:
mkdir build
cd build
cmake .. -DPREFIX=/where/you/want/install -DCMAKE_BUILD_TYPE=Debug
make
make install (as root for installation in system directories)
With cmake
----------
- with autotools:
------------------------------------------------------------------
mkdir build
cd build
cmake .. -DPREFIX=/where/you/want/install -DCMAKE_BUILD_TYPE=Debug
make
make install (as root for installation in system directories)
------------------------------------------------------------------
./autogen.sh (for cloned git repository only, not devel package)
./configure --prefix=/where/you/want/install
make
make install (as root for installation in system directories)
With autotools
--------------
----------------------------------------------------------------------
./autogen.sh (for cloned git repository only, not .tar.XX package)
./configure --prefix=/where/you/want/install
make
make install (as root for installation in system directories)
----------------------------------------------------------------------
If you want to report bugs/crashs to developers, please:
- compile with debug info (type "Debug" for cmake build, default for autotools),
- enable core files (for bash shell, add "ulimit -c unlimited" to your ~/.bashrc).

5
Makefile.am
View File

@ -1,4 +1,4 @@
# Copyright (c) 2003-2008 FlashCode <flashcode@flashtux.org>
# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
@ -23,9 +23,6 @@ SUBDIRS = po $(doc_dir) intl src
EXTRA_DIST = CMakeLists.txt \
config.rpath \
config.h.cmake \
BUGS \
FAQ \
FAQ.fr \
debian/NEWS \
debian/changelog \
debian/compat \

190
NEWS
View File

@ -1,107 +1,93 @@
WeeChat - Wee Enhanced Environment for Chat
===========================================
* FlashCode, 2009-04-18
WeeChat News
============
FlashCode, 2009-04-18::
WeeChat 0.2.6.2 released.
+
This version fixes a bug with charset decoding (like iso2022jp).
* FlashCode, 2009-03-14
FlashCode, 2009-03-14::
WeeChat 0.2.6.1 released.
+
This version fixes a major bug: crash with some special chars in IRC
messages.
* FlashCode, 2007-09-06
FlashCode, 2007-09-06::
WeeChat 0.2.6 released.
* FlashCode, 2007-06-07
FlashCode, 2007-06-07::
WeeChat 0.2.5 released.
* FlashCode, 2007-03-29
FlashCode, 2007-03-29::
WeeChat 0.2.4 released.
* FlashCode, 2007-01-10
FlashCode, 2007-01-10::
WeeChat 0.2.3 released.
+
This version fixes several major bugs of version 0.2.2.
All users of version 0.2.2 should upgrade to this version.
* FlashCode, 2007-01-06
FlashCode, 2007-01-06::
WeeChat 0.2.2 released.
+
Important release notes:
- new charset plugin:
- for users of any previous version, all your charset settings
in weechat.rc will be LOST! You should save your weechat.rc
to keep your values and set them again with new "charset" plugin.
- for ISO users: history of channels may be without accents
(after /upgrade), this is not recoverable, but this is not a bug.
All new messages should be ok.
- be careful, now default encode is UTF-8 for all channels (before
it was terminal charset). If you still want to send messages as
ISO-8859-1, you should send either global encode or server specific
encode to ISO-8859-1.
For global encode: /setp charset.global.encode = "ISO-8859-1"
For server encode: (on server buffer) /charset encode ISO-8859-1
- new keys for topic scroll:
- new keys for scrolling topic: F9/F10
- key F10 was used for "infobar_clear" in previous WeeChat versions,
you have to manually rebind this key (except for new WeeChat users):
/key <press alt-k then F10> scroll_topic_right
which gives something like this:
/key meta2-21~ scroll_topic_right
* FlashCode, 2006-10-01
* new charset plugin:
** for users of any previous version, all your charset settings
in weechat.rc will be LOST! You should save your weechat.rc
to keep your values and set them again with new "charset" plugin.
** for ISO users: history of channels may be without accents
(after /upgrade), this is not recoverable, but this is not a bug.
All new messages should be ok.
** be careful, now default encode is UTF-8 for all channels (before
it was terminal charset). If you still want to send messages as
ISO-8859-1, you should send either global encode or server specific
encode to ISO-8859-1.
For global encode: /setp charset.global.encode = "ISO-8859-1"
For server encode: (on server buffer) /charset encode ISO-8859-1
* new keys for topic scroll:
** new keys for scrolling topic: F9/F10
** key F10 was used for "infobar_clear" in previous WeeChat versions,
you have to manually rebind this key (except for new WeeChat users):
/key <press alt-k then F10> scroll_topic_right
which gives something like this:
/key meta2-21~ scroll_topic_right
FlashCode, 2006-10-01::
WeeChat 0.2.1 released.
* FlashCode, 2006-08-19
FlashCode, 2006-08-19::
WeeChat 0.2.0 released.
+
Important release notes:
- if you upgraded with /upgrade in WeeChat, you should /disconnect and
* if you upgraded with /upgrade in WeeChat, you should /disconnect and
then /reconnect on each server, to display properly channel/user modes
- if you're using plugins, you should remove some old plugins libraries
* if you're using plugins, you should remove some old plugins libraries
in WeeChat system library directory (commonly
/usr/local/lib/weechat/plugins): remove lib* files (like libperl.*,
libpython.*, ..) and keep only new libraries (perl.*, python.*, ..)
* FlashCode, 2006-05-25
/usr/local/lib/weechat/plugins): remove `lib*` files (like `libperl.*`,
`libpython.*`, ..) and keep only new libraries (`perl.*`, `python.*`, ..)
FlashCode, 2006-05-25::
WeeChat 0.1.9 released.
+
Important release notes:
- please close all DCC chat buffers before using /upgrade command,
* please close all DCC chat buffers before using /upgrade command,
otherwise you may experience problems with DCC chats.
- some changes in script API: now timer handlers functions takes exactly
* some changes in script API: now timer handlers functions takes exactly
0 (zero) argument (in version 0.1.8, two arguments were mandatory but
not used: server and args)
* FlashCode, 2006-03-18
FlashCode, 2006-03-18::
WeeChat 0.1.8 released.
+
Important release notes:
- it is recommended for users of version 0.1.7 (or any older), to
* it is recommended for users of version 0.1.7 (or any older), to
replace values in setup file (~/.weechat/weechat.rc) :
- option: log_path: replace "~/.weechat/logs" by "%h/logs"
- option: plugins_path: replace "~/.weechat/plugins" by "%h/plugins"
"%h" is replaced by WeeChat home (default: ~/.weechat, may be overriden
by new command line arg --dir)
- after installing 0.1.8 (or with /upgrade), issue both commands (if you
** option: log_path: replace "~/.weechat/logs" by "%h/logs"
** option: plugins_path: replace "~/.weechat/plugins" by "%h/plugins"
+
"%h" is replaced by WeeChat home (default: ~/.weechat, may be overriden
by new command line arg --dir)
* after installing 0.1.8 (or with /upgrade), issue both commands (if you
didn't redefined these keys (alt-home/end):
/key unbind meta-meta2-1~
/key unbind meta-meta2-4~
@ -109,94 +95,72 @@ WeeChat - Wee Enhanced Environment for Chat
Alt-home/end were used for nicklist scroll, they're now replaced by
Alt-F11/F12.
* FlashCode, 2006-01-14
FlashCode, 2006-01-14::
WeeChat 0.1.7 released.
+
Important release notes:
- Ruby script plugin has been added but is experimental in this release.
* Ruby script plugin has been added but is experimental in this release.
You're warned!
- "/away" command was changed to be RFC 2812 compliant.
* "/away" command was changed to be RFC 2812 compliant.
Now argument is required to set away, and no argument means
remove away ("back"). Setting "irc_default_msg_away" has been removed.
* FlashCode, 2005-11-11
FlashCode, 2005-11-11::
WeeChat 0.1.6 released.
+
Important release notes:
- incompatibility with some old scripts: now all handlers have to return
* incompatibility with some old scripts: now all handlers have to return
a code for completion, and to do some actions about message to ignore
(please look at documentation for detail)
- on OpenBSD, the new option "plugins_extension" should be set to ".so.0.0"
* on OpenBSD, the new option "plugins_extension" should be set to ".so.0.0"
since the plugins names are ending by ".so.0.0" and not ".so"
- with new and full UTF-8 support, the option "look_charset_internal"
* with new and full UTF-8 support, the option "look_charset_internal"
should be set to blank for most cases. Forces it only if your locale is
not properly detected by WeeChat (you can set "UTF-8" or "ISO-8859-15"
for example, depending on your locale). WeeChat is looking for "UTF-8" in
your locale name at startup.
* FlashCode, 2005-09-24
FlashCode, 2005-09-24::
WeeChat 0.1.5 released.
* FlashCode, 2005-07-30
FlashCode, 2005-07-30::
WeeChat 0.1.4 released.
* FlashCode, 2005-07-02
FlashCode, 2005-07-02::
WeeChat 0.1.3 released.
* FlashCode, 2005-05-21
FlashCode, 2005-05-21::
WeeChat 0.1.2 released.
* FlashCode, 2005-03-20
FlashCode, 2005-03-20::
WeeChat 0.1.1 released.
* FlashCode, 2005-02-12
FlashCode, 2005-02-12::
WeeChat 0.1.0 released.
* FlashCode, 2005-01-01
FlashCode, 2005-01-01::
WeeChat 0.0.9 released.
* FlashCode, 2004-10-30
FlashCode, 2004-10-30::
WeeChat 0.0.8 released.
* FlashCode, 2004-08-08
FlashCode, 2004-08-08::
WeeChat 0.0.7 released.
* FlashCode, 2004-06-05
FlashCode, 2004-06-05::
WeeChat 0.0.6 released.
* FlashCode, 2004-02-07
FlashCode, 2004-02-07::
WeeChat 0.0.5 released.
* FlashCode, 2004-01-01
FlashCode, 2004-01-01::
WeeChat 0.0.4 released.
* FlashCode, 2003-11-03
FlashCode, 2003-11-03::
WeeChat 0.0.3 released.
* FlashCode, 2003-10-05
FlashCode, 2003-10-05::
WeeChat 0.0.2 released.
* FlashCode, 2003-09-27
FlashCode, 2003-09-27::
WeeChat 0.0.1 released.

31
README
View File

@ -1,5 +1,5 @@
WeeChat - Wee Enhanced Environment for Chat
===========================================
WeeChat Readme
==============
WeeChat (Wee Enhanced Environment for Chat) is a fast and light chat
@ -9,21 +9,25 @@ It is customizable and extensible with scripts.
Features
--------
* chat client with multi-protocols/servers connection
* many GUI (curses, Gtk, Qt) (1)
* small, fast and very light
* customizable and extensible with plugins (C, Perl, Python, Ruby, Lua)
* compliant with IRC RFCs 1459, 2810, 2811, 2812 and 2813
* developed from scratch
* multi-platform (GNU/Linux, *BSD, Mac OS X, QNX, Windows & other) (2)
* free software, released under GPLv3
* chat client with multi-protocols/servers connection
* many GUI (curses, Gtk, Qt) (1)
* small, fast and very light
* customizable and extensible with plugins (C, Perl, Python, Ruby, Lua)
* compliant with IRC RFCs 1459, 2810, 2811, 2812 and 2813
* developed from scratch
* multi-platform (GNU/Linux, *BSD, Mac OS X, QNX, Windows & other) (2)
* free software, released under GPLv3
NOTE: (1) only Curses interface is available today
+
(2) Windows version is under construction
Copyright
---------
WeeChat (c) Copyright 2003-2009 by FlashCode <flashcode@flashtux.org>
(see AUTHORS file if you want to contact authors)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
@ -37,8 +41,3 @@ GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
---
(1) only Curses interface is available today
(2) Windows version is under construction

5
TODO
View File

@ -1,5 +0,0 @@
WeeChat - Wee Enhanced Environment for Chat
===========================================
WeeChat TODO:
please look at https://savannah.nongnu.org/task/?group=weechat

24
configure.in
View File

@ -890,6 +890,25 @@ if test "x$enable_doc" = "xyes" ; then
AC_SUBST(DOC_XSL_PREFIX)
msg_doc="html $msg_doc"
fi
# check for asciidoc
DOC_ASCIIDOC8=""
AC_CHECK_PROGS(ASCIIDOC, [asciidoc])
if test -n "$ASCIIDOC"; then
AC_MSG_CHECKING([for asciidoc version])
asciidoc_version=`$ASCIIDOC --version 2>/dev/null`
case "${asciidoc_version}" in
asciidoc' '8*)
DOC_ASCIIDOC8="yes"
AC_MSG_RESULT([${asciidoc_version}])
msg_doc="asciidoc $msg_doc"
;;
*)
AC_MSG_RESULT([${asciidoc_version} (too old)])
;;
esac
fi
AC_SUBST(DOC_ASCIIDOC8)
else
not_asked="$not_asked doc"
msg_doc=""
@ -1001,11 +1020,6 @@ AC_OUTPUT([Makefile
doc/en/Makefile
doc/fr/Makefile
doc/de/Makefile
doc/ru/Makefile
doc/pl/Makefile
doc/cs/Makefile
doc/sco/Makefile
doc/sv/Makefile
src/Makefile
src/core/Makefile
src/plugins/Makefile

2
debian/weechat-core.docs vendored
View File

@ -1,5 +1,3 @@
AUTHORS
BUGS
NEWS
README
TODO

8
debian/weechat-doc.docs vendored
View File

@ -1,2 +1,6 @@
FAQ
FAQ.fr
doc/en/weechat_faq.en.txt
doc/en/weechat_quickstart.en.txt
doc/en/weechat_tester.en.txt
doc/fr/weechat_faq.fr.txt
doc/fr/weechat_quickstart.fr.txt
doc/fr/weechat_tester.fr.txt

51
doc/CMakeLists.txt
View File

@ -25,6 +25,12 @@ SET(DOC_LANGS
sv
)
SET(DOC_ASCIIDOC_FILES
faq
quickstart
tester
)
FIND_PROGRAM(
COPY cp
PATHS /bin /usr/bin /usr/local/bin /usr/pkg/bin
@ -47,6 +53,11 @@ FIND_FILE(DOC_XSL_PREFIX chunk.xsl PATHS
DOC "Path to nwalsh xsl stylesheet"
)
STRING(REPLACE "/html/chunk.xsl" "" DOC_XSL_PREFIX "${DOC_XSL_PREFIX}")
FIND_PROGRAM(
ASCIIDOC asciidoc
PATHS /bin /usr/bin /usr/local/bin /usr/pkg/bin
)
IF(XSLTPROC AND DOC_XSL_PREFIX AND COPY)
SET(BUILD_HTML TRUE)
@ -56,6 +67,10 @@ IF(DBLATEX AND COPY)
SET(BUILD_PDF TRUE)
ENDIF(DBLATEX AND COPY)
IF(ASCIIDOC)
SET(BUILD_ASCIIDOC TRUE)
ENDIF(ASCIIDOC)
IF(BUILD_HTML)
CONFIGURE_FILE(
${CMAKE_CURRENT_SOURCE_DIR}/weechat-html.xsl.in
@ -71,7 +86,7 @@ IF(BUILD_HTML)
ENDIF(BUILD_HTML)
IF(BUILD_HTML OR BUILD_PDF)
IF(BUILD_HTML OR BUILD_PDF OR BUILD_ASCIIDOC)
EXECUTE_PROCESS(
COMMAND date "+%F %T"
OUTPUT_VARIABLE DOC_DATE
@ -116,14 +131,14 @@ IF(BUILD_HTML OR BUILD_PDF)
${CMAKE_CURRENT_SOURCE_DIR}/weechat-html-one.xsl.in
${CMAKE_CURRENT_SOURCE_DIR}/weechat-html.xsl.in
${CMAKE_CURRENT_SOURCE_DIR}/weechat-doc.css
COMMENT "Building user guide - html doc (${dlang})"
COMMENT "Building user's guide - html doc (${dlang})"
)
ADD_CUSTOM_TARGET(doc-user-html-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html/${dlang}/user/index.html)
ADD_CUSTOM_TARGET(doc-user-html-one-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html-one/${dlang}/user/weechat_user.${dlang}.html)
INSTALL(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/${dlang}/user DESTINATION share/doc/${PROJECT_NAME}/html/${dlang}/)
ENDIF(BUILD_HTML)
IF(BUILD_PDF)
FILE(REMOVE_RECURSE ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/user)
FILE(MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/user)
@ -145,7 +160,7 @@ IF(BUILD_HTML OR BUILD_PDF)
${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/autogen/*
${CMAKE_CURRENT_SOURCE_DIR}/date.xml.in
${CMAKE_CURRENT_SOURCE_DIR}/weechat-html-one.xsl.in
COMMENT "Building user guide - pdf doc (${dlang})"
COMMENT "Building user's guide - pdf doc (${dlang})"
)
ADD_CUSTOM_TARGET(doc-user-pdf-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/user/weechat_user.${dlang}.pdf)
INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/user/weechat_user.${dlang}.pdf DESTINATION share/doc/${PROJECT_NAME})
@ -184,7 +199,7 @@ IF(BUILD_HTML OR BUILD_PDF)
${CMAKE_CURRENT_SOURCE_DIR}/weechat-html-one.xsl.in
${CMAKE_CURRENT_SOURCE_DIR}/weechat-html.xsl.in
${CMAKE_CURRENT_SOURCE_DIR}/weechat-doc.css
COMMENT "Building developer guide - html doc (${dlang})"
COMMENT "Building developer's guide - html doc (${dlang})"
)
ADD_CUSTOM_TARGET(doc-dev-html-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html/${dlang}/dev/index.html)
ADD_CUSTOM_TARGET(doc-dev-html-one-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html-one/${dlang}/dev/weechat_dev.${dlang}.html)
@ -213,7 +228,7 @@ IF(BUILD_HTML OR BUILD_PDF)
${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/autogen/*
${CMAKE_CURRENT_SOURCE_DIR}/date.xml.in
${CMAKE_CURRENT_SOURCE_DIR}/weechat-html-one.xsl.in
COMMENT "Building developer guide - pdf doc (${dlang})"
COMMENT "Building developer's guide - pdf doc (${dlang})"
)
ADD_CUSTOM_TARGET(doc-dev-pdf-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/dev/weechat_dev.${dlang}.pdf)
INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/dev/weechat_dev.${dlang}.pdf DESTINATION share/doc/${PROJECT_NAME})
@ -221,10 +236,32 @@ IF(BUILD_HTML OR BUILD_PDF)
ENDIF(BUILD_PDF)
ENDIF(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/dev/weechat_dev.${dlang}.xml)
# IF(BUILD_ASCIIDOC)
#
# FILE(MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang})
#
# FOREACH(doc ${DOC_ASCIIDOC_FILES})
#
# IF(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_${doc}.${dlang}.txt)
# ADD_CUSTOM_COMMAND(
# OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang}/weechat_${doc}.${dlang}.html
# COMMAND ${ASCIIDOC} ARGS -a toc -n -o ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang}/weechat_${doc}.${dlang}.html ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_${doc}.${dlang}.txt
# DEPENDS
# ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_${doc}.${dlang}.txt
# COMMENT "Building weechat_${doc}.${dlang}.html"
# )
# ADD_CUSTOM_TARGET(doc-${doc}-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang}/weechat_${doc}.${dlang}.html)
# INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang}/weechat_${doc}.${dlang}.html DESTINATION share/doc/${PROJECT_NAME})
# ENDIF(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_${doc}.${dlang}.txt)
#
# ENDFOREACH(doc ${DOC_ASCIIDOC_FILES})
#
# ENDIF(BUILD_ASCIIDOC)
ENDFOREACH(dlang ${DOC_LANGS})
ENDIF(BUILD_HTML OR BUILD_PDF)
ENDIF(BUILD_HTML OR BUILD_PDF OR BUILD_ASCIIDOC)
FOREACH(dlang ${DOC_LANGS})
IF(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_quickstart.${dlang}.txt)

2
doc/Makefile.am
View File

@ -14,7 +14,7 @@
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
SUBDIRS = . en fr de ru pl cs sco sv
SUBDIRS = . en fr de
man_MANS = weechat-curses.1

27
doc/cs/Makefile.am
View File

@ -1,27 +0,0 @@
# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
LANGCODE = cs
QUICKSTART = weechat_quickstart.$(LANGCODE).txt
EXTRA_DIST = $(QUICKSTART)
docdir = $(datadir)/doc/$(PACKAGE)
# install docs
install-data-hook:
$(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/

104
doc/cs/weechat_quickstart.cs.txt
View File

@ -1,104 +0,0 @@
WeeChat (česká verze, WeeChat <= 0.2.6)
=======================================
1. Spuštění weechat
Podle požadovaného GUI je třeba spustit:
- weechat-curses pro Curses GUI
- weechat-gtk pro GTK GUI (vyvíjí se)
- weechat-qt pro Qt GUI (není vyvíjeno)
- weechat-wxwidgets pro WxWidgets GUI (není vyvíjeno)
2. Online nápověda / možnosti
WeeChat má nápovědu pro všechny příkazy (/help příkaz)
Pro získání nápovědy k příkazu se používá /help příkaz
Pro nastavení voleb použijte /set volba = hodnota
Lze použít /set volba s částečným jménem (zobrazí všechny možnosti
obsahující písmena), nebo pouze s celým jménem volby bez hodnoty
(pro zobrazení dlouhé nápovědy k volbě).
Důležitá poznámka: nastavení je ukládáno při skončení WeeChat
(nebo pomocí příkazu /save). NEEDITUJTE kontiguracni soubor za
běhu WeeChat, protože do něj můŽe WeeChat kdykoliv zapsat
a není možné jej znovu načíst. Pro změnu jakýchkoliv voleb
použijte příkaz /set, WeeChat okamžitě použije nové nastavení.
3. Vytvoření serveru
Například irc.quakenet.org, port 6667:
/server add quakenet irc.quakenet.org 6667
(pro kompletní nápovědu použijte /help server)
4. Nastavení vlastních voleb serveru
Přezdívky:
/set quakenet.server_nick1 = "mujeprezdivka"
/set quakenet.server_nick2 = "mujeprezdivka2"
/set quakenet.server_nick3 = "mujeprezdivka3"
Uživatelské jméno / skutečné jméno:
/set quakenet.server_username = "moje uživatelské jméno"
/set quakenet.server_realname = "moje skutečné jméno"
Automatické připojení k serveru:
/set quakenet.server_autoconnect = on
Ostatní volby:
Pro zobrazení voleb serveru a jejich hodnot použijte /set quakenet
Pro nastavení volby použijte /set quakenet.volba_serveru = hodnota
5. Připojení k serveru a automatické připojení ke kanálům
/connect quakenet
6. Příchod/odchod na/z kanálu
Příchod na kanál:
/join #kanál
Odchod z kanálu:
/part [ukončovací zpráva]
Odchod z kanálu a zavření bufferu:
/close [ukončovací zpráva]
(/close je alias na /buffer close)
7. Správa bufferů/oken
Buffery lze spravovat pomocí příkazu "/buffer" a okna pomocí
příkazu "/window".
Například pro rozdělení okna vertikálně na malé okno (1/3 šíčky)
a velké (2/3) použijte příkaz:
/window splitv 33
8. Klávesové zkratky
Podle Vaší klávesnice a/nebo potřeb si můžete změnit jakoukoliv
klávesu pomocí příkazu "/key".
Užitečná klávesa je meta-k (alt-k) pro nalezení klávesového kódu.
Například pro napojení meta-y (alt-y) na příkaz "/buffer close""
/key (stiskněte meta-k) (stiskněte meta-y) /buffer close
Dostanete řádek podobný tomuto:
/key meta-y /buffer close
9. Pluginy/skripty
Na některých distibucích jako Debian, jsou pluginy dostupné v samostatném
balíčku (jako weechat-plugins).
Pluginy jsou automatikcy načteny při nalezení.
Pro WeeChat je dostupných spousta pluginů/skriptů, více na:
http://weechat.flashtux.org/plugins.php
Pro načítání/rušení pluginů/skriptů se podívejde do dokumentace WeeChat.
10. Další dokumentace
Nyní můžete používat WeeChat a číst FAQ/dokumentaci v případě dalších dotazů:
http://weechat.flashtux.org/faq.php
http://weechat.flashtux.org/doc.php
Uživejte si WeeChat!
--
(c) 2006-05-31, napsal FlashCode <flashcode@flashtux.org>, přeložil GolemJ <golemj@gmail.com>
This document is part of WeeChat and is distributed under GPL licence.
Tento dokunet je součástí WeeChat a je distribuován pod licencí GPL.

22
doc/de/Makefile.am
View File

@ -65,12 +65,14 @@ BOOK_DEV_INCLUDE = dev/plugins.$(LANGCODE).xml \
dev/plugin_c_api.$(LANGCODE).xml \
dev/plugin_script_api.$(LANGCODE).xml
QUICKSTART = weechat_quickstart.$(LANGCODE).txt
#FAQ = weechat_faq.$(LANGCODE).txt
#QUICKSTART = weechat_quickstart.$(LANGCODE).txt
#TESTER = weechat_tester.$(LANGCODE).txt
EXTRA_DIST = $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) \
user/$(BOOK_USER).xml $(BOOK_USER_INCLUDE) \
dev/$(BOOK_DEV).xml $(BOOK_DEV_INCLUDE) \
$(QUICKSTART)
$(FAQ) $(QUICKSTART) $(TESTER)
if DBLATEX_FOUND
PDF = user-pdf-stamp dev-pdf-stamp
@ -80,7 +82,7 @@ docdir = $(datadir)/doc/$(PACKAGE)
all-local: user-html-stamp dev-html-stamp $(PDF)
# user guide, HTML output with chunks (many pages)
# user's guide, HTML output with chunks (many pages)
user-html: user-html-stamp
@ -99,7 +101,7 @@ user-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER
cp ../weechat-doc.css html/user/
touch user-html-stamp
# user guide, HTML output, all in one page
# user's guide, HTML output, all in one page
user-html1: user-html1-stamp
@ -118,7 +120,7 @@ user-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USE
cp ../weechat-doc.css html1/user/
touch user-html1-stamp
# user guide, PDF output
# user's guide, PDF output
user-pdf: user-pdf-stamp
@ -136,7 +138,7 @@ user-pdf-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER)
cd build/user-pdf/ ; dblatex -o ../../pdf/user/$(BOOK_USER).pdf -P draft.mode=no -c ../../../dblatex.conf $(BOOK_USER).xml || true
touch user-pdf-stamp
# dev guide, HTML output with chunks (many pages)
# developer's guide, HTML output with chunks (many pages)
dev-html: dev-html-stamp
@ -155,7 +157,7 @@ dev-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV).x
cp ../weechat-doc.css html/dev/
touch dev-html-stamp
# dev guide, HTML output, all in one page
# developer's guide, HTML output, all in one page
dev-html1: dev-html1-stamp
@ -174,7 +176,7 @@ dev-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV).
cp ../weechat-doc.css html1/dev/
touch dev-html1-stamp
# dev guide, PDF output
# developer's guide, PDF output
dev-pdf: dev-pdf-stamp
@ -198,7 +200,9 @@ install-data-hook:
$(mkinstalldirs) $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/ $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/
$(INSTALL_DATA) html/user/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/
$(INSTALL_DATA) html/dev/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/
$(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/
# $(INSTALL_DATA) $(FAQ) $(DESTDIR)$(docdir)/
# $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/
# $(INSTALL_DATA) $(TESTER) $(DESTDIR)$(docdir)/
if DBLATEX_FOUND
$(INSTALL_DATA) pdf/user/$(BOOK_USER).pdf $(DESTDIR)$(docdir)/
$(INSTALL_DATA) pdf/dev/$(BOOK_DEV).pdf $(DESTDIR)$(docdir)/

15
doc/de/authors.de.xml
View File

@ -46,14 +46,7 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
<para>
<emphasis>kolter (Emmanuel Bouthenot)</emphasis>
<email>kolter AT openics.org</email> -
Entwickler
</para>
</listitem>
<listitem>
<para>
<emphasis>Ptitlouis</emphasis>
<email>ptitlouis AT sysif.net</email> -
erzeugt Debian-Pakete
Entwickler, erzeugt Debian-Pakete
</para>
</listitem>
</itemizedlist>
@ -67,6 +60,12 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
<para>
Die folgenden Personen trugen zur Entwicklung von WeeChat bei:
<itemizedlist>
<listitem>
<para>
<emphasis>Ptitlouis</emphasis> -
Erzeugt Debian-Pakete
</para>
</listitem>
<listitem>
<para>
<emphasis>Jiri Golembiovsky</emphasis> -

109
doc/de/weechat_quickstart.de.txt
View File

@ -1,109 +0,0 @@
WeeChat Schnellstarter (deutsche Version, für WeeChat <= 0.2.6)
===============================================================
1. Weechat starten
Entsprechend dem gewählten User-Interface müssen Du starten:
- weechat-curses für das Curses GUI
- weechat-gtk für das Gtk GUI (in Entwicklung)
- weechat-qt für das Qt GUI (in Planung)
- weechat-wxwidgets für das WxWidgets GUI (in Planung)
2. Online-Hilfe / Optionen
WeeChat hat eine eingebaute Hilfe für all Kommandos, tippe einfach /help
Um Hilfe zu einem Kommando zu bekommen, tippe /help Kommando
Um Optionen zu verändern, benutzt du /set Option = Wert
Du brauchst /set Option nur mit den Anfangsbuchstaben eingeben
(<tab> zeigt alle Optionen mit den gleichen Buchstaben) oder mit dem vollen
Namen ohne einen Wert, um eine ausführliche Hilfe zu bekommen.
Wichtig: die Einstellungen werden gespeichert, wenn WeeChat beendet wird
(oder mit dem Befehl /save). Verändere die Einstellungen nicht, wenn WeeChat
läuft, weil WeeChat diese Datei zu jeder Zeit überschreiben kann und
Änderungen verloren sind. Um irgendeine Einstellung zu verändern, verwendest du
das /set Kommando, WeeChat wird die neuen Einstellungen umgehend übernehmen.
3. Einen Server-Eintrag anlegen
Zum Beispiel für irc.quakenet.org, Port 6667:
/server add quakenet irc.quakenet.org 6667
(/help Server für volle Hilfe zu diesem Kommando)
4. Eigene Server-Optionen setzen
Nickname:
/set quakenet.server_nick1 = "mynick"
/set quakenet.server_nick2 = "mynick2"
/set quakenet.server_nick3 = "mynick3"
Username/Klarname:
/set quakenet.server_username = "My username"
/set quakenet.server_realname = "My real name"
Automatische Server-Verbindung:
/set quakenet.server_autoconnect = on
Automatisches Betreten eines Channels:
/set quakenet.server_autojoin = "#chan1,#chan2"
Andere Optionen:
Du kannst die Server-Optionen und ihre Werte mit /set quakenet sehen
Um eine Option zu setzen, tippe /set quakenet.option = Wert
5. Verbinden zu einem Server und automatisch einen Channel betreten
/connect quakenet
6. Channels betreten/verlassen
Einen Channel betreten:
/join #channel
Einen Channel verlassen:
/part [Nachricht]
Einen Channel verlassen und den Buffer schliessen:
/close [Nachricht]
(/close ist ein Alias für /buffer close)
7. Buffer/Fenster Management
Du kannst die einzelnen Buffer mit /buffer und Fenster mit /window
verwalten.
Um zum Beispiel das Fenster in ein kleineres (1/3 breit) und ein
grosses (2/3 breit) zu teilen, nutzt du das folgende Kommando:
/window splitv 33
8. Tastenkombinationen
Entsprechend deiner Tastatur und/oder deinen Wünschen, kannst du jede Taste
mit "/key" neu zuordnen.
Eine nützliche Taste ist meta-k (alt-k), sie zeigt die Tastaturcodes an.
Um zum Beispiel meta-y (alt-y) dem Kommando "/buffer close" zuzuordnen:
/key (tippe meta-k) (tippe meta-y) /buffer close
Und du bekommst damit die Kommandozeile:
/key meta-y /buffer close
9. Plugins/Skripte
In einigen Distributionen, wie zum Beispiel Debian, sind Plugins in separaten
Paketen verfügbar (wie weechat-plugins). Plugins werden automatisch geladen,
wenn welche gefunden wurden.
Viele Plugins/Skripte für WeeChat sind zu finden auf:
http://weechat.flashtux.org/plugins.php
Bitte lies für das Laden/Entladen von Plugins oder Skripten die Dokumentation.
10. Mehr Dokumentation
Jetzt kannst du WeeChat starten und die FAQ/Dokumentation lesen, falls du weitere
Fragen hast:
http://weechat.flashtux.org/faq.php
http://weechat.flashtux.org/doc.php
Viel Spass mit WeeChat!
--
(c) 2006-05-31, written by FlashCode <flashcode@flashtux.org>
This document is part of WeeChat and is distributed under GPL licence.

18
doc/en/Makefile.am
View File

@ -65,12 +65,14 @@ BOOK_DEV_INCLUDE = dev/plugins.$(LANGCODE).xml \
dev/plugin_c_api.$(LANGCODE).xml \
dev/plugin_script_api.$(LANGCODE).xml
FAQ = weechat_faq.$(LANGCODE).txt
QUICKSTART = weechat_quickstart.$(LANGCODE).txt
TESTER = weechat_tester.$(LANGCODE).txt
EXTRA_DIST = $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) \
user/$(BOOK_USER).xml $(BOOK_USER_INCLUDE) \
dev/$(BOOK_DEV).xml $(BOOK_DEV_INCLUDE) \
$(QUICKSTART)
$(FAQ) $(QUICKSTART) $(TESTER)
if DBLATEX_FOUND
PDF = user-pdf-stamp dev-pdf-stamp
@ -80,7 +82,7 @@ docdir = $(datadir)/doc/$(PACKAGE)
all-local: user-html-stamp dev-html-stamp $(PDF)
# user guide, HTML output with chunks (many pages)
# user's guide, HTML output with chunks (many pages)
user-html: user-html-stamp
@ -99,7 +101,7 @@ user-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER
cp ../weechat-doc.css html/user/
touch user-html-stamp
# user guide, HTML output, all in one page
# user's guide, HTML output, all in one page
user-html1: user-html1-stamp
@ -118,7 +120,7 @@ user-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USE
cp ../weechat-doc.css html1/user/
touch user-html1-stamp
# user guide, PDF output
# user's guide, PDF output
user-pdf: user-pdf-stamp
@ -136,7 +138,7 @@ user-pdf-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER)
cd build/user-pdf/ ; dblatex -o ../../pdf/user/$(BOOK_USER).pdf -P draft.mode=no -c ../../../dblatex.conf $(BOOK_USER).xml || true
touch user-pdf-stamp
# dev guide, HTML output with chunks (many pages)
# developer's guide, HTML output with chunks (many pages)
dev-html: dev-html-stamp
@ -155,7 +157,7 @@ dev-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV).x
cp ../weechat-doc.css html/dev/
touch dev-html-stamp
# dev guide, HTML output, all in one page
# developer's guide, HTML output, all in one page
dev-html1: dev-html1-stamp
@ -174,7 +176,7 @@ dev-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV).
cp ../weechat-doc.css html1/dev/
touch dev-html1-stamp
# dev guide, PDF output
# developer's guide, PDF output
dev-pdf: dev-pdf-stamp
@ -198,7 +200,9 @@ install-data-hook:
$(mkinstalldirs) $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/ $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/
$(INSTALL_DATA) html/user/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/
$(INSTALL_DATA) html/dev/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/
$(INSTALL_DATA) $(FAQ) $(DESTDIR)$(docdir)/
$(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/
$(INSTALL_DATA) $(TESTER) $(DESTDIR)$(docdir)/
if DBLATEX_FOUND
$(INSTALL_DATA) pdf/user/$(BOOK_USER).pdf $(DESTDIR)$(docdir)/
$(INSTALL_DATA) pdf/dev/$(BOOK_DEV).pdf $(DESTDIR)$(docdir)/

15
doc/en/authors.en.xml
View File

@ -46,14 +46,7 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
<para>
<emphasis>kolter (Emmanuel Bouthenot)</emphasis>
<email>kolter AT openics.org</email> -
developer
</para>
</listitem>
<listitem>
<para>
<emphasis>Ptitlouis</emphasis>
<email>ptitlouis AT sysif.net</email> -
Debian packager
developer, Debian packager
</para>
</listitem>
</itemizedlist>
@ -67,6 +60,12 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
<para>
Following people contributed to WeeChat:
<itemizedlist>
<listitem>
<para>
<emphasis>Ptitlouis</emphasis> -
first debian packager
</para>
</listitem>
<listitem>
<para>
<emphasis>Jiri Golembiovsky</emphasis> -

322
doc/en/weechat_faq.en.txt Normal file
View File

@ -0,0 +1,322 @@
WeeChat Frequently Asked Questions (FAQ)
========================================
FlashCode <flashcode@flashtux.org>
v0.3.0-dev, 2009-05-15
General
-------
[[why_choose_weechat]]
Why choose WeeChat? X-Chat and Irssi are so good...
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Because WeeChat is very light and has new features.
Some features (version > = 0.3.x):
* multi-protocols support via plugins (IRC, Jabber)
* many remote 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
Compilation / install
---------------------
[[gui]]
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 under development).
[[compile_git]]
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.
Using WeeChat
-------------
[[lost]]
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).
[[buffer_vs_window]]
I heard about "buffer" and "window", what's the difference?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A 'buffer' is composed by a number, a name, lines displayed (and some other
data).
A 'window' is a screen area which displays a buffer. It is possible to split
screen into many windows.
Each window displays one buffer. A buffer can be hidden (not displayed by a
window) or displayed by one or more windows.
[[charset]]
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, your
locale is probably wrong.
* setup global decode value, for example:
** with WeeChat < = 0.2.6: `/setp charset.global.decode = ISO-8859-15`
** with WeeChat > = 0.3.x: `/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)
** if you are using screen, check that it is run with UTF-8 mode
("`defutf8 on`" in ~/.screenrc or `screen -U` to run screen)
[[bars_background]]
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 output of
`echo $TERM` in your terminal).
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"`.
[[screen_weird_chars]]
When I'm using weechat under screen, I have weird random chars, how to fix that?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This may be caused by bad value of TERM variable (look at output of
`echo $TERM` in your terminal).
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"`.
[[key_bindings]]
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.
[[openbsd_plugins]]
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"`
* with WeeChat > = 0.3.x: `/set weechat.plugin.extension ".so.0.0"`
Then: `/plugin autoload`.
[[scripts]]
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.3.x.
[[change_locale_without_quit]]
I want to change language used by WeeChat for messages, but without exiting WeeChat, is it possible?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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`.
[[terminal_copy_paste]]
With Curses GUI, how can I copy/paste text without pasting nicklist?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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.3.x: `/bar set nicklist position top`
[[highlight_notification]]
How to be warned when someone highlights me on a channel?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You can use script 'sound.pl' (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.3.x:
`/set plugins.var.perl.sound.cmd_highlight "/path/command arguments"`
Many other scripts exist for notification, please look at plugins/scripts page:
http://weechat.flashtux.org/plugins.php
[[filter_irc_join_part_quit]]
How can I filter join/part/quit messages on IRC channels?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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.3.x:
** 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)
[[ignore_vs_filter]]
What is the difference between /ignore and /filter commands?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The `/ignore` command is an IRC command, so it applies only for IRC buffers
(servers and channels).
It lets you ignore some nicks or hostname for a server or channel (command
will not apply on content of messages).
Matching messages are deleted by IRC plugin before display (so you'll
never see them).
The `/filter` command is a core command, so it applies on any buffer.
It lets you filter some lines in buffers with tags or regular expression for
prefix and content of line.
Filtered lines are only hidden, not deleted, and you can see them if you
disable filters (by default, key alt + "=" toggles filters).
Development
-----------
[[bug_task_patch]]
How should I report bug, ask new feature or send a patch?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
There are 3 ways:
. you can join us on IRC: 'irc.freenode.net', channel '#weechat'
. you can use savannah website:
* report a bug: https://savannah.nongnu.org/bugs/?group=weechat
* request a new feature: https://savannah.nongnu.org/task/?group=weechat
* send a patch: https://savannah.nongnu.org/patch/?group=weechat
. you can mail developers, look at support page for developer's mails:
http://weechat.flashtux.org/support.php
(you can subscribe and send to "support" mailing list)
[[supported_os]]
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.
[[help_developers]]
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
[[donate]]
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

285
doc/en/weechat_quickstart.en.txt
View File

@ -1,210 +1,233 @@
WeeChat quick start guide (english version, for WeeChat >= 0.3.x)
=================================================================
WeeChat quick start guide
=========================
FlashCode <flashcode@flashtux.org>
v0.3.0-dev, 2009-05-15
1. Launch weechat
A recommended terminal emulator for X (but not mandatory) is rxvt-unicode
(it has good UTF-8 support, and no problem with default keyboard bindings).
[[start]]
Start weechat
-------------
Run "weechat-curses" from your shell.
A recommended terminal emulator for X (but not mandatory) is rxvt-unicode
(it has good UTF-8 support, and no problem with default keyboard bindings).
2. Online help / options
Run "weechat-curses" from your shell.
WeeChat has help for all commands, just issue /help
To get help on a command, issue /help command
To set options, use /set config.section.option value
(where config is configuration name ("weechat" for core, or a plugin
name), "section" the section of this configuration and "option" the
option name).
[[help_options]]
Online help / options
---------------------
WeeChat immediately uses new value (you *never* need to restart WeeChat
after changes to configuration).
WeeChat has help for all commands, just issue /help
To get help on a command, issue `/help command`
You can use /set option with partial name and wildcard "*" at beginning or
end to display all options containg letters.
For example:
To set options, use `/set config.section.option value`
(where `config` is configuration name (`weechat` for core, or a plugin
name), `section` the section of this configuration and `option` the
option name).
/set => display all options (WeeChat and plugins)
/set weechat.* => display WeeChat options
/set irc.* => display IRC plugin options
WeeChat immediately uses new value (you *never* need to restart WeeChat
after changes to configuration).
You can display help for an option with /help, for example:
You can use `/set` option with partial name and wildcard "*" at beginning or
end to display all options containg letters.
For example:
/help weechat.look.highlight
`/set`::
display all options (WeeChat and plugins)
All settings are saved when WeeChat ends (or with "/save" command to force
write of options).
`/set weechat.*`::
display WeeChat options
You can edit configuration files (*.conf) by hand and reload them by
/reload command if you don't want to use /set command.
`/set irc.*`::
display IRC plugin options
3. Core vs plugins
You can display help for an option with `/help`, for example:
`/help weechat.look.highlight`.
WeeChat "core" is only used to display data on screen and interact with
user, that means weechat core without plugins is useless
(faithful users: IRC was part of core for versions <= 0.2.6).
All settings are saved when WeeChat ends (or with `/save` command to force
write of options).
All network protocols like IRC are provided in separate plugins.
You can edit configuration files (*.conf) by hand and reload them by
`/reload` command if you don't want to use `/set` command.
Use /plugin command to list loaded plugins, you should see "irc" and
other plugins in list.
4. Create an IRC server
[[core_vs_plugins]]
Core vs plugins
---------------
You can add an IRC server with /server command, for example:
WeeChat "core" is only used to display data on screen and interact with
user, that means weechat core without plugins is useless
(faithful users: IRC was part of core for versions < = 0.2.6).
/server add oftc irc.oftc.org 6667
All network protocols like IRC are provided in separate plugins.
As usual, help is available if you're lost:
Use `/plugin` command to list loaded plugins, you should see "irc" and
other plugins in list.
/help server
5. Set custom IRC server options
[[create_irc_server]]
Create an IRC server
--------------------
WeeChat uses default values for all servers ("fallbacks"), if you
don't specify a specific value for a server option.
These default options are "irc.server_default.*".
You can add an IRC server with `/server` command, for example:
For each server option, WeeChat uses its value if it is defined (not
"null"). Otherwise WeeChat uses default value (irc.server_default.xxx).
/server add oftc irc.oftc.org 6667
For example there's default nicks (based on your un*x login), and you can
override them for oftc server with following command:
As usual, help is available if you're lost: `/help server`
/set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5"
To set username and realname:
[[irc_server_options]]
Set custom IRC server options
-----------------------------
/set irc.server.oftc.username "My user name"
/set irc.server.oftc.realname "My real name"
WeeChat uses default values for all servers ("fallbacks"), if you
don't specify a specific value for a server option.
These default options are "irc.server_default.*".
To enable auto-connect to server at startup:
For each server option, WeeChat uses its value if it is defined (not
"null"). Otherwise WeeChat uses default value ("irc.server_default.xxx").
/set irc.server.oftc.autoconnect on
For example there's default nicks (based on your un*x login), and you can
override them for oftc server with following command:
To run a command after connection to server, for example to identify
with nickserv:
/set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5"
/set irc.server.oftc.command "/msg nickserv identify xxxxxx"
To set username and realname:
Note: many commmands can be separated by ';' (semi-colon)
/set irc.server.oftc.username "My user name"
/set irc.server.oftc.realname "My real name"
To auto-join some channels when connecting to server:
To enable auto-connect to server at startup:
/set irc.server.oftc.autojoin "#channel1,#channel2"
/set irc.server.oftc.autoconnect on
To remove value of a server option, and use default value instead,
for example to use default nicks (irc.server_default.nicks):
To run a command after connection to server, for example to identify
with nickserv:
/set irc.server.oftc.nicks null
/set irc.server.oftc.command "/msg nickserv identify xxxxxx"
Other options:
You can setup other options with following command ("xxx" is option
name):
Note: many commmands can be separated by ';' (semi-colon)
/set irc.server.oftc.xxx value
To auto-join some channels when connecting to server:
6. Connect to IRC server and auto-join channels
/set irc.server.oftc.autojoin "#channel1,#channel2"
/connect oftc
To remove value of a server option, and use default value instead,
for example to use default nicks (irc.server_default.nicks):
Note: this command can be used to create and connect to a new server
without using /server command (should I repeat you can see help for
this command with /help connect ? ;)
/set irc.server.oftc.nicks null
7. Join/part IRC channels
Other options: you can setup other options with following command ("xxx" is
option name):
Join a channel:
/set irc.server.oftc.xxx value
/join #channel
Part a channel:
[[connect_to_irc_server]]
Connect to IRC server and auto-join channels
--------------------------------------------
/part [quit message]
/connect oftc
Close server or channel buffer:
Note: this command can be used to create and connect to a new server
without using `/server` command (should I repeat you can see help for
this command with `/help connect` ? ;)
/close [quit message]
(/close is an alias on /buffer close)
[[join_part_irc_channels]]
Join/part IRC channels
----------------------
8. Buffer/window management
`/join #channel`::
join a channel
A buffer is a component linked to a plugin with a number with a category
and a name. Buffer contains data displayed on screen.
`/part [quit message]`::
part a channel (keeping buffer open)
A window is a view on a buffer. By default there's only one window
displaying one buffer. If you split screen, you will see many windows
with many buffers at same time.
`/close [quit message]`::
close server or channel buffer (`/close` is an alias on `/buffer close`)
Commands to manage buffers and windows:
/buffer
/window
[[buffer_window]]
Buffer/window management
------------------------
(I'll not repeat here that you can get help with /help on these commands)
A buffer is a component linked to a plugin with a number with a category
and a name. Buffer contains data displayed on screen.
For example, to split verticaly screen into a small window (1/3 width),
and a large (2/3), use command:
A window is a view on a buffer. By default there's only one window
displaying one buffer. If you split screen, you will see many windows
with many buffers at same time.
/window splitv 33
Commands to manage buffers and windows:
9. Key bindings
/buffer
/window
WeeChat uses many keys by default. All these keys are in documentation,
but you should know at least some vital keys:
- alt + left/right arrows (or F5/F6): switch to previous/next buffer
- F7/F8: switch to previous/next window (when screen is split)
- F9/F10: scroll title bar
- F11/F12: scroll nicklist
- tab: complete text in input bar, like in your shell
- page up/down: scroll text in current buffer
- alt + A: jump to buffer with activity (in hotlist)
(I'll not repeat here that you can get help with /help on these commands)
According to your keyboard and/or your needs, you can rebind any key
to a command with "/key" command.
A useful key is meta-k (alt-k) to find key codes.
For example, to split verticaly screen into a small window (1/3 width),
and a large (2/3), use command:
For example, to bind meta-y (alt-y) to command "/buffer close":
/window splitv 33
/key (press meta-k) (press meta-y) /buffer close
You'll have a command line like:
[[key_bindings]]
Key bindings
------------
/key meta-y /buffer close
WeeChat uses many keys by default. All these keys are in documentation,
but you should know at least some vital keys:
To remove key:
- 'alt + left/right arrows' (or 'F5'/'F6'): switch to previous/next buffer
- 'F7'/'F8': switch to previous/next window (when screen is split)
- 'F9'/'F10': scroll title bar
- 'F11'/'F12': scroll nicklist
- 'tab': complete text in input bar, like in your shell
- 'page up/down': scroll text in current buffer
- 'alt + A': jump to buffer with activity (in hotlist)
/key unbind meta-y
According to your keyboard and/or your needs, you can rebind any key
to a command with `/key` command.
A useful key is meta-k (alt-k) to find key codes.
10. Plugins/scripts
For example, to bind meta-y (alt-y) to command `/buffer close`:
On some distros like Debian, plugins are available via a separate package
(like weechat-plugins).
Plugins are automatically loaded when found.
/key bind (press meta-k) (press meta-y) /buffer close
Some plugins let you use scripts in WeeChat (in many languages like Perl,
Python, Ruby, Lua and Tcl). These plugins must be loaded with /plugin
command and they provide commands like /perl, used to load scripts.
You'll have a command line like:
Many external plugins/scripts (from contributors) are available for
WeeChat, please look at:
/key bind meta-y /buffer close
http://weechat.flashtux.org/plugins.php
To remove key:
Please look at WeeChat documentation to load/unload plugins or scripts.
/key unbind meta-y
11. More documentation
You can now use WeeChat and read FAQ/documentation for any other question:
[[plugins_scripts]]
Plugins/scripts
---------------
http://weechat.flashtux.org/faq.php
http://weechat.flashtux.org/doc.php
On some distros like Debian, plugins are available via a separate package
(like weechat-plugins).
Plugins are automatically loaded when found.
Enjoy WeeChat!
Some plugins let you use scripts in WeeChat (in many languages like Perl,
Python, Ruby, Lua and Tcl). These plugins must be loaded with `/plugin`
command and they provide commands like `/perl`, used to load scripts.
--
(c) 2006-2009, written by FlashCode <flashcode@flashtux.org>
Last edited on 2009-05-11.
This document is part of WeeChat and is distributed under GPL 3 licence.
Many external plugins/scripts (from contributors) are available for
WeeChat: http://weechat.flashtux.org/plugins.php
Please look at WeeChat documentation to load/unload plugins or scripts.
[[more_doc]]
More documentation
------------------
You can now use WeeChat and read FAQ/documentation for any other question:
http://weechat.flashtux.org/doc.php
Enjoy WeeChat!

140
doc/en/weechat_tester.en.txt Normal file
View File

@ -0,0 +1,140 @@
WeeChat tester's Guide
======================
FlashCode <flashcode@flashtux.org>
v0.3.0-dev, 2009-05-15
[[purpose]]
Purpose
-------
Many thankful users ask us how can they help developing WeeChat. The
easiest (and also most tricky) way to help developing WeeChat is
testing!
Testing is very important part of software development and should not be
underestimated. When some features are implemented it should be tested, but for
some features there are too many use cases or these cases are tricky and
developers can't try out every case.
For example: notorious charset plugin introduced in WeeChat 0.2.2: noone of us
(developers, contributors and testers) used channels with national characters
in their names and when 0.2.2 was released we got flooded by russian users
blaming us. If we have more testers it should not happen again in future.
Testing stable version of WeeChat is pointless because developers are busy
implementing new stuff (and fixing old bugs) all the time.
[[prepare_system]]
Prepare your system
-------------------
It would help us a lot if you enable Linux 'core' files: if WeeChat crashes,
Linux will write a file called 'core'. This file contains very useful debug
info, to know exactly where is problem in WeeChat.
If you're using 'bash' shell, add following line to your `~/.bashrc`:
ulimit -c unlimited
[[download]]
Download devel version
----------------------
Fresh code (with last bugs and features) is stored in GIT repository.
You may decide to build it manually (recommended way):
* GIT version can be built and installed in parallel to stable version,
* you don't need root access, you don't need to sacrifice stable version of
WeeChat.
[[get_sources]]
Get and build sources
~~~~~~~~~~~~~~~~~~~~~
First create a directory, for example 'weechat-git':
---------------------
$ mkdir ~/weechat-git
$ cd ~/weechat-git
---------------------
If you have git installed, you can clone git repository (recommended way):
--------------------------------------------
$ git clone git://git.sv.gnu.org/weechat.git
$ cd weechat
--------------------------------------------
NOTE: Later, you can run "`git pull`" in this directory, to get deltas with
today's version.
Otherwise you can download and unpack 'devel' package:
-----------------------------------------------------------------
$ wget http://weechat.flashtux.org/download/weechat-devel.tar.bz2
$ tar xvjf weechat-devel.tar.bz2
$ cd weechat-devel
-----------------------------------------------------------------
To build sources, cmake is recommended:
--------------------------------------------------------------
$ mkdir build
$ cd build
$ cmake .. -DPREFIX=$HOME/weechat-git -DCMAKE_BUILD_TYPE=Debug
$ make
$ make install
--------------------------------------------------------------
If you don't have cmake, it's still possible to use autotools:
----------------------------------------------------------
$ ./autogen.sh # (only if you cloned git repository)
$ ./configure --prefix=$HOME/weechat-git
$ make
$ make install
----------------------------------------------------------
[[install_binary_package]]
Install binary package
~~~~~~~~~~~~~~~~~~~~~~
According to your Linux distribution:
* Debian: http://debian.flashtux.org/
* Gentoo: http://weechat.flashtux.org/download.php
* ArchLinux: PKGBUILD from http://aur.archlinux.org/
* other: we don't know! Eheh.
[[run]]
Run WeeChat
-----------
It's recommended to run WeeChat with another directory (different from stable
version), with option `--dir`.
Command is:
~/weechat-git/bin/weechat-curses --dir ~/.weechat-dev
If you're still awake you should see familiar interface and brag about
having newest possible version of WeeChat. ;)
Now if you experience strange behavior (it may have issues or crash or boil
your beer) don't hesitate to join `#weechat` at `irc.freenode.net` and tell us.
If it doesn't crash - tell us too, we need your feedback!
[[links]]
Useful links
------------
* GIT repository: http://git.savannah.gnu.org/gitweb/?p=weechat.git
* Bug tracker: https://savannah.nongnu.org/bugs/?group=weechat
* WeeChat commits RSS feed: http://git.savannah.gnu.org/gitweb/?p=weechat.git;a=rss

18
doc/fr/Makefile.am
View File

@ -65,12 +65,14 @@ BOOK_DEV_INCLUDE = dev/plugins.$(LANGCODE).xml \
dev/plugin_c_api.$(LANGCODE).xml \
dev/plugin_script_api.$(LANGCODE).xml
FAQ = weechat_faq.$(LANGCODE).txt
QUICKSTART = weechat_quickstart.$(LANGCODE).txt
TESTER = weechat_tester.$(LANGCODE).txt
EXTRA_DIST = $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) \
user/$(BOOK_USER).xml $(BOOK_USER_INCLUDE) \
dev/$(BOOK_DEV).xml $(BOOK_DEV_INCLUDE) \
$(QUICKSTART)
$(FAQ) $(QUICKSTART) $(TESTER)
if DBLATEX_FOUND
PDF = user-pdf-stamp dev-pdf-stamp
@ -80,7 +82,7 @@ docdir = $(datadir)/doc/$(PACKAGE)
all-local: user-html-stamp dev-html-stamp $(PDF)
# user guide, HTML output with chunks (many pages)
# user's guide, HTML output with chunks (many pages)
user-html: user-html-stamp
@ -99,7 +101,7 @@ user-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER
cp ../weechat-doc.css html/user/
touch user-html-stamp
# user guide, HTML output, all in one page
# user's guide, HTML output, all in one page
user-html1: user-html1-stamp
@ -118,7 +120,7 @@ user-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USE
cp ../weechat-doc.css html1/user/
touch user-html1-stamp
# user guide, PDF output
# user's guide, PDF output
user-pdf: user-pdf-stamp
@ -136,7 +138,7 @@ user-pdf-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER)
cd build/user-pdf/ ; dblatex -o ../../pdf/user/$(BOOK_USER).pdf -P draft.mode=no -c ../../../dblatex.conf $(BOOK_USER).xml || true
touch user-pdf-stamp
# dev guide, HTML output with chunks (many pages)
# developer's guide, HTML output with chunks (many pages)
dev-html: dev-html-stamp
@ -155,7 +157,7 @@ dev-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV).x
cp ../weechat-doc.css html/dev/
touch dev-html-stamp
# dev guide, HTML output, all in one page
# developer's guide, HTML output, all in one page
dev-html1: dev-html1-stamp
@ -174,7 +176,7 @@ dev-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV).
cp ../weechat-doc.css html1/dev/
touch dev-html1-stamp
# dev guide, PDF output
# developer's guide, PDF output
dev-pdf: dev-pdf-stamp
@ -198,7 +200,9 @@ install-data-hook:
$(mkinstalldirs) $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/ $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/
$(INSTALL_DATA) html/user/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/
$(INSTALL_DATA) html/dev/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/
$(INSTALL_DATA) $(FAQ) $(DESTDIR)$(docdir)/
$(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/
$(INSTALL_DATA) $(TESTER) $(DESTDIR)$(docdir)/
if DBLATEX_FOUND
$(INSTALL_DATA) pdf/user/$(BOOK_USER).pdf $(DESTDIR)$(docdir)/
$(INSTALL_DATA) pdf/dev/$(BOOK_DEV).pdf $(DESTDIR)$(docdir)/

15
doc/fr/authors.fr.xml
View File

@ -46,14 +46,7 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
<para>
<emphasis>kolter (Emmanuel Bouthenot)</emphasis>
<email>kolter AT openics.org</email> -
développeur
</para>
</listitem>
<listitem>
<para>
<emphasis>Ptitlouis</emphasis>
<email>ptitlouis AT sysif.net</email> -
empaqueteur Debian
développeur, empaqueteur Debian
</para>
</listitem>
</itemizedlist>
@ -67,6 +60,12 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
<para>
Les personnes suivantes ont contribué à WeeChat :
<itemizedlist>
<listitem>
<para>
<emphasis>Ptitlouis</emphasis> -
premier empaqueteur Debian
</para>
</listitem>
<listitem>
<para>
<emphasis>Jiri Golembiovsky</emphasis> -

338
doc/fr/weechat_faq.fr.txt Normal file
View File

@ -0,0 +1,338 @@
WeeChat - Questions Fréquemment Posées (FAQ)
============================================
FlashCode <flashcode@flashtux.org>
v0.3.0-dev, 2009-05-15
Général
-------
[[why_choose_weechat]]
Pourquoi choisir WeeChat ? X-Chat et Irssi sont si bien...
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Parce que WeeChat est très léger et a de nouvelles fonctionnalités.
Quelques fonctionnalités (version > = 0.3.x) :
* support multi-protocoles via extensions (IRC, Jabber)
* plusieurs interfaces déportées en plus de Curses (à venir bientôt)
* disponible en plusieurs langues
* extensible par des extensions (C, Perl, Python, Ruby, Lua, Tcl)
* tampons avec contenu libre
* filtrage de l'affichage avec tags et expressions régulières
* découpage de la fenêtre horizontalement et verticalement
* barres personnalisables et extensibles
* liste des pseudos disponible dans toutes les interfaces
* recherche incrémentale de texte dans les tampons, saut aux highlights
* tube FIFO pour contrôle à distance
* support aspell
* double encodage (décodage/encodage)
* développé à partir de zéro (non basé sur un quelconque client)
* multi-platformes
* 100% GPL et libre
Plus d'infos sur cette page :
http://weechat.flashtux.org/features.php
Compilation / installation
--------------------------
[[gui]]
J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je les compiler/utiliser ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Aujourd'hui seule l'interface Curses est disponible.
D'autres interfaces seront disponibles en mode distant (actuellement
en développement).
[[compile_git]]
Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
La méthode recommandée pour compiler WeeChat est d'utiliser cmake.
Si vous compilez avec les autotools (et non cmake), vérifiez que vous avez bien
la dernière version d'autoconf et automake (WeeChat est développé avec autoconf
2.61 et automake 1.10.1).
Une autre façon de faire est de compiler le "paquet devel", qui nécessite moins
de dépendences. Ce paquet est construit quasiment tous les jours à partir de la
base git. Notez que ce paquet peut ne pas correspondre exactement à la base
git et qu'il est moins pratique que de cloner la base git pour installer des
mises à jour.
Utilisation de WeeChat
----------------------
[[lost]]
J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Pour obtenir de l'aide tapez `/help`. Pour de l'aide sur une commande, tapez
`/help commande`. Les touches et commandes sont listées dans la documentation.
Il est recommandé pour les nouveaux utilisateurs de lire le guide de démarrage
rapide (voir la page de doc sur le site).
[[buffer_vs_window]]
J'ai entendu parler de "buffer" et "window", quelle est la différence ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Un tampon ('buffer') est composé d'un numéro, un nom, des lignes affichées
(ainsi que d'autres données).
Une fenêtre ('window') est une zone de l'écran affichant un tampon. Il est
possible de découper l'écran horizontaleent ou verticalement en plusieurs
fenêtres.
Chaque fenêtre affiche un tampon. Un tampon peut être caché (affiché par
aucune fenêtre) ou affiché par une ou plusieurs fenêtres.
[[charset]]
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.3.x : `/set charset.default.decode "ISO-8859-15"`
* si vous utilisez la locale UTF-8 :
** vérifiez que votre terminal est compatible UTF-8
(un terminal conseillé pour l'UTF-8 est rxvt-unicode)
** si vous utilisez screen, vérifiez qu'il est lancé en mode UTF-8
("`defutf8 on`" dans ~/.screnrc ou `screen -U` pour lancer screen)
[[bars_background]]
Des barres telles que le titre et le statut ne sont pas remplies, la couleur de fond s'arrête après le texte, pourquoi ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez la
sortie de `echo $TERM` dans votre terminal).
Selon la façon de lancer WeeChat, vous devriez avoir :
* si WeeChat tourne en local ou sur une machine distante sans screen :
cela dépend du terminal utilisé : 'xterm', 'rxvt', etc...
* si WeeChat tourne sous screen, vous devriez avoir 'screen'.
Si besoin, corrigez la variable TERM : `export TERM="xxx"`.
[[screen_weird_chars]]
Quand j'utilise weechat sous screen, j'ai des caractères bizarres et aléatoires, comment corriger ça ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez la
sortie de `echo $TERM` dans votre terminal).
Par exemple 'xterm-color' provoque ce genre de problèmes, utilisez
'xterm' qui est ok (comme plein d'autres valeurs).
Si besoin, corrigez la variable TERM : `export TERM="xxx"`.
[[key_bindings]]
Comment puis-je configurer les raccourcis clavier ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Les raccourcis clavier sont modifiables avec la commande /key.
La touche par défaut Meta-k (souvent Alt-k) permet de capturer le code d'une
touche et de l'inclure dans la ligne de commande.
[[openbsd_plugins]]
J'utilise OpenBSD et WeeChat ne charge aucune extension, pourquoi ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Sous OpenBSD, le nom des extensions se termine par ".so.0.0" (".so" sous
Linux).
Vous devez configurer ça :
* avec WeeChat < = 0.2.6 : `/set plugins_extension = ".so.0.0"`
* avec WeeChat > = 0.3.x : `/set weechat.plugin.extension ".so.0.0"`
Puis: `/plugin autoload`.
[[scripts]]
Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ? Les scripts sont-ils compatibles avec d'autres clients IRC ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Les commandes `/perl`, `/python`, `/ruby`, `/lua` et `/tcl` permettent de
charger les scripts (le chemin par défaut est '~/.weechat/<langage>/').
Les scripts ne sont pas compatibles avec d'autres clients IRC.
Notes :
* les scripts dans '~/.weechat/<langage>/autoload/' sont automatiquement chargés
par WeeChat lorsqu'il démarre.
* l'extension 'tcl' est disponible à partir de la version 0.3.x.
[[change_locale_without_quit]]
Je souhaite changer la langue des messages affichés par WeeChat, mais sans quitter WeeChat, est-ce possible ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Oui, il faut utiliser le script python shell.py (disponible sur le site de
WeeChat) et taper ces commandes une fois le script chargé :
/shell setenv LANG=fr_FR.UTF-8
/upgrade
Pour avoir des messages anglais avec encodage UTF-8 pour le terminal, pour les
utilisateurs en ISO, vous pouvez taper : `/shell setenv LANG=fr_FR`.
[[terminal_copy_paste]]
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.3.x : `/bar set nicklist position top`
[[highlight_notification]]
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.3.x :
`/set plugins.var.perl.sound.cmd_highlight "/chemin/commande parametres"`
De nombreux autres scripts de notification existent, merci de consulter la
liste des extensions/scripts :
http://weechat.flashtux.org/plugins.php
[[filter_irc_join_part_quit]]
Comment puis-je filter les messages join/part/quit sur les canaux IRC ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Selon la version de WeeChat :
* avec WeeChat < = 0.2.6 : +
`/ignore * join #weechat freenode` +
`/ignore * part #weechat freenode` +
`/ignore * quit #weechat freenode` +
(le canal et/ou le serveur peuvent être "*", `/help ignore` pour l'aide)
* avec WeeChat > = 0.3.x :
** filtre 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)
[[ignore_vs_filter]]
Quelle est la différence entre les commandes /ignore et /filter ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
La commande `/ignore` est une commande IRC, donc elle s'applique uniquement aux
tampons IRC (serveurs et canaux).
Elle permet d'ignorer des pseudos ou nom d'hôtes pour un serveur ou un canal
(la commande ne s'applique pas au contenu des messages).
Les messages corespondants sont supprimés par l'extension IRC avant affichage
(donc vous ne les verrez jamais).
La commande `/filter` est une commande "core", donc elle s'applique à n"importe
quel tampon.
Elle permet de filtrer des lignes dans les tampons à l'aide de tags ou
d'expression régulière pour le préfixe et contenu de la ligne.
Les lignes filtrées sont simplement cachées, pas supprimées, et il est possible
de les voir en désactivant les filtres (par défaut, la touche alt + "="
active/désactive les filtres).
Développement
-------------
[[bug_task_patch]]
Comment puis-je reporter un bug, demander une nouvelle fonctionnalité ou envoyer un patch ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Il y a 3 possibilités :
. vous pouvez nous joindre sur IRC : 'irc.freenode.net', canal '#weechat'
. vous pouvez utiliser le site savannah :
* reporter un bug: https://savannah.nongnu.org/bugs/?group=weechat
* demander une nouvelle fonctionnalité: https://savannah.nongnu.org/task/?group=weechat
* envoyer un patch: https://savannah.nongnu.org/patch/?group=weechat
. vous pouvez envoyer un mail aux développeurs, consultez la page support
pour les mails des développeurs :
http://weechat.flashtux.org/support.php
(vous pouvez souscrire et envoyer à la liste de diffusion nommée "support")
[[supported_os]]
Quelle est la liste des plate-formes supportées par WeeChat ? Sera-t-il porté sur d'autres systèmes d'exploitation ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
La liste complète est sur cette page :
http://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.
[[help_developers]]
Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Il y a plusieurs choses à faire (test, code, documentation, etc...)
Merci de prendre contact avec nous par IRC ou mail, consultez la page
support :
http://weechat.flashtux.org/support.php
[[donate]]
Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Vous pouvez donner de l'argent pour aider le développement.
Plus de détails sur http://weechat.flashtux.org/donate.php

311
doc/fr/weechat_quickstart.fr.txt
View File

@ -1,220 +1,245 @@
Guide de démarrage rapide WeeChat (version française, pour WeeChat >= 0.3.x)
============================================================================
Guide de démarrage rapide WeeChat
=================================
FlashCode <flashcode@flashtux.org>
v0.3.0-dev, 2009-05-15
1. Démarrer weechat
Un émulateur de terminal recommandé pour X (mais pas obligatoire) est
rxvt-unicode (il a un bon support UTF-8, et aucun problème avec les
touches par défaut).
[[start]]
Démarrer weechat
----------------
Lancer "weechat-curses" depuis votre shell.
Un émulateur de terminal recommandé pour X (mais pas obligatoire) est
rxvt-unicode (il a un bon support UTF-8, et aucun problème avec les
touches par défaut).
2. Aide en ligne / options
Lancer "weechat-curses" depuis votre shell.
WeeChat dispose d'aide pour toutes les commandes, tapez simplement /help
Pour avoir de l'aide sur une commande, tapez /help commande
Pour modifier des options, utilisez /set config.section.option valeur
(où "config" est le nom de la configuration ("weechat" pour le coeur, ou
un nom d'extension), "section" la section de cette configuration et
"option" le nom de l'option).
[[help_options]]
Aide en ligne / options
-----------------------
WeeChat utilise immédiatement la nouvelle valeur (vous n'avez *jamais*
besoin de redémarrer WeeChat après avoir changé la configuration).
WeeChat dispose d'aide pour toutes les commandes, tapez simplement /help
Pour avoir de l'aide sur une commande, tapez `/help commande`
Vous pouvez utiliser /set avec un nom partiel d'option et le caractère
joker "*" au début ou à la fin pour afficher toutes les options contenant
ces lettres.
Par exemple :
Pour modifier des options, utilisez `/set config.section.option valeur`
(où `config` est le nom de la configuration (`weechat` pour le coeur, ou
un nom d'extension), `section` la section de cette configuration et
`option` le nom de l'option).
/set => affiche toutes les options (WeeChat et extensions)
/set weechat.* => affiche les options WeeChat
/set irc.* => affiche les options de l'extension IRC
WeeChat utilise immédiatement la nouvelle valeur (vous n'avez *jamais*
besoin de redémarrer WeeChat après avoir changé la configuration).
Vous pouvez afficher de l'aide sur une option avec /help, par exemple :
/help weechat.look.highlight
Vous pouvez utiliser `/set` avec un nom partiel d'option et le caractère
joker "*" au début ou à la fin pour afficher toutes les options contenant
ces lettres.
Par exemple :
Toutes les options sont sauvées quand WeeChat quitte (ou avec la commande
"/save" pour forcer une écriture des options).
`/set`::
affiche toutes les options (WeeChat et extensions)
Vous pouvez éditer les fichiers de configuration (*.conf) à la main et les
recharger par la commande /reload si vous ne souhaitez pas utiliser la
commande /set.
`/set weechat.*`::
affiche les options WeeChat
3. Coeur vs extensions
`/set irc.*`::
affiche les options de l'extension IRC
Le coeur de WeeChat ("core") ne fait qu'afficher les données à l'écran et
interagir avec l'utilisateur, cela signifie que le coeur sans extension
n'a pas grand intérêt (utilisateurs fidèles: IRC faisait partie du coeur
dans les versions <= 0.2.6).
Vous pouvez afficher de l'aide sur une option avec `/help`, par exemple :
`/help weechat.look.highlight`.
Tous les protocoles réseau comme IRC sont fournis sous forme d'extensions.
Toutes les options sont sauvées quand WeeChat quitte (ou avec la commande
`/save` pour forcer une écriture des options).
Utilisez la commande /plugin pour voir les extensions chargées, vous
devriez voir "irc" et d'autres extensions dans cette liste.
Vous pouvez éditer les fichiers de configuration (*.conf) à la main et les
recharger par la commande `/reload` si vous ne souhaitez pas utiliser la
commande `/set`.
4. Créer un serveur IRC
Vous pouvez ajouter un serveur IRC par la commande /server, par exemple :
[[core_vs_plugins]]
Coeur vs extensions
-------------------
/server add oftc irc.oftc.org 6667
Le coeur de WeeChat ("core") ne fait qu'afficher les données à l'écran et
interagir avec l'utilisateur, cela signifie que le coeur sans extension
n'a pas grand intérêt (utilisateurs fidèles: IRC faisait partie du coeur
dans les versions < = 0.2.6).
Comme d'habitude, de l'aide est disponible si vous êtes perdus :
Tous les protocoles réseau comme IRC sont fournis sous forme d'extensions.
/help server
Utilisez la commande `/plugin` pour voir les extensions chargées, vous
devriez voir "irc" et d'autres extensions dans cette liste.
5. Définir les options du serveur IRC
WeeChat utilise des valeurs par défaut pour tous les serveurs, si vous ne
spécifiez pas de valeur spécifique pour une option de serveur.
Ces options par défaut sont "irc.server_default.*".
[[create_irc_server]]
Créer un serveur IRC
--------------------
Pour chaque option d'un serveur, WeeChat utilise sa valeur si elle est
définie (non "null"). Sinon WeeChat utilise la valeur par défaut
(irc.server_default.xxx).
Vous pouvez ajouter un serveur IRC par la commande `/server`, par exemple :
Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et
vous pouvez les écraser pour le serveur oftc avec la commande suivante :
/server add oftc irc.oftc.org 6667
/set irc.server.oftc.nicks "pseudo1,pseudo2,pseudo3,pseudo4,pseudo5"
Comme d'habitude, de l'aide est disponible si vous êtes perdus :
`/help server`
Pour modifier le nom d'utilisateur et nom réel :
/set irc.server.oftc.username "Mon nom d'utilisateur"
/set irc.server.oftc.realname "Mon nom réel"
[[irc_server_options]]
Définir les options du serveur IRC
----------------------------------
Pour activer la connexion automatique au serveur lors du démarrage :
WeeChat utilise des valeurs par défaut pour tous les serveurs, si vous ne
spécifiez pas de valeur spécifique pour une option de serveur.
Ces options par défaut sont "irc.server_default.*".
/set irc.server.oftc.autoconnect on
Pour chaque option d'un serveur, WeeChat utilise sa valeur si elle est
définie (non "null"). Sinon WeeChat utilise la valeur par défaut
("irc.server_default.xxx").
Pour lancer une commande après connexion au serveur, par exemple pour
s'identifier auprès de nickserv :
Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et
vous pouvez les écraser pour le serveur oftc avec la commande suivante :
/set irc.server.oftc.command "/msg nickserv identify xxxxxx"
/set irc.server.oftc.nicks "pseudo1,pseudo2,pseudo3,pseudo4,pseudo5"
NB: plusieurs commandes peuvent être séparées par ';' (point-virgule)
Pour modifier le nom d'utilisateur et nom réel :
Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
/set irc.server.oftc.username "Mon nom d'utilisateur"
/set irc.server.oftc.realname "Mon nom réel"
/set irc.server.oftc.autojoin "#canal1,#canal2"
Pour activer la connexion automatique au serveur lors du démarrage :
Pour supprimer la valeur d'une option du serveur et utiliser sa valeur par
défaut à la place, par exemple pour utiliser les pseudos par défaut
(irc.server_default.nicks) :
/set irc.server.oftc.autoconnect on
/set irc.server.oftc.nicks null
Pour lancer une commande après connexion au serveur, par exemple pour
s'identifier auprès de nickserv :
Autres options :
Vous pouvez modifier les autres options avec la commande suivante ("xxx"
est le nom d'une option) :
/set irc.server.oftc.command "/msg nickserv identify xxxxxx"
/set irc.server.oftc.xxx valeur
NB: plusieurs commandes peuvent être séparées par ';' (point-virgule)
6. Se connecter au serveur IRC et rejoindre les canaux
Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
/connect oftc
/set irc.server.oftc.autojoin "#canal1,#canal2"
Note : cette commande peut aussi être utilisée pour créer et se connecter
au serveur sans utiliser la commande /server (devrais-je répéter que vous
pouvez voir l'aide pour cette commande avec /help connect ? ;)
Pour supprimer la valeur d'une option du serveur et utiliser sa valeur par
défaut à la place, par exemple pour utiliser les pseudos par défaut
(irc.server_default.nicks) :
7. Joindre/quitter les canaux IRC
/set irc.server.oftc.nicks null
Joindre un canal :
Autres options : vous pouvez modifier les autres options avec la commande
suivante ("xxx" est le nom d'une option) :
/join #channel
/set irc.server.oftc.xxx valeur
Quitter un canal :
/part [message de fin]
[[connect_to_irc_server]]
Se connecter au serveur IRC et rejoindre les canaux
---------------------------------------------------
Quitter un canal et fermer le tampon :
/connect oftc
/close [message de fin]
Note : cette commande peut aussi être utilisée pour créer et se connecter
au serveur sans utiliser la commande `/server` (devrais-je répéter que vous
pouvez voir l'aide pour cette commande avec `/help connect` ? ;)
(/close est un alias sur /buffer close)
8. Gérer les tampons/fenêtres
[[join_part_irc_channels]]
Joindre/quitter les canaux IRC
------------------------------
Un tampon ("buffer") est un composant lié à une extension, avec une
catégorie et un nom. Le tampon contient les données affichées à l'écran.
`/join #channel`:
joindre un canal
Une fenêtre ("window") est une vue sur un tampon. Par défaut il n'y a
qu'une fenêtre affichant un tampon. Si vous divisez l'écran, vous verrez
alors plusieurs fenêtres avec plusieurs tampons en même temps.
`/part [message de fin]`::
quitter un canal (en laissant le tampon ouvert)
Commandes pour gérer les tampons et les fenêtres :
`/close [message de fin]`::
quitter un canal et fermer le tampon (`/close` est un alias sur
`/buffer close`)
/buffer
/window
(je ne répéterai pas que vous pouvez avoir de l'aide sur ces commandes
avec /help)
[[buffer_window]]
Gérer les tampons/fenêtres
--------------------------
Par exemple, pour découper verticalement l'écran en une petite fenêtre
(1/3 de la largeur) et une large (2/3), utilisez la commande :
Un tampon ("buffer") est un composant lié à une extension, avec une
catégorie et un nom. Le tampon contient les données affichées à l'écran.
/window splitv 33
Une fenêtre ("window") est une vue sur un tampon. Par défaut il n'y a
qu'une fenêtre affichant un tampon. Si vous divisez l'écran, vous verrez
alors plusieurs fenêtres avec plusieurs tampons en même temps.
9. Raccourcis clavier
Commandes pour gérer les tampons et les fenêtres :
WeeChat utilise un certain nombre de touches par défaut. Toutes ces
touches sont dans la documentation, mais vous devriez connaître au moins
les touches vitales :
- alt + flèches gauche/droite (ou F5/F6): aller au tampon précédent/suivant
- F7/F8: aller à la fenêtre précédente/suivante (quand l'écran est divisé)
- F9/F10: faire défiler la barre de titre
- F11/F12: faire défiler la liste des pseudos
- tab: compléter le texte de la barre d'entrée, comme avec votre shell
- page préc/suiv: faire défiler le texte dans le tampon courant
- alt + A: sauter au tampon avec de l'activité (dans la "hotlist")
/buffer
/window
(je ne répéterai pas que vous pouvez avoir de l'aide sur ces commandes
avec /help)
Par exemple, pour découper verticalement l'écran en une petite fenêtre
(1/3 de la largeur) et une large (2/3), utilisez la commande :
/window splitv 33
[[key_bindings]]
Raccourcis clavier
------------------
WeeChat utilise un certain nombre de touches par défaut. Toutes ces
touches sont dans la documentation, mais vous devriez connaître au moins
les touches vitales :
- 'alt + flèches gauche/droite' (ou 'F5'/'F6'): aller au tampon précédent/suivant
- 'F7'/'F8': aller à la fenêtre précédente/suivante (quand l'écran est divisé)
- 'F9'/'F10': faire défiler la barre de titre
- 'F11'/'F12': faire défiler la liste des pseudos
- 'tab': compléter le texte de la barre d'entrée, comme avec votre shell
- 'page préc/suiv': faire défiler le texte dans le tampon courant
- 'alt + A': sauter au tampon avec de l'activité (dans la "hotlist")
Selon votre clavier et/ou vos besoins, vous pouvez associer n'importe
quelle touche à une commande avec la commande "/key".
Une touche utile est meta-k (alt-k) pour trouver le code des touches.
Selon votre clavier et/ou vos besoins, vous pouvez associer n'importe
quelle touche à une commande avec la commande `/key`.
Une touche utile est meta-k (alt-k) pour trouver le code des touches.
Par exemple, pour associer meta-y (alt-y) à la commande "/buffer close" :
Par exemple, pour associer meta-y (alt-y) à la commande `/buffer close` :
/key (pressez meta-k) (pressez meta-y) /buffer close
/key bind (pressez meta-k) (pressez meta-y) /buffer close
Vous aurez une ligne de commande qui ressemble à ceci :
Vous aurez une ligne de commande qui ressemble à ceci :
/key meta-y /buffer close
/key bind meta-y /buffer close
Pour enlever la touche :
Pour enlever la touche :
/key unbind meta-y
/key unbind meta-y
10. Extensions/scripts
Sur certaines distributions comme Debian, les extensions sont disponibles
via un paquet séparé (par exemple weechat-plugins).
Les extensions sont automatiquement chargées lorsqu'elles sont trouvées.
[[plugins_scripts]]
Extensions/scripts
------------------
Des extensions permettent d'utiliser des scripts dans WeeChat (dans
différent langages comme Perl, Python, Ruby, Lua et Tcl). Ces extensions
doivent être chargées avec la commande /plugin et elles fournissent des
commandes telles que /perl, utilisées pour charger les scripts.
Sur certaines distributions comme Debian, les extensions sont disponibles
via un paquet séparé (par exemple weechat-plugins).
Les extensions sont automatiquement chargées lorsqu'elles sont trouvées.
Plusieurs extensions/scripts (de contributeurs) sont disponibles pour
WeeChat, voir ici :
Des extensions permettent d'utiliser des scripts dans WeeChat (dans
différent langages comme Perl, Python, Ruby, Lua et Tcl). Ces extensions
doivent être chargées avec la commande `/plugin` et elles fournissent des
commandes telles que `/perl`, utilisées pour charger les scripts.
http://weechat.flashtux.org/plugins.php
Plusieurs extensions/scripts (de contributeurs) sont disponibles pour
WeeChat : http://weechat.flashtux.org/plugins.php
Merci de regarder la documentation WeeChat pour charger/décharger des
extensions ou des scripts.
Merci de regarder la documentation WeeChat pour charger/décharger des
extensions ou des scripts.
11. Plus de documentation
Vous pouvez maintenant utiliser WeeChat et lire la FAQ/documentation pour
toute autre question :
[[more_doc]]
Plus de documentation
---------------------
http://weechat.flashtux.org/faq.php
http://weechat.flashtux.org/doc.php
Vous pouvez maintenant utiliser WeeChat et lire la FAQ/documentation pour
toute autre question : http://weechat.flashtux.org/doc.php
Bon WeeChat !
--
(c) 2006-2009, écrit par FlashCode <flashcode@flashtux.org>
Dernière édition le 11/05/2009.
Ce document fait partie de WeeChat et est distribué sous license GPL 3.
Bon WeeChat !

147
doc/fr/weechat_tester.fr.txt Normal file
View File

@ -0,0 +1,147 @@
Guide du testeur WeeChat
========================
FlashCode <flashcode@flashtux.org>
v0.3.0-dev, 2009-05-15
[[purpose]]
Objet
-----
Beaucoup d'utilisateurs nous demandent comment aider WeeChat. La façon
la plus facile (et aussi la plus rusée) consiste à le tester !
Le test est une partie très importante du développement de logiciel et
ne devrait pas être sous-estimé. Lorsque de nouvelles fonctionnalités
sont implémentées, elles doivent être testées, mais pour certaines
fonctionnalités il y a trop de cas à tester et les développeurs ne
peuvent pas tout tester.
Par exemple : l'extension charset introduite dans WeeChat WeeChat 0.2.2 : aucun
de nous (développeurs, contributeurs et testeurs) n'utilisait de canaux avec
des caractères spéciaux dans leurs noms et quand la version 0.2.2 a été rendue
disponible, nous avons reçu de nombreuses remontées d'utilisateurs russes.
Si nous avons plus de testeurs, cela ne devrait pas arriver à nouveau dans le
futur.
Tester les versions stables de WeeChat est inutile car les
développeurs sont constamment occupés à implémenter de nouvelles
fonctionnalités (et à corriger des anciens bugs).
[[prepare_system]]
Préparez votre système
----------------------
Cela nous aiderait beaucoup si vous activiez les fichiers 'core' Linux : si
WeeChat se plante, Linux écrit un fichier 'core'. Ce fichier contient des
informations importantes pour le debug, pour savoir exactement où le problème
se situe dans WeeChat).
Si vous utilisez le shell 'bash', ajoutez cette ligne dans votre `~/.bashrc` :
ulimit -c unlimited
[[download]]
Téléchargement de la version devel
----------------------------------
Le code tout frais (avec les derniers bugs et fonctionnalités) est stocké dans
GIT.
Vous pouvez décider de le construire manuellement (méthode recommandée) :
* la version GIT peut être construite et installée en parallèle de la version
stable,
* vous n'avez pas besoin d'accès root ni de sacrifier votre version stable de
WeeChat.
[[get_sources]]
Obtenir et compiler les sources
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Créez tout d'abord un répertoire, par exemple 'weechat-git' :
---------------------
$ mkdir ~/weechat-git
$ cd ~/weechat-git
---------------------
Si vous avez git installé, vous pouvez cloner la base GIT (recommandé) :
--------------------------------------------
$ git clone git://git.sv.gnu.org/weechat.git
$ cd weechat
--------------------------------------------
NOTE: Plus tard, vous pourrez utiliser la command "`git pull`" dans ce répertoire
pour obtenir juste les deltas avec la version d'aujourd'hui.
Sinon vous pouvez installer le paquet 'devel' :
-----------------------------------------------------------------
$ wget http://weechat.flashtux.org/download/weechat-devel.tar.bz2
$ tar xvjf weechat-devel.tar.bz2
$ cd weechat-devel
-----------------------------------------------------------------
Pour compiler les sources, cmake est recommandé :
--------------------------------------------------------------
$ mkdir build
$ cd build
$ cmake .. -DPREFIX=$HOME/weechat-git -DCMAKE_BUILD_TYPE=Debug
$ make
$ make install
--------------------------------------------------------------
Si vous n'avez pas cmake, il est toujours possible d'utiliser les autools :
-----------------------------------------------------------------
$ ./autogen.sh # (seulement si vous avez cloné la base git)
$ ./configure --prefix=$HOME/weechat-git
$ make
$ make install
-----------------------------------------------------------------
[[install_binary_pcakcge]]
Obtenir un paquet binaire
~~~~~~~~~~~~~~~~~~~~~~~~~
Selon votre distribution Linux :
* Debian: http://debian.flashtux.org/
* Gentoo: http://weechat.flashtux.org/download.php
* ArchLinux: PKGBUILD depuis http://aur.archlinux.org/
* autre: nous ne savons pas ! Eheh.
[[run]]
Lancer WeeChat
--------------
Il est conseillé de lancer WeeChat avec un répertoire différent de la version
stable, avec l'option `--dir`.
La commande est :
~/weechat-git/bin/weechat-curses --dir ~/.weechat-dev
Si vous êtes encore éveillé, vous devriez voir une interface familière et
pouvoir vous vanter d'utiliser la version la plus récente possible de WeeChat ;)
Maintenant si vous obtenez un comportement étrange ou un plantage, n'hésitez
pas à nous en avertir sur `#weechat`, serveur `irc.freenode.net`.
S'il n'y a pas de plantage, dites-le nous aussi, nous avons besoin de votre
retour et de vos impressions !
[[links]]
Liens intéressants
------------------
* Base GIT : http://git.savannah.gnu.org/gitweb/?p=weechat.git
* Bug tracker : https://savannah.nongnu.org/bugs/?group=weechat
* Flux RSS des commits WeeChat : http://git.savannah.gnu.org/gitweb/?p=weechat.git;a=rss

27
doc/pl/Makefile.am
View File

@ -1,27 +0,0 @@
# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
LANGCODE = pl
QUICKSTART = weechat_quickstart.$(LANGCODE).txt
EXTRA_DIST = $(QUICKSTART)
docdir = $(datadir)/doc/$(PACKAGE)
# install docs
install-data-hook:
$(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/

111
doc/pl/weechat_quickstart.pl.txt
View File

@ -1,111 +0,0 @@
Weechat szybki start (wersja polska, WeeChat <= 0.2.6)
1. Włączenie
Aby wybrać konkretny interfejs należy wpisać:
- weechat-curses dla interfejsu curses
- weechat-gtk dla interfejsu GTK (w fazie tworzenia)
- weechat-qt dla interfejsu QT (planowany)
- weechat-wxwidgets dla interfejsu WxWidgets (planowany)
2. Pomoc online / opcje
Weechat posiada polecenie pomocy, którego można użyć dla każdej dostępnej opcji, wystarczy wpisać /help
Aby otrzymać pomoc odnośnie komendy, wpisz /help <komenda>
Aby konfigurować opcje należy wpisać /set <opcja> = <wartość>
Możesz wpisać /set <opcja> z nie pełną nazwą opcji (pokaże to opcje zawierające wpisany ciąg znaków),
lub z całą nazwą opcji bez wartości (pokaże sie wtedy cała pomoc odnośnie opcji).
Uwaga: ustawienia są zapamiętywane podczas wyłączania WeeChata (albo po wpisaniu /save )
NIE EDYTUJ pliku konfiguracyjnego WeeChata podczas pracy programu, ponieważ WeeChat może nadpisać
ten plik w każdej chwili i nie będzie możliwości odzyskania ustawień.
Aby zmienić każde z ustawień, używaj komendy "/set", WeeChat po jej użyciu od razu zacznie korzystać z nowych
parametrów.
3. Dodawanie serwerów
Dla przykładu irc.quakenet.org, port 6667:
/server add quakenet irc.quakenet.org 6667
(wpisz /help server dla pełnej pomocy)
4. Ustawianie własnych ustawień dotyczących serwera
Niki:
/set quakenet.server_nick1 = "mój-nick"
/set quakenet.server_nick2 = "mój-nick2"
/set quakenet.server_nick3 = "mój-nick3"
Imię użytkownika:
/set quakenet.server_username = "My username"
/set quakenet.server_realname = "My real name"
Automatyczne łączenie do serwera przy starcie WeeChata:
/set quakenet.server_autoconnect = on
Automatyczne wchodzenie na wybrane kanały po połączeniu sie do serwera:
/set quakenet.server_autojoin = "#kanał1,#kanał2"
Inne opcje:
Możesz zobaczyć inne opcje i ich właściwości po wpisaniu /set quakenet
Aby ustawić konkretną opcję wpisz /set quakenet.server_opcja = wartość
5. Łączenie do serwera i automatyczne wchodzenie na wybrane kanały:
/connect quakenet
6. Wchodzenie/wychodzenie na/z kanały/-ów
Wchodzenie na kanał:
/join #kanał
Wychodzenie z kanału:
/part {wiadomość przy wychodzeniu}
Wyjście z kanału i zamknięcie zakładki:
/close {wiadomość przy wychodzeniu}
("/close" to alias od "/bufer close")
7. Zarządzanie bufory/okna
Możesz zarządzać buforami przy pomocy polecenia "/buffer" i oknami "/windows"
Przykład:
-aby rozdzielić ekran w pionie na małe okno (1/3 szerokości),
i na duże (2/3), wpisz:
/window splthv 33
8. Przypisywanie funkcji do klawiszy:
W celu łatwiejszej pracy można przypisać dowolnym klawiszom wybrane funkcje/polecenia
przy pomocy komendy "/key"
Użyteczną może być funkcja meta-k (alt+k) która pozwala znaleźć przypisane klawiszom kody.
Przykład: aby zbindować (przypisać) meta-y (alt-y) do polecenia "/buffer close":
/key (naciśnij meta-k) (naciśnij meta-y) /buffer close
Otrzymujesz:
/key meta-y /buffer close
9. Wtyczki/skrypty
Na niektórych systemach operacyjnych, takich jak Debian, wtyczki są dostępne jako oddzielne paczki
(np. weechat-plugins)
Wtyczki są automatycznie ładowane przy starcie.
Dodatkowe skrypty i wtyczki do WeeChata dostępne są na:
http://weechat.flashtux.org/plugins.php
Zajrzyj do dokumentacji WeeChata, aby dowiedzieć sie jak ladować i wyładować wtyczki i skrypty:
http://weechat.flashtux.org/doc.php
10. Dokumentacja szczegółowa
Wiesz juz jak w podstawowy sposób używać WeeChata, aby dowiedzieć sie więcej poczytaj dokumentację.
http://weechat.flashtux.org/faq.php
http://weechat.flashtux.org/doc.php
Miłej pracy z WeeChatem!
--
(c) 2006-05-31, written by FlashCode <flashcode@flashtux.org>
Translated by dzik (znajdziecie mnie na irc.freenode.net)
This document is part of WeeChat and is distributed under GPL licence.

27
doc/ru/Makefile.am
View File

@ -1,27 +0,0 @@
# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
LANGCODE = ru
QUICKSTART = weechat_quickstart.$(LANGCODE).txt
EXTRA_DIST = $(QUICKSTART)
docdir = $(datadir)/doc/$(PACKAGE)
# install docs
install-data-hook:
$(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/

110
doc/ru/weechat_quickstart.ru.txt
View File

@ -1,110 +0,0 @@
Краткое руководство пользователя (русская версия) (WeeChat <= 0.2.6)
====================================================================
1. Запуск WeeChat
В зависимости от выбранного интерфейса вы должны запустить:
- weechat-curses для Curses интерфейса
- weechat-gtk для GTK интерфейса (в разработке)
- weechat-qt для Qt интерфейса (не разрабатывается)
- weechat-wxwidgets для WxWidgets интерфейса (не разрабатывается)
2. Справка / настройки
WeeChat содержит справку по всем командам, просто запустите /help
Для получения справки по команде наберите /help команда
Для настройки используйте /set параметр = значение
Вы можете использовать /set с частичным названием параметра
(выведет все параметры с указанной фразой) или с полным названием
(для получения подробной справки по параметру)
Внимание: настройки сохраняются при выходе из WeeChat (или командой
"/save"). НЕ РЕДАКТИРУЙТЕ файл конфигурации когда WeeChat запущен,
т.к. WeeChat может в любой момент перезаписать его. Возможности
перезагрузить файл конфигурации нет. Для изменения любых настроек
воспользуйтесь командой "/set", изменения вступят в силу
незамедлительно.
3. Создание сервера
Например, irc.quakenet.org, порт 6667:
/server add quakenet irc.quakenet.org 6667
(/help server выведет подробную справку)
4. Настройка сервера
Ники:
/set quakenet.server_nick1 = "mynick"
/set quakenet.server_nick2 = "mynick2"
/set quakenet.server_nick3 = "mynick3"
Имя пользователя / реальное имя:
/set quakenet.server_username = "Имя пользователя"
/set quakenet.server_realname = "Реальное имя"
Автоматическое подключение к серверу:
/set quakenet.server_autoconnect = on
Автоматический заход на некоторые каналы:
/set quakenet.server_autojoin = "#chan1,#chan2"
Другие настройки:
Чтобы вывести все настройки сервера наберите /set quakenet
Для настройки наберите /set quakenet.параметр_сервера = значение
5. Подключение к серверу и автоматический заход на каналы:
/connect quakenet
6. Заход/покидание каналов
Зайти на канал:
/join #канал
Покинуть канал:
/part [прощальное сообщение]
Покинуть канал и закрыть буфер:
/close [прощальное сообщение]
(/close - это сокращение для /buffer close)
7. Управление буферами/окнами
Вы можете управлять буферами командой "/buffer" и окнами
командой "/window".
Например, чтобы разбить экран по вертикали на маленькое (треть
экрана) и большое (2/3 экрана) окна наберите:
/window splitv 33
8. Привязки клавиш
Вы можете переназначить любую клавишу в соответствии с вашими
пожеланиями командой "/key".
Полезна привязка meta-k (alt-k) для поиска нужных кодов клавиш.
Например, чтобы привязать meta-y (alt-y) к команде "/buffer close":
/key (нажмите meta-k) (нажмите meta-y) /buffer close
Вы получите команду:
/key meta-y /buffer close
9. Plugins/скрипты
В некоторых дистрибутивах pluginы доступны отдельным пакетом
(например, weechat-plugins).
Pluginы загружаются автоматически.
Для WeeChat доступны многочисленные pluginы и скрипты:
http://weechat.flashtux.org/plugins.php
Процесс загрузки и выгрузки pluginов и скриптов подробно описан в
документации.
10. Другая документация
Теперь вы можете пользоваться WeeChat и почитать ЧаВо и документацию
для поиска ответов на оставшиеся вопросы:
http://weechat.flashtux.org/faq.php
http://weechat.flashtux.org/doc.php
Наслаждайтесь WeeChat!
--
(c) 2006-05-31, автор - FlashCode <flashcode@flashtux.org>
(с) 2006-06-04, переводчик - Stalwart <stlwrt@gmail.com>
Этот документ является частью WeeChat и распространяется по лицензии GPL.

27
doc/sco/Makefile.am
View File

@ -1,27 +0,0 @@
# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
LANGCODE = sco
QUICKSTART = weechat_quickstart.$(LANGCODE).txt
EXTRA_DIST = $(QUICKSTART)
docdir = $(datadir)/doc/$(PACKAGE)
# install docs
install-data-hook:
$(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/

108
doc/sco/weechat_quickstart.sco.txt
View File

@ -1,108 +0,0 @@
WeeChat quik stairt guide (Scots version, WeeChat <= 0.2.6)
===========================================================
1. Launch weechat
Accordin tae choosed GUI, ye hav tae launch:
- weechat-curses fer Curses GUI
- weechat-gtk fer Gtk GUI (under development)
- weechat-qt fer Qt GUI (no developed)
- weechat-wxwidgets fer WxWidgets GUI (no developed yit)
2. Online help / options
WeeChat hus help fer awl commands, jus issu /help
Tae get help on a command, issu /help command
Tae set options, use eh /set option = value
Ye can use /set option wi partial name (displ't awl options
contain leters), or wi ownly a full option nam wi'oot value
(tae see long help fer option).
Pure Important: settings are saved when WeeChat ends (or wi eh "/save"
command). Gonnae NO(!) edit eh setup file whyle WeeChat is running, cause WeeChat
may write eh file at 'ne time, and its nae possible tae reload it.
Tae chainge any settins, use "/set" command, WeeChat immediately uses new
settings.
3. Create a server
Fer example irc.quakenet.org, port 6667:
/server add quakenet irc.quakenet.org 6667
(/help server fer ful command help)
4. Set custom server options
Nicks:
/set quakenet.server_nick1 = "manick"
/set quakenet.server_nick2 = "manick2"
/set quakenet.server_nick3 = "manick3"
Username/realname:
/set quakenet.server_username = "Ma username"
/set quakenet.server_realname = "Ma real name"
Auto-connect tae server:
/set quakenet.server_autoconnect = on
Auto-join fer sum channels:
/set quakenet.server_autojoin = "#chan1,#chan2"
Other options:
Ye can see servers options and values wi /set quakenet
Tae set an option, use eh /set quakenet.server_option = value
5. Connect tae server n auto-join channels:
/connect quakenet
6. Join/part channels
Join a channel:
/join #channel
Part a channel:
/part [quit message]
Part a channel n close buffer:
/close [quit message]
(/close is an alias on /buffer close)
7. Buffer/window management
Ye can manage buffers wi "/buffer" command and windows
with "/window" command.
Fer example, tae split verticaly screen intae a wee windea (1/3 width),
n a big yin (2/3), use command:
/window splitv 33
8. Key bindings
According tae yer keyboard and/or ya needs, ye can rebind 'ne key
wi "/key" command.
A useful key is meta-k (alt-k) tae find key codes.
Fer example, tae bind meta-y (alt-y) tae command "/buffer close":
/key (press meta-k) (press meta-y) /buffer close
Ye wull huv a command line like:
/key meta-y /buffer close
9. Plugins/scripts
On som distros lyke Debian, plugins are available via a separate package
(like weechat-plugins).
Plugins are automatically loadet when found.
Many plugins/scripts are available fer WeeChat, please luk at:
http://weechat.flashtux.org/plugins.php
Please luk at WeeChat documentation tae load/unload plugins or scripts.
10. Mer documentation
Yae can noo use WeeChat and read FAQ/documentation fer any oths questins:
http://weechat.flashtux.org/faq.php
http://weechat.flashtux.org/doc.php
Enjoy WeeChat!
--
(c) 2006-05-31, written by FlashCode <flashcode@flashtux.org>, Translate't by AndrewB <andrewb@tuxhacker.org>
This document is part of WeeChat and is distributed under GPL licence.

27
doc/sv/Makefile.am
View File

@ -1,27 +0,0 @@
# Copyright (c) 2003-2009 FlashCode <flashcode@flashtux.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
LANGCODE = sv
QUICKSTART = weechat_quickstart.$(LANGCODE).txt
EXTRA_DIST = $(QUICKSTART)
docdir = $(datadir)/doc/$(PACKAGE)
# install docs
install-data-hook:
$(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/

110
doc/sv/weechat_quickstart.sv.txt
View File

@ -1,110 +0,0 @@
Weechat snabbstart guide (svensk version, WeeChat <= 0.2.6)
===========================================================
1. Starta weechat
Beroende på GUI, måste du starta:
- weechat-curses för Curses GUI
- weechat-gtk för Gtk GUI (under utveckling)
- weechat-qt för Qt GUI (inte utvecklad)
- weechat-wxwidgets för WxWidgets GUI (inte utvecklad)
2. Online hjälp / inställningar
WeeChat har hjälp information för alla kommandon, skriv /help
För att få hjälp med ett kommando, skriv /help kommando
För att ställa in inställningar, använd /set inställning = värde
Du kan använda /set inställning med partial namn (visar alla inställningar
som innehåller bokstäver), eller endast ett inställnings namn utan värde
(för att se hjälp information för inställningen).
Viktigt: inställningar sparas när WeeChat avslutas (eller med "/save"
kommando). Redigera INTE setup filen medan WeeChat körs, därför att
WeeChat får skriva i denna filen när som helst, och det är inte möjligt
att ladda om den.
För att ändra inställningar, använd "/set" kommandot, WeeChat använder då
direkt de nya inställningarna.
3. Skapa en server
Till exempel irc.quakenet.org, port 6667:
/server add quakenet irc.quakenet.org 6667
(/help server för mer hjälp)
4. Ställ in server inställningar
Smeknamn:
/set quakenet.server_nick1 = "mittnick"
/set quakenet.server_nick2 = "mittnick2"
/set quakenet.server_nick3 = "mittnick3"
Användarnamn/Riktigt namn:
/set quakenet.server_username = "Mitt användarnamn"
/set quakenet.server_realname = "Mitt riktiga namn"
Automatiskt ansluta till server:
/set quakenet.server_autoconnect = on
Automatiskt joina en/flera kanaler:
/set quakenet.server_autojoin = "#kanal1,#kanal2"
Andra inställningar:
Du kan se server inställningar och värden med /set quakenet
För att ställa in en inställning, använd /set quakenet.server_option = värde
5. Anslut till server och automatiskt gå in i kanaler:
/connect quakenet
6. Gå in i/lämna kanaler
Gå in i en kanal:
/join #kanal
Lämna en kanal:
/part [quit message]
Lämna en kanal och stäng buffert:
/close [quit message]
(/close är ett alias av /buffer close)
7. Buffert/fönster hantering
Du kan hantera bufferts med "/buffer" kommandot och fönster
med "/window" kommandot.
Till exempel, för att dela på en vertikal skärm till ett litet fönster (1/3 bredd),
och ett stort (2/3), använd kommandot:
/window splitv 33
8. Knapp bindningar
Efter ditt tangentbord och/eller dina behov, kan du binda om vilken knapp som helst
med "/key" kommandot.
En användbar knapp är meta-k (alt-k) för att hitta knapp koder.
Till exempel, för att binda meta-y (alt-y) till kommandot "/buffer close":
/key (tryck meta-k) (tryck-meta-y) /buffer close
Du ska nu ha en kommando rad som denna:
/key meta-y /buffer close
9. Insticksprogram/skripts
På några distributioner såsom Debian, finns insticksprogram via ett separat paket
(som weechat-plugins).
Insticksprogram laddas automatiskt när de hittats.
Det finns många insticksprogram/skripts till WeeChat, kolla:
http://weechat.flashtux.org/plugins.php
Kolla WeeChats dokumentation för att ladda/(unload) insticksprogram eller skripts.
10. Mer dokumentation
Du kan nu använda WeeChat och läsa FAQ/dokumentation för övriga frågor:
http://weechat.flashtux.org/faq.php
http://weechat.flashtux.org/doc.php
Njut av WeeChat!
--
(c) 2006-05-31, skrivet av FlashCode <flashcode@flashtux.org>
2008-04-08, Översatt till svenska av Robin Karlsson <robin---karlsson@telia.com>
Det här dokumentet är en del av WeeChat och är distribuerat under GPL
licens.

7
weechat.spec
View File

@ -17,7 +17,7 @@
#
%define name weechat
%define version 0.2.6
%define version 0.3.0
%define release 1
Name: %{name}
@ -59,7 +59,10 @@ rm -rf $RPM_BUILD_ROOT
%files -f %{name}.lang
%defattr(-,root,root,0755)
%doc AUTHORS BUGS ChangeLog COPYING FAQ FAQ.fr INSTALL NEWS README TODO
%doc AUTHORS ChangeLog COPYING INSTALL NEWS README
%doc doc/en/weechat_faq.en.txt doc/fr/weechat_faq.fr.txt
%doc doc/en/weechat_quickstart.en.txt doc/fr/weechat_quickstart.fr.txt
%doc doc/en/weechat_tester.en.txt doc/fr/weechat_tester.fr.txt
%{_mandir}/man1/%{name}-curses.1*
%{_bindir}/%{name}-curses
%{_libdir}/%{name}/plugins/*