36 |
|
|
37 |
@title WeeChat - Guide utilisateur |
@title WeeChat - Guide utilisateur |
38 |
@subtitle Client IRC rapide, l@'eger et extensible |
@subtitle Client IRC rapide, l@'eger et extensible |
39 |
@subtitle Documentation pour WeeChat v0.1.6-cvs - 18 octobre 2005 |
@subtitle Documentation pour WeeChat v0.1.6-cvs - 23 octobre 2005 |
40 |
|
|
41 |
@author FlashCode <@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> |
@author FlashCode <@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> |
42 |
|
|
266 |
@item look_weechat_slogan |
@item look_weechat_slogan |
267 |
Slogan WeeChat (si vide, le slogan ne sera pas utilis@'e)@* |
Slogan WeeChat (si vide, le slogan ne sera pas utilis@'e)@* |
268 |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: 'the geekest IRC client!'@* |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: 'the geekest IRC client!'@* |
269 |
@item look_charset_decode |
@item look_charset_decode_iso |
270 |
Jeu de caract@`eres pour d@'ecoder les messages du serveur, exemples: UTF-8, ISO-8859-1 (si non renseign@'e, les messages ne sont pas convertis)@* |
Jeu de caract@`eres ISO pour d@'ecoder les messages du serveur (utilis@'e seulement si la locale est UTF-8) (si non renseign@'e, les messages ne sont pas concertis si la locale est UTF-8)@* |
271 |
|
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: 'ISO-8859-1'@* |
272 |
|
@item look_charset_decode_utf |
273 |
|
Jeu de caract@`eres UTF pour d@'ecoder les messages du serveur (utilis@'e seulement si la locale n'est pas UTF-8) (si non renseign@'e, les messages ne sont pas convertis si la locale n'est pas UTF-8)@* |
274 |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: 'UTF-8'@* |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: 'UTF-8'@* |
275 |
@item look_charset_encode |
@item look_charset_encode |
276 |
Jeu de caract@`eres pour encoder les messages envoy@'es au serveur, exemples: UFT-8, ISO-8859-1 (si non renseign@'e, le jeu de caract@`eres local est utilis@'e)@* |
Jeu de caract@`eres pour encoder les messages envoy@'es au serveur, exemples: UFT-8, ISO-8859-1 (si non renseign@'e, les messages ne sont pas convertis)@* |
277 |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: ''@* |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: ''@* |
278 |
@item look_charset_internal |
@item look_charset_internal |
279 |
Jeu de caract@`eres interne @`a WeeChat, devrait @^etre ISO-xxxx m@^eme si la locale est UTF-8 (si non renseign@'e, le jeu de caract@`eres local est utilis@'e)@* |
Force le jeu de caract@`eres interne @`a WeeChat (doit @^etre vide dans la plupart des cas, ce qui signifie que le jeu de caract@`eres d@'etect@'e est utilis@'e)@* |
280 |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: 'ISO-8859-1'@* |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: ''@* |
281 |
@item look_buffer_timestamp |
@item look_buffer_timestamp |
282 |
Format de date/heure pour les tampons@* |
Format de date/heure pour les tampons@* |
283 |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: '[%H:%M:%S]'@* |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: '[%H:%M:%S]'@* |
439 |
Type: couleur (couleur Curses ou Gtk), valeur par d@'efaut: 'lightcyan'@* |
Type: couleur (couleur Curses ou Gtk), valeur par d@'efaut: 'lightcyan'@* |
440 |
@item col_input_delimiters |
@item col_input_delimiters |
441 |
Couleur pour le texte saisi (d@'elimiteurs)@* |
Couleur pour le texte saisi (d@'elimiteurs)@* |
442 |
Type: couleur (couleur Curses ou Gtk), valeur par d@'efaut: 'lightgreen'@* |
Type: couleur (couleur Curses ou Gtk), valeur par d@'efaut: 'white'@* |
443 |
@item col_input_bg |
@item col_input_bg |
444 |
Couleur de fond pour la fen@^etre de saisie@* |
Couleur de fond pour la fen@^etre de saisie@* |
445 |
Type: couleur (couleur Curses ou Gtk), valeur par d@'efaut: 'default'@* |
Type: couleur (couleur Curses ou Gtk), valeur par d@'efaut: 'default'@* |
602 |
@item dcc_blocksize |
@item dcc_blocksize |
603 |
Taille de bloc pour les paquets dcc en octets (d@'efaut: 65536)@* |
Taille de bloc pour les paquets dcc en octets (d@'efaut: 65536)@* |
604 |
Type: entier (valeurs: entre 1024 et 102400), valeur par d@'efaut: 65536@* |
Type: entier (valeurs: entre 1024 et 102400), valeur par d@'efaut: 65536@* |
605 |
|
@item dcc_port_range |
606 |
|
Restreint le dcc sortant @`a utiliser des ports dans la plage donn@'ee (pratique pour le NAT) (syntaxe: un port simple, par exemple 5000, une plage de ports, par exemple 5000-5015, si non renseign@'e tout port peut @^etre utilis@'e)@* |
607 |
|
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: ''@* |
608 |
|
@item dcc_own_ip |
609 |
|
Adresse IP ou DNS utilis@'ee pour le dcc sortant (si non renseign@'e, l'interface IP locale est utilis@'ee)@* |
610 |
|
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: ''@* |
611 |
@item dcc_download_path |
@item dcc_download_path |
612 |
Chemin pour @'ecrire les fichiers re@,{c}us par dcc (par d@'efaut: r@'epertoire de l'utilisateur)@* |
Chemin pour @'ecrire les fichiers re@,{c}us par dcc (par d@'efaut: r@'epertoire de l'utilisateur)@* |
613 |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: '~'@* |
Type: cha@^ine (toute cha@^ine), valeur par d@'efaut: '~'@* |
988 |
Pour chaque param@`etre, '*' signifie tou(te)s.@* |
Pour chaque param@`etre, '*' signifie tou(te)s.@* |
989 |
Sans param@`etre, /ignore liste les ignore d@'efinis.@* |
Sans param@`etre, /ignore liste les ignore d@'efinis.@* |
990 |
@* |
@* |
991 |
@item window [list | splith | splitv | [merge [down | up | left | right | all]]] |
@item window [list | -1 | +1 | b# | splith | splitv | [merge [down | up | left | right | all]]] |
992 |
@* |
@* |
993 |
gestion des fen@^etres@* |
gestion des fen@^etres@* |
994 |
@* |
@* |
995 |
list: liste les fen@^etres ouvertes (pas de param@`etre affiche cette liste)@* |
list: liste les fen@^etres ouvertes (pas de param@`etre affiche cette liste)@* |
996 |
|
-1: saute @`a la fen@^etre pr@'ec@'edente@* |
997 |
|
+1: saute @`a la fen@^etre suivante@* |
998 |
|
b#: saute @`a la fen@^etre affichant le tampon n°#@* |
999 |
splith: @'eclate la fen@^etre en deux horizontalement@* |
splith: @'eclate la fen@^etre en deux horizontalement@* |
1000 |
splitv: @'eclate la fen@^etre en deux verticalement@* |
splitv: @'eclate la fen@^etre en deux verticalement@* |
1001 |
merge: fusionne la fen@^etre avec une autre@* |
merge: fusionne la fen@^etre avec une autre@* |
1540 |
@* |
@* |
1541 |
L'extension doit @^etre au format biblioth@`eque, chargeable |
L'extension doit @^etre au format biblioth@`eque, chargeable |
1542 |
dynamiquement par le syst@^eme d'exploitation.@* |
dynamiquement par le syst@^eme d'exploitation.@* |
1543 |
Sous GNU/Linux, il s'agit d'un fichier ayant pour extension ``.so''. |
Sous GNU/Linux, il s'agit d'un fichier ayant pour extension ``.so'', |
1544 |
|
sous Windows ``.dll''. |
1545 |
|
|
1546 |
@node Ecrire une extension, Exemple d'extension, Les extensions dans WeeChat, Extensions |
@node Ecrire une extension, Exemple d'extension, Les extensions dans WeeChat, Extensions |
1547 |
@section Ecrire une extension |
@section Ecrire une extension |
1564 |
@end itemize |
@end itemize |
1565 |
@item fonctions d'initialisation et fin de l'extension : |
@item fonctions d'initialisation et fin de l'extension : |
1566 |
@itemize @minus |
@itemize @minus |
1567 |
@item weechat_plugin_init: fonction appel@'e au chargement de l'extension |
@item weechat_plugin_init: fonction appel@'ee au chargement de l'extension |
1568 |
@item weechat_plugin_end: fonction appel@'e au d@'echargement de l'extension |
@item weechat_plugin_end: fonction appel@'ee au d@'echargement de l'extension |
1569 |
@end itemize |
@end itemize |
1570 |
@end itemize |
@end itemize |
1571 |
|
|
1573 |
|
|
1574 |
L'extension peut appeler un certain nombre de fonctions d@'efinies |
L'extension peut appeler un certain nombre de fonctions d@'efinies |
1575 |
dans la structure t_weechat_plugin.@* |
dans la structure t_weechat_plugin.@* |
1576 |
Ces fonctions sont d@'etaill@'ees ci-dessous : |
@* |
1577 |
|
Ces fonctions sont d@'etaill@'ees ci-dessous :@* |
1578 |
|
|
1579 |
@itemize @bullet |
@itemize @bullet |
1580 |
@item |
@item |
1602 |
@* |
@* |
1603 |
|
|
1604 |
@item |
@item |
1605 |
|
@command{int ascii_strncasecmp (t_weechat_plugin *plugin, |
1606 |
|
char *string1, char *string2, int max)}@* |
1607 |
|
@* |
1608 |
|
Effectue une comparaison entre deux cha@^ines, sans tenir compte des |
1609 |
|
majuscules/minuscules ni de la locale, en comparant au plus ``max'' |
1610 |
|
caract@`eres.@* |
1611 |
|
|
1612 |
|
@emph{Param@`etres :} |
1613 |
|
@itemize @minus |
1614 |
|
@item @option{plugin}: un pointeur vers la structure de l'extension |
1615 |
|
@item @option{string1}: la premi@`ere cha@^ine @`a comparer |
1616 |
|
@item @option{string2}: la deuxi@`eme cha@^ine @`a comparer |
1617 |
|
@item @option{max}: nombre de caract@`eres max @`a comparer |
1618 |
|
@end itemize |
1619 |
|
@* |
1620 |
|
@emph{Valeur renvoy@'ee :}@* |
1621 |
|
@* |
1622 |
|
La diff@'erence entre les deux cha@^ines: n@'egatif si chaine1 < |
1623 |
|
chaine2, nul si chaine1 == chaine 2, positif si chaine1 > chaine2@* |
1624 |
|
@* |
1625 |
|
@emph{Exemple :}@* |
1626 |
|
@* |
1627 |
|
@code{if (plugin->ascii_strncasecmp (plugin, "abc", "def", 2) != 0) ...}@* |
1628 |
|
@* |
1629 |
|
|
1630 |
|
@item |
1631 |
@command{char **explode_string (t_weechat_plugin *plugin, |
@command{char **explode_string (t_weechat_plugin *plugin, |
1632 |
char *string, char *separators, int num_items_max, int *num_items)}@* |
char *string, char *separators, int num_items_max, int *num_items)}@* |
1633 |
@* |
@* |
2117 |
|
|
2118 |
Un exemple complet d'extension, qui ajoute une commande /double |
Un exemple complet d'extension, qui ajoute une commande /double |
2119 |
affichant deux fois les param@`etres pass@'es sur le canal courant |
affichant deux fois les param@`etres pass@'es sur le canal courant |
2120 |
(d'accord ce n'est pas tr@`es utile mais ceci est un exemple !) : |
(d'accord ce n'est pas tr@`es utile mais ceci est un exemple !) :@* |
2121 |
|
|
2122 |
@verbatim |
@verbatim |
2123 |
#include <stdlib.h> |
#include <stdlib.h> |
2147 |
plugin->cmd_handler_add (plugin, "double", |
plugin->cmd_handler_add (plugin, "double", |
2148 |
"Affiche deux fois un message", |
"Affiche deux fois un message", |
2149 |
"msg", |
"msg", |
2150 |
"msg: message @`a afficher deux fois", |
"msg: message a afficher deux fois", |
2151 |
&toto_cmd_double, |
&toto_cmd_double, |
2152 |
NULL, NULL); |
NULL, NULL); |
2153 |
return 1; |
return 1; |
2323 |
@* |
@* |
2324 |
|
|
2325 |
@item |
@item |
2326 |
@command{weechat::get_info ( nom, [serveur] );}@* |
@command{weechat::get_info ( nom, [serveur, [canal] ] );}@* |
2327 |
@* |
@* |
2328 |
Obtenir des informations vari@'ees sur WeeChat, le serveur ou l'utilisateur.@* |
Obtenir des informations vari@'ees sur WeeChat, le serveur ou l'utilisateur.@* |
2329 |
|
|
2343 |
syst@`eme de partage WeeChat |
syst@`eme de partage WeeChat |
2344 |
@end itemize |
@end itemize |
2345 |
@item @option{serveur}: nom interne du serveur |
@item @option{serveur}: nom interne du serveur |
2346 |
|
@item @option{canal}: nom du canal |
2347 |
@end itemize |
@end itemize |
2348 |
@* |
@* |
2349 |
@emph{Exemples :}@* |
@emph{Exemples :}@* |