diff options
Diffstat (limited to 'doc/fr/autogen/user/weechat_commands.adoc')
-rw-r--r-- | doc/fr/autogen/user/weechat_commands.adoc | 991 |
1 files changed, 991 insertions, 0 deletions
diff --git a/doc/fr/autogen/user/weechat_commands.adoc b/doc/fr/autogen/user/weechat_commands.adoc new file mode 100644 index 000000000..3c83e93f9 --- /dev/null +++ b/doc/fr/autogen/user/weechat_commands.adoc @@ -0,0 +1,991 @@ +// +// This file is auto-generated by script docgen.py. +// DO NOT EDIT BY HAND! +// +[[command_weechat_away]] +* `+away+`: définir ou supprimer le statut d'absence + +---- +/away [-all] [<message>] + + -all : définir ou supprimer le statut d'absence sur tous les serveurs connectés +message : message pour l'absence (si pas de message donné, le statut d'absence est supprimé) +---- + +[[command_weechat_bar]] +* `+bar+`: gestion des barres + +---- +/bar list|listfull|listitems + add <nom> <type>[,<conditions>] <position> <taille> <séparateur> <objet1>[,<objet2>...] + default [input|title|status|nicklist] + del <nom>|-all + set <nom> <option> <valeur> + hide|show|toggle <nom> + scroll <nom> <fenêtre> <valeur_scroll> + + list : lister toutes les barres + listfull : lister toutes les barres (verbeux) + listitems : lister tous les objets de barre + add : ajouter une nouvelle barre + nom : nom de la barre (doit être unique) + type : root : en dehors des fenêtres + window : dans les fenêtres, avec condition(s) optionnelle(s) (voir ci-dessous) + conditions : les conditions pour afficher la barre : + active : sur la fenêtre active + inactive : sur les fenêtres inactives + nicklist : sur les fenêtres avec liste de pseudos + autre condition : voir /help weechat.bar.xxx.conditions et /help eval + sans condition, la barre est toujours affichée + position : bottom (bas), top (haut), left (gauche) ou right (droite) + taille : taille de la barre (en caractères) + séparateur : 1 pour utiliser un séparateur (ligne), 0 ou rien signifie sans séparateur + objet1,... : objets pour cette barre (les objets peuvent être séparés par une virgule (espace entre les objets) ou "+" (objets collés)) + default : créer une barre par défaut (toutes les barres par défaut si aucun nom de barre n'est donné) + del : supprimer une barre (ou toutes les barres avec -all) + set : changer la valeur d'une propriété de la barre + option : option à modifier (pour la liste des options, voir /set weechat.bar.<nombarre>.* + valeur : nouvelle valeur pour l'option + hide : cacher la barre + show : montrer une barre cachée + toggle : cacher/montrer une barre + scroll : faire défiler la barre + fenêtre : numéro de fenêtre (utilisez '*' pour la fenêtre courante ou une barre de type root) +valeur_scroll : valeur pour le défilement : 'x' ou 'y' (optionnel), suivi par '+', '-', 'b' (début) ou 'e' (fin), valeur (pour +/-), et un % optionnel (pour faire défiler par % de la largeur/hauteur, sinon la valeur est un nombre de caractères) + +Exemples : + créer une barre avec l'heure, numéro + nom de tampon, et la complétion : + /bar add mabarre root bottom 1 0 [time],buffer_number+:+buffer_name,completion + cacher une barre : + /bar hide mabarre + faire défiler la liste des pseudos de 10 lignes vers le bas sur le tampon courant : + /bar scroll nicklist * y+10 + faire défiler la liste des pseudos à la fin sur le tampon courant : + /bar scroll nicklist * ye +---- + +[[command_weechat_buffer]] +* `+buffer+`: gestion des tampons + +---- +/buffer list + clear [<nombre>|<nom>|-merged|-all [<nombre>|<nom>...]] + move <nombre>|-|+ + swap <nombre1>|<nom1> [<nombre2>|<nom2>] + merge <nombre> + unmerge [<nombre>|-all] + hide [<nombre>|<nom>|-all [<nombre>|<nom>...]] + unhide [<nombre>|<nom>|-all [<nombre>|<nom>...]] + renumber <nombre1> [<nombre2> [<départ>]] + close [<n1>[-<n2>]|<nom>] + notify <niveau> + localvar + set <propriété> <valeur> + get <propriété> + <nombre>|<nom> + + list : lister les tampons ouverts (sans paramètre, cette liste est affichée) + clear : effacer le contenu du tampon (un numéro pour un tampon, -merged pour les tampons mélangés, -all pour tous les tampons, ou rien pour le tampon courant) + move : déplacer le tampon dans la liste (peut être relatif, par exemple -1) ; "-" = déplacer vers le premier numéro de tampon, "+" = déplacer vers le dernier numéro de tampon + 1 + swap : échanger deux tampons (échanger avec le tampon courant si un seul numéro/nom donné) + merge : mélanger le tampon courant avec un autre tampon (la zone de discussion sera un mélange des deux tampons) + (par défaut ctrl-x bascule entre les tampons mélangés) + unmerge : détacher le tampon courant des autres tampons portant le même numéro + hide : masquer le tampon + unhide : démasquer le tampon +renumber : renuméroter des tampons (fonctionne seulement si l'option weechat.look.buffer_auto_renumber est désactivée) + close : fermer le tampon (nombre/intervalle ou nom optionnel) + notify : définir le niveau de notification pour le tampon courant : ce niveau détermine si le tampon doit être ajouté à la hotlist ou pas : + none : jamais + highlight : pour les highlights seulement + message : pour les messages d'utilisateurs + highlights + all : pour tous les messages + reset : réinitialise à valeur par défaut (all) +localvar : afficher la liste des variables locales pour le tampon courant + set : modifier une propriété du tampon courant + get : afficher une propriété du tampon courant + nombre : sauter au tampon qui a ce numéro, préfixe possible : + '+' : saut relatif, ajoute le numéro au courant, + '-' : saut relatif, soustrait le numéro au courant, + '*' : saut au numéro en utilisant l'option "jump_current_to_previous_buffer" + - : sauter au premier numéro de tampon + + : sauter au dernier numéro de tampon + nom : sauter au tampon par nom (partiel) + +Exemples : + effacer le tampon courant : + /buffer clear + déplacer le tampon vers le numéro 5 : + /buffer move 5 + échanger le tampon 1 avec le 3 : + /buffer swap 1 3 + échanger le tampon #weechat avec le tampon courant : + /buffer swap #weechat + mélanger avec le tampon core : + /buffer merge 1 + détacher le tampon : + /buffer unmerge + fermer le tampon courant : + /buffer close + fermer les tampons 5 à 7 : + /buffer close 5-7 + aller sur #weechat : + /buffer #weechat + aller au tampon suivant : + /buffer +1 + aller au dernier numéro de tampon : + /buffer + +---- + +[[command_weechat_color]] +* `+color+`: définir des alias de couleurs et afficher la palette des couleurs + +---- +/color alias <couleur> <nom> + unalias <couleur> + reset + term2rgb <color> + rgb2term <rgb> [<limit>] + -o + + alias : ajouter un alias pour une couleur + unalias : supprimer un alias pour une couleur + couleur : numéro de couleur (supérieur ou égal à 0, le max dépend du terminal, généralement 63 ou 255) + nom : nom d'alias pour la couleur (par exemple : "orange") + reset : réinitialiser toutes les paires de couleurs (requis quand il n'y a plus de paires de couleurs disponibles si la réinitialisation automatique est désactivée, voir l'option "weechat.look.color_pairs_auto_reset") +term2rgb : convertir une couleur du terminal (0-255) en couleur RGB +rgb2term : convertir une couleur RGB en couleur du terminal (0-255) + limite : nombre de couleurs à utiliser dans la table du terminal (en démarrant de 0) ; par défaut 256 + -o : envoyer les infos terminal/couleurs sur le tampon courant comme entrée + +Sans paramètre, cette commande affiche les couleurs dans un nouveau tampon. + +Exemples : + ajouter l'alias "orange" pour la couleur 214 : + /color alias 214 orange + supprimer la couleur 214 : + /color unalias 214 +---- + +[[command_weechat_command]] +* `+command+`: lancer explicitement une commande WeeChat ou d'une extension + +---- +/command [-buffer <nom>] <extension> <commande> + + -buffer : exécuter la commande sur ce tampon +extension : exécuter la commande de cette extension ; 'core' pour une commande WeeChat, '*' pour une extension automatique (cela dépend sur quel tampon est exécutée la commande) + commande : commande à exécuter (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande) +---- + +[[command_weechat_cursor]] +* `+cursor+`: mouvement libre du curseur sur l'écran pour exécuter des actions sur des zones spécifiques de l'écran + +---- +/cursor go chat|<barre>|<x>,<y> + move up|down|left|right|area_up|area_down|area_left|area_right + stop + + go : déplacer le curseur vers la zone de discussion ("chat"), une barre (en utilisant son nom) ou les coordonnées "x,y" +move : déplacer le curseur dans une direction +stop : arrêter le mode curseur + +Sans paramètre, cette commande active/désactive le mode curseur. + +Lorsque la souris est activée (voir /help mouse), par défaut un clic du milieu démarre le mode curseur à ce point. + +Touches par défaut dans le mode curseur sur les messages de la zone de discussion : + m citer le message + q citer le préfixe + le message + Q citer l'heure + le préfixe + le message + +Touches par défaut dans le mode curseur sur la liste de pseudos : + b bannir le pseudo (/ban) + k éjecter le pseudo (/kick) + K éjecter et bannir le pseudo (/kickban) + q ouvrir une discussion privée avec le pseudo (/query) + w demander les informations sur l'utilisateur (/whois) + +Exemples : + aller dans la liste des pseudos : + /cursor go nicklist + aller aux coordonnées x=10, y=5 : + /cursor go 10,5 +---- + +[[command_weechat_debug]] +* `+debug+`: contrôle du debug pour le cœur/les extensions + +---- +/debug list + set <extension> <niveau> + dump [<extension>] + buffer|color|infolists|memory|tags|term|windows + cursor|mouse [verbose] + hdata [free] + + list : lister les extensions avec leur niveau de debug + set : définir le niveau de debug pour l'extension +extension : nom de l'extension ("core" pour le cœur de WeeChat) + niveau : niveau de debug pour l'extension + dump : afficher les variables mémoire WeeChat dans le fichier log (les mêmes messages sont affichés lorsque WeeChat plante) + buffer : afficher le contenu du tampon en valeurs hexadécimales dans le fichier log + color : afficher des infos sur les paires de couleur courantes + cursor : activer/désactiver le debug pour le mode curseur + dirs : afficher les répertoires + hdata : afficher des infos sur les hdata (avec free : supprimer tous les hdata en mémoire) + hooks : afficher des infos sur les hooks +infolists : afficher des infos sur les infolists + libs : afficher des infos sur les bibliothèques externes utilisées + memory : afficher des infos sur l'utilisation de la mémoire + mouse : activer/désactiver le debug pour la souris + tags : afficher les étiquettes pour les lignes + term : afficher des infos sur le terminal + windows : afficher l'arbre des fenêtres +---- + +[[command_weechat_eval]] +* `+eval+`: évaluer une expression + +---- +/eval [-n|-s] <expression> + [-n] -c <expression1> <opérateur> <expression2> + + -n : afficher le résultat sans envoyer au tampon (mode debug) + -s : découper l'expression avant de l'évaluer (plusieurs commandes peuvent être séparées par des points-virgules) + -c : évaluer comme une condition : utiliser les opérateurs et les parenthèses, retourner une valeur booléenne ("0" ou "1") +expression : expression à évaluer, les variables avec le format ${variable} sont remplacées (voir ci-dessous) ; plusieurs commandes peuvent être séparées par des points-virgules + opérateur : un opérateur logique ou de comparaison : + - opérateurs logiques : + && "et" booléen + || "ou" booléen + - opérateurs de comparaison : + == égal + != non égal + <= inférieur ou égal + < inférieur + >= supérieur ou égal + > supérieur + =~ correspond à l'expression régulière POSIX étendue + !~ ne correspond PAS à l'expression régulière POSIX étendue + +Une expression est considérée comme "vraie" si elle est non NULL, non vide, et différente de "0". +La comparaison est faite en utilisant des entiers si les deux expressions sont des entiers valides. +Pour forcer une comparaison de chaînes, ajoutez des guillemets autour de chaque expression, par exemple : + 50 > 100 ==> 0 + "50" > "100" ==> 1 + +Des variables sont remplacées dans l'expression, en utilisant le format ${variable}, la variable pouvant être, par ordre de priorité : + 1. une sous-chaîne évaluée (format : "eval:xxx") + 2. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx") + 3. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne") + 4. une couleur (format : "color:xxx") + 5. une info (format : "info:nom,paramètres", les paramètres sont optionnels) + 6. la date/heure courante (format : "date" ou "date:format") + 7. une variable d'environnement (format : "env:XXX") + 8. une option (format : "fichier.section.option") + 9. une variable locale du tampon + 10. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants. +Le format du hdata peut être le suivant : + hdata.var1.var2... : démarrer avec un hdata (le pointeur doit être connu), et demander les variables l'une après l'autre (d'autres hdata peuvent être suivis) + hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste, par exemple : + ${buffer[gui_buffers].full_name} : nom complet du premier tampon dans la liste chaînée des tampons + ${plugin[weechat_plugins].name} : nom de la première extension dans la liste chaînée des extensions + hdata[pointeur].var1.var2... : démarrer avec un hdata en utilisant un pointeur, par exemple : + ${buffer[0x1234abcd].full_name} : nom complet du tampon avec ce pointeur (peut être utilisé dans les triggers) +Pour le nom du hdata et des variables, voir la "Référence API extension", fonction "weechat_hdata_get". + +Exemples (chaînes simples) : + /eval -n ${info:version} ==> 0.4.3 + /eval -n ${env:HOME} ==> /home/user + /eval -n ${weechat.look.scroll_amount} ==> 3 + /eval -n ${window} ==> 0x2549aa0 + /eval -n ${window.buffer} ==> 0x2549320 + /eval -n ${window.buffer.full_name} ==> core.weechat + /eval -n ${window.buffer.number} ==> 1 + /eval -n ${\t} ==> <tab> + /eval -n ${hide:-,${relay.network.password}} ==> -------- + /eval -n ${date:%H:%M:%S} ==> 07:46:40 + +Exemples (conditions) : + /eval -n -c ${window.buffer.number} > 2 ==> 0 + /eval -n -c ${window.win_width} > 100 ==> 1 + /eval -n -c (8 > 12) || (5 > 2) ==> 1 + /eval -n -c (8 > 12) && (5 > 2) ==> 0 + /eval -n -c abcd =~ ^ABC ==> 1 + /eval -n -c abcd =~ (?-i)^ABC ==> 0 + /eval -n -c abcd =~ (?-i)^abc ==> 1 + /eval -n -c abcd !~ abc ==> 0 +---- + +[[command_weechat_filter]] +* `+filter+`: filtrer les messages dans les tampons, pour les cacher/afficher selon des étiquettes ou expressions régulières + +---- +/filter list + enable|disable|toggle [<nom>|@] + add <nom> <tampon>[,<tampon>...] <étiquettes> <regex> + rename <nom> <nouveau_nom> + del <nom>|-all + + list : lister tous les filtres + enable : activer les filtres (par défaut les filtres sont activés) + disable : désactiver les filtres + toggle : activer/désactiver les filtres + nom : nom de filtre ("@" = activer/désactiver tous les filtres dans le tampon courant) + add : ajouter un filtre + rename : renommer un filtre + del : supprimer un filtre + -all : supprimer tous les filtres + tampon : liste des tampons, séparés par des virgules, où le filtre est actif : + - il s'agit du nom complet incluant l'extension (exemple : "irc.freenode.#weechat" ou "irc.server.freenode") + - "*" signifie tous les tampons + - un nom commençant par '!' est exclu + - le caractère joker "*" est autorisé +étiquettes : liste d'étiquettes, séparées par des virgules, par exemple : "irc_join,irc_part,irc_quit" + - "et" logique : utilisez "+" entre les étiquettes (par exemple : "nick_toto+irc_action") + - le caractère joker "*" est autorisé + - si l'étiquette commence par '!', alors elle est exclue et ne doit PAS être dans le message + regex : expression régulière POSIX étendue à rechercher dans la ligne + - utiliser '\t' pour séparer le préfixe du message, les caractères spéciaux comme '|' doivent être échappés : '\|' + - si l'expression régulière commence par '!' alors le résultat est inversé (utiliser '\!' pour démarrer par '!') + - deux expressions régulières sont créées : une pour le préfixe et une pour le message + - les expressions régulières sont insensibles à la casse, elles peuvent commencer par "(?-i)" pour devenir sensibles à la casse + +La touche par défaut alt+'=' active/désactive le filtrage. + +Les étiquettes les plus couramment utilisées : + no_filter, no_highlight, no_log, log0..log9 (niveau de log), + notify_none, notify_message, notify_private, notify_highlight, + nick_xxx (xxx est le pseudo dans le message), prefix_nick_ccc (ccc est la couleur du pseudo), + host_xxx (xxx est le nom d'utilisateur + hôte dans le message), + irc_xxx (xxx est un nom de commande ou nombre, voir /server raw ou /debug tags), + irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info. +Pour voir les étiquettes des lignes affichées : /debug tags + +Exemples : + utiliser le filtre intelligent IRC sur tous les tampons : + /filter add irc_smart * irc_smart_filter * + utiliser le filtre intelligent IRC sur tous les tampons sauf ceux avec "#weechat" dans le nom : + /filter add irc_smart *,!*#weechat* irc_smart_filter * + filtrer tous les messages IRC join/part/quit : + /filter add joinquit * irc_join,irc_part,irc_quit * + filtrer les pseudos afficher en rejoignant les canaux ou avec /names : + /filter add nicks * irc_366 * + filtrer le pseudo "toto" sur le canal IRC #weechat : + /filter add toto irc.freenode.#weechat nick_toto * + filtrer les messages IRC join/action du pseudo "toto" : + /filter add toto * nick_toto+irc_join,nick_toto+irc_action * + filtrer les lignes contenant "weechat sucks" sur le canal IRC #weechat : + /filter add sucks irc.freenode.#weechat * weechat sucks + filtrer les lignes qui sont strictement égales à "WeeChat sucks" sur tous les tampons : + /filter add sucks2 * * (?-i)^WeeChat sucks$ +---- + +[[command_weechat_help]] +* `+help+`: afficher l'aide sur les commandes et les options + +---- +/help -list|-listfull [<extension> [<extension>...]] + <commande> + <option> + + -list : lister les commandes, par extension (sans paramètre, cette liste est affichée) +-listfull : lister les commandes avec description, par extension +extension : lister les commandes de cette extension + commande : un nom de commande + option : un nom d'option (utilisez /set pour voir la liste) +---- + +[[command_weechat_history]] +* `+history+`: afficher l'historique des commandes du tampon + +---- +/history clear + <valeur> + + clear : effacer l'historique +valeur : nombre d'entrées dans l'historique à afficher +---- + +[[command_weechat_input]] +* `+input+`: fonctions pour la ligne de commande + +---- +/input <action> [<paramètres>] + +liste des actions : + return : simuler la touche "entrée" + complete_next : compléter le mot avec la complétion suivante + complete_previous : compléter le mot avec la complétion précédente + search_text_here : chercher du texte dans le tampon à la position courante + search_text : chercher du texte dans le tampon + search_switch_case : basculer la casse exacte pour la recherche + search_switch_regex : basculer le type de recherche : chaîne/expression régulière + search_switch_where : basculer la recherche dans les messages/préfixes + search_previous : chercher la ligne précédente + search_next : chercher la ligne suivante + search_stop_here : arrêter la recherche à la position courante + search_stop : arrêter la recherche + delete_previous_char : effacer le caractère précédent + delete_next_char : effacer le caractère suivant + delete_previous_word : effacer le mot précédent + delete_next_word : effacer le mot suivant + delete_beginning_of_line : effacer du début de la ligne jusqu'au curseur + delete_end_of_line : effacer du curseur jusqu'à la fin de la ligne + delete_line : effacer la ligne entière + clipboard_paste : coller depuis le presse-papiers + transpose_chars : inverser deux caractères + undo : défaire la dernière action de la ligne de commande + redo : refaire la dernière action de la ligne de commande + move_beginning_of_line : déplacer le curseur au début de la ligne + move_end_of_line : déplacer le curseur à la fin de la ligne + move_previous_char : déplacer le curseur sur le caractère précédent + move_next_char : déplacer le curseur sur le caractère suivant + move_previous_word : déplacer le curseur sur le mot précédent + move_next_word : déplacer le curseur sur le mot suivant + history_previous : rappeler la commande précédente dans l'historique du tampon courant + history_next : rappeler la commande suivante dans l'historique du tampon courant + history_global_previous : rappeler la commande précédente dans l'historique global + history_global_next : rappeler la commande suivante dans l'historique global + jump_smart : sauter au prochain tampon avec de l'activité + jump_last_buffer_displayed : sauter au dernier tampon affiché (avant le dernier saut vers un tampon) + jump_previously_visited_buffer : sauter au tampon visité précédemment + jump_next_visited_buffer : sauter au tampon visité après + hotlist_clear : effacer la hotlist + grab_key : capturer une touche (paramètre facultatif : délai pour la fin de la capture, par défaut 500 millisecondes) + grab_key_command : capturer une touche avec sa commande associée (paramètre facultatif : délai pour la fin de la capture, par défaut 500 millisecondes) + grab_mouse : capturer un évènement de la souris + grab_mouse_area : capturer un évènement de la souris avec la zone + set_unread : définir le marqueur de données non lues pour tous les tampons + set_unread_current_buffer : définir le marqueur de données non lues pour le tampon courant + switch_active_buffer : basculer vers le tampon mélangé suivant + switch_active_buffer_previous : basculer vers le tampon mélangé précédent + zoom_merged_buffer : zoom sur le tampon mélangé + insert : insérer du texte dans la ligne de commande (les caractères échappés sont autorisés, voir /help print) + send : envoyer du texte au tampon + paste_start : début de collage (mode "bracketed paste") + paste_stop : fin de collage (mode "bracketed paste") + +Cette commande est utilisé par les associations de touches ou les extensions. +---- + +[[command_weechat_key]] +* `+key+`: associer/libérer des touches + +---- +/key list|listdefault|listdiff [<contexte>] + bind <touche> [<commande> [<args>]] + bindctxt <contexte> <touche> [<commande> [<args>]] + unbind <touche> + unbindctxt <contexte> <touche> + reset <touche> + resetctxt <contexte> <touche> + resetall -yes [<contexte>] + missing [<contexte>] + + list : afficher toutes les touches courantes (sans paramètre, cette liste est affichée) +listdefault : afficher les touches par défaut + listdiff : afficher les différences entre les touches courantes et celles par défaut (touches ajoutées, redéfinies ou supprimées) + contexte : nom du contexte ("default" ou "search") + bind : associer une commande à une touche ou affiche la commande associée à la touche + bindctxt : associer une commande à une touche ou affiche la commande associée à la touche pour le contexte donné + commande : commande (plusieurs commandes peuvent êtres séparées par des points-virgules) + unbind : supprimer l'association à une touche + unbindctxt : supprimer l'association à une touche pour le contexte donné + reset : réinitialiser une touche à son association par défaut + resetctxt : réinitialiser une touche à son association par défaut pour le contexte donné + resetall : restaurer les touches aux valeurs par défaut et supprimer TOUTES les touches personnelles (utiliser avec précaution !) + missing : ajouter les touches manquantes (en utilisant les touches par défaut), pratique après installation d'une nouvelle version de WeeChat + +Lors de l'association d'une commande à une touche, il est recommandé d'utiliser la touche alt+k (ou Échap puis k), et puis de presser la touche à associer : cela insère le code de la touche dans la ligne de commande. + +Pour le contexte "mouse" (possible aussi pour le contexte "cursor"), la touche a le format : "@zone:touche" ou "@zone1>zone2:touche" où la zone peut être : + * : n'importe quelle zone à l'écran + chat : la zone de discussion (n'importe quel tampon) + chat(xxx) : la zone de discussion pour le tampon avec le nom "xxx" (nom complet incluant l'extension) + bar(*) : n'importe quelle barre + bar(xxx) : la barre "xxx" + item(*) : n'importe quel objet de barre + item(xxx) : l'objet de barre "xxx" +La caractère joker "*" est autorisé pour plusieurs évènements de la souris. +Une valeur spéciale pour la commande avec le format "hsignal:nom" peut être utilisée dans le contexte "mouse", cela enverra le signal "nom" avec la table de hachage du focus comme paramètre. +Une autre valeur spéciale "-" peut être utilisée pour désactiver la touche (elle sera ignorée lors de la recherche de touches). + +Exemples : + touche alt-t pour activer/désactiver la liste des pseudos : + /key bind meta-t /bar toggle nicklist + touche alt-r pour aller sur le canal IRC #weechat : + /key bind meta-r /buffer #weechat + restaure l'association par défaut pour la touche alt-r : + /key reset meta-r + touche "tab" pour arrêter la recherche dans le tampon : + /key bindctxt search ctrl-I /input search_stop + bouton du milieu de la souris sur un pseudo pour récupérer les infos sur le pseudo : + /key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick} +---- + +[[command_weechat_layout]] +* `+layout+`: gestion des dispositions de tampons/fenêtres + +---- +/layout store [<nom>] [buffers|windows] + apply [<nom>] [buffers|windows] + leave + del [<nom>] [buffers|windows] + rename <nom> <nouveau_nom> + + store : stocker les tampons/fenêtres courants dans une disposition + apply : appliquer une disposition stockée + leave : quitter la disposition courante (ne met à jour aucune disposition) + del : supprimer les tampons et/ou fenêtres dans une disposition stockée + (si ni "buffers" ni "windows" n'est donné après le nom, la disposition est supprimée) + rename : renommer une disposition + nom : nom pour la disposition stockée (par défaut "default") +buffers : stocker/appliquer seulement pour les tampons (ordre des tampons) +windows : stocker/appliquer seulement pour les fenêtres (le tampon affiché par chaque fenêtre) + +Sans paramètre, cette commande affiche les dispositions stockées. + +La disposition courante peut être sauvegardée sur la commande /quit avec l'option "weechat.look.save_layout_on_exit". +---- + +[[command_weechat_mouse]] +* `+mouse+`: contrôle de la souris + +---- +/mouse enable|disable|toggle [<délai>] + + enable : activer la souris +disable : désactiver la souris + toggle : activer/désactiver la souris + délai : délai (en secondes) après lequel l'état initial de la souris est restauré (pratique pour désactiver temporairement la souris) + +L'état de la souris est sauvé dans l'option "weechat.look.mouse". + +Exemples : + activer la souris : + /mouse enable + activer/désactiver la souris pendant 5 secondes : + /mouse toggle 5 +---- + +[[command_weechat_mute]] +* `+mute+`: exécuter une commande silencieusement + +---- +/mute [-core | -current | -buffer <nom>] <commande> + + -core : pas d'affichage sur le tampon core WeeChat +-current : pas d'affichage sur le tampon courant + -buffer : pas d'affichage sur le tampon spécifié + nom : nom complet du tampon (exemples : "irc.server.freenode", "irc.freenode.#weechat") +commande : commande à exécuter silencieusement (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande) + +Si aucune cible n'est spécifiée (-core, -current ou -buffer), alors par défaut tous les tampons seront silencieux. + +Exemples : + sauvegarde configuration : + /mute save + message au canal IRC courant : + /mute -current msg * bonjour ! + message au canal #weechat : + /mute -buffer irc.freenode.#weechat msg #weechat bonjour ! +---- + +[[command_weechat_plugin]] +* `+plugin+`: lister/charger/décharger des extensions + +---- +/plugin list|listfull [<nom>] + load <fichier> [<paramètres>] + autoload [<paramètres>] + reload [<nom>|* [<paramètres]] + unload [<nom>] + + list : lister les extensions chargées + listfull : lister les extensions chargées (verbeux) + load : charger une extension + autoload : charger automatiquement les extensions dans un répertoire système ou utilisateur + reload : recharger une extension (si pas de nom donné, décharger toutes les extensions, puis recharger automatiquement les extensions) + unload : décharger une extension (si pas de nom donné, décharger toutes les extensions) + fichier : extension (fichier) à charger + nom : nom d'extension +paramètres : paramètres donnés à l'extension lors de son chargement + +Sans paramètre, cette commande liste les extensions chargées. +---- + +[[command_weechat_print]] +* `+print+`: afficher du texte dans un tampon + +---- +/print [-buffer <numéro>|<nom>] [-core] [-escape] [-date <date>] [-tags <étiquettes>] [-action|-error|-join|-network|-quit] [<texte>] + -stdout|-stderr [<texte>] + -beep + + -buffer : afficher le texte dans ce tampon (par défaut : tampon où est exécutée la commande) + -core : alias de "-buffer core.weechat" +-current : afficher le texte dans le tampon courant + -escape : interpréter les caractères échappés (par exemple \a, \07, \x07) + -date : date du message, le format peut être : + -n : 'n' secondes avant maintenant + +n : 'n' secondes dans le futur + n : 'n' secondes depuis l'époque (voir man time) + date/heure (ISO 8601) : yyyy-mm-ddThh:mm:ss, exemple : 2014-01-19T04:32:55 + heure : hh:mm:ss (exemple : 04:32:55) + -tags : liste d'étiquettes séparées par des virgules (voir /help filter pour une liste des étiquettes couramment utilisées) + texte : texte à afficher (le préfixe et le message doivent être séparés par "\t", si le texte commence par "-", ajoutez "\" avant) + -stdout : afficher le texte sur stdout (les caractères échappés sont interprétés) + -stderr : afficher le texte sur stderr (les caractères échappés sont interprétés) + -beep : alias de "-stderr \a" + +Les options -action ... -quit utilisent le préfixe défini dans les options "weechat.look.prefix_*". + +Les caractères échappés suivants sont supportés : + \" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh + +Exemples : + afficher un pense-bête sur le tampon core avec un highlight : + /print -core -tags notify_highlight Pense-bête : acheter du lait + afficher une erreur sur le tampon core : + /print -core -error Une erreur ici + afficher un message sur le tampon core avec le préfixe "abc" : + /print -core abc\tLe message + afficher un message sur le canal #weechat : + /print -buffer irc.freenode.#weechat Message sur #weechat + afficher un bonhomme de neige (U+2603) : + /print -escape \u2603 + envoyer une alerte (BEL) : + /print -beep +---- + +[[command_weechat_proxy]] +* `+proxy+`: gestion des proxies + +---- +/proxy list + add <nom> <type> <adresse> <port> [<utilisateur> [<mot_de_passe>]] + del <nom>|-all + set <nom> <option> <valeur> + + list : lister tous les proxies + add : ajouter un nouveau proxy + nom : nom du proxy (doit être unique) + type : http, socks4 ou socks5 + adresse : IP ou nom de machine + port : port + utilisateur : nom d'utilisateur (optionnel) +mot_de_passe : mot de passe (optionnel) + del : supprimer un proxy (ou tous les proxies avec -all) + set : changer la valeur d'une propriété d'un proxy + option : option à modifier (pour la liste des options, voir /set weechat.proxy.<proxyname>.*) + valeur : nouvelle valeur pour l'option + +Exemples : + ajouter un proxy http, tournant en local, port 8888 : + /proxy add local http 127.0.0.1 8888 + ajouter un proxy http en utilisant le protocole IPv6 : + /proxy add local http ::1 8888 + /proxy set local ipv6 on + ajouter un proxy socks5 avec un utilisateur/mot de passe : + /proxy add myproxy socks5 sample.host.org 3128 myuser mypass + supprimer un proxy : + /proxy del myproxy +---- + +[[command_weechat_quit]] +* `+quit+`: quitter WeeChat + +---- +/quit [-yes] [<paramètres>] + + -yes : requis si l'option "weechat.look.confirm_quit" est activée +paramètres : texte envoyé avec le signal "quit" + (par exemple l'extension irc utilise ce texte pour envoyer le message de quit au serveur) + +Par défaut en quittant les fichiers de configuration sont sauvegardés (voir l'option "weechat.look.save_config_on_exit") et la disposition courante peut être sauvegardée (voir l'option "weechat.look.save_layout_on_exit"). +---- + +[[command_weechat_reload]] +* `+reload+`: recharger les fichiers de configuration depuis le disque + +---- +/reload [<fichier> [<fichier>...]] + +fichier : fichier de configuration à recharger (sans l'extension ".conf") + +Sans paramètre, tous les fichiers (WeeChat et extensions) sont rechargés. +---- + +[[command_weechat_repeat]] +* `+repeat+`: exécuter une commande plusieurs fois + +---- +/repeat [-interval <délai>] <nombre> <commande> + + délai : délai entre l'exécution des commandes (en millisecondes) + nombre : nombre de fois que la commande sera exécutée +commande : commande à exécuter (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande) + +Toutes les commandes sont exécutées sur le tampon où la commande a été lancée. + +Exemple : + faire défiler de 2 pages vers le haut : + /repeat 2 /window page_up +---- + +[[command_weechat_save]] +* `+save+`: sauvegarder les fichiers de configuration sur disque + +---- +/save [<fichier> [<fichier>...]] + +fichier : fichier de configuration à sauvegarder (sans l'extension ".conf") + +Sans paramètre, tous les fichiers (WeeChat et extensions) sont sauvegardés. + +Par défaut tous les fichiers de configuration sont sauvegardés sur disque sur la commande /quit (voir l'option "weechat.look.save_config_on_exit"). +---- + +[[command_weechat_secure]] +* `+secure+`: gestion des données sécurisées (mots de passe ou données privées chiffrés dans le fichier sec.conf) + +---- +/secure passphrase <phrase de chiffrement>|-delete + decrypt <phrase de chiffrement>|-discard + set <nom> <valeur> + del <nom> + +passphrase : modifier la phrase de chiffrement (sans phrase de chiffrement, les données sont stockées en texte brut dans le fichier sec.conf) + -delete : supprimer la phrase de chiffrement + decrypt : déchiffrer les données toujours chiffrées + -discard : jeter toutes les données encore chiffrées + set : ajouter ou modifier une donnée sécurisée + del : supprimer une donnée sécurisée + +Sans paramètre, cette commande affiche les données sécurisées dans un nouveau tampon. + +Lorsqu'une phrase de chiffrement est utilisée (données chiffrées), elle est demandée au démarrage de WeeChat. +Il est possible de définir la variable d'environnement WEECHAT_PASSPHRASE pour éviter la demande (cette même variable est utilisée par WeeChat sur le /upgrade). + +Les données sécurisées avec le format ${sec.data.xxx} peuvent être utilisées dans : + - la commande /eval + - le paramètre de ligne de commande "--run-command" + - les options weechat.startup.command_{before|after}_plugins + - d'autres options qui peuvent contenir un mot de passe ou des données sensibles (par exemple proxy, serveur irc et relay) ; voir /help sur les options pour vérifier si elles sont évaluées. + +Exemples : + définir une phrase de chiffrement : + /secure passphrase ceci est ma phrase de chiffrement + chiffrer le mot de passe freenode SASL : + /secure set freenode motdepasse + /set irc.server.freenode.sasl_password "${sec.data.freenode}" + chiffrer le mot de passe oftc pour nickserv : + /secure set oftc motdepasse + /set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}" + alias pour ghost du pseudo "pseudo" : + /alias add ghost /eval /msg -server freenode nickserv ghost pseudo ${sec.data.freenode} +---- + +[[command_weechat_set]] +* `+set+`: définir des options de configuration et des variables d'environnement + +---- +/set [<option> [<valeur>]] + diff [<option> [<option>...]] + env [<variable> [<valeur>]] + +option : nom d'une option (le caractère joker "*" est autorisé) +valeur : nouvelle valeur pour l'option, selon le type : + booléen : on, off ou toggle + entier : nombre, ++nombre ou --nombre + chaîne : toute chaîne ("" pour une chaîne vide) + couleur : nom de couleur, ++nombre ou --nombre + Note : pour tous les types, vous pouvez utiliser null pour supprimer la valeur de l'option (valeur non définie). Cela ne fonctionne qu'avec certaines options spéciales des extensions. + diff : afficher seulement les options modifiées + env : afficher ou définir une variable d'environnement (utilisez la valeur "" pour supprimer une variable) + +Exemples : + afficher les options à propos du highlight : + /set *highlight* + ajouter un mot pour le highlight : + /set weechat.look.highlight "mot" + afficher les options modifiées : + /set diff + afficher les options modifiées dans l'extension irc : + /set diff irc.* + afficher la valeur de la variable d'environnement LANG : + /set env LANG + modifier la variable d'environnement LANG et l'utiliser : + /set env LANG fr_FR.UTF-8 + /upgrade + réinitialiser la variable d'environnement ABC : + /set env ABC "" +---- + +[[command_weechat_unset]] +* `+unset+`: supprimer/réinitialiser des options de configuration + +---- +/unset <option> + -mask <option> + +option : nom d'une option + -mask : utiliser un masque pour l'option (le caractère joker "*" est autorisé pour réinitialiser plusieurs options, à utiliser avec prudence !) + +Selon l'option, elle est réinitialisée (pour les options standards) ou supprimée (pour les options facultatives, comme les valeurs pour les serveurs). + +Exemples : + réinitialiser une option : + /unset weechat.look.item_time_format + réinitialiser toutes les options de couleur : + /unset -mask weechat.color.* +---- + +[[command_weechat_upgrade]] +* `+upgrade+`: mettre à jour WeeChat sans se déconnecter des serveurs + +---- +/upgrade [-yes] [<chemin_vers_binaire>|-quit] + + -yes : requis si l'option "weechat.look.confirm_upgrade" est activée +chemin_vers_binaire : chemin vers le binaire WeeChat (par défaut le binaire courant) + -dummy : ne rien faire (option utilisée pour éviter une complétion accidentelle avec "-quit") + -quit : fermer *TOUTES* les connexions, sauver la session et quitter, ce qui rend possible une restauration différée (voir ci-dessous) + +Cette commande met à jour et recharge une session de WeeChat qui tourne. Le nouveau binaire WeeChat doit avoir été compilé ou installé via un gestionnaire de paquet avant de lancer cette commande. + +Note : les connexions SSL sont perdues durant la mise à jour, car le rechargement de session SSL n'est pas possible actuellement avec GnuTLS. Il y a une reconnexion automatique après la mise à jour. + +Le processus de mise à jour comporte 4 étapes : + 1. sauvegarder la session pour le cœur et les extensions (tampons, historique, ...) + 2. décharger toutes les extensions (les fichiers de configuration (*.conf) sont écrits sur disque) + 3. sauvegarder la configuration WeeChat (weechat.conf) + 4. exécuter le nouveau binaire WeeChat et recharger la session. + +Avec l'option "-quit", le processus est légèrement différent : + 1. fermer *TOUTES* les connexions + 2. sauvegarder la session (fichiers *.upgrade) + 3. décharger les extensions + 4. sauvegarder la configuration WeeChat + 5. quitter WeeChat +Et plus tard vous pouvez restaurer la session avec la commande : weechat --upgrade +IMPORTANT : vous devez restaurer la session avec exactement la même configuration (fichiers *.conf). +Il est également possible de restaurer la session WeeChat sur une autre machine si vous y copiez le contenu du répertoire "~/.weechat". +---- + +[[command_weechat_uptime]] +* `+uptime+`: montrer l'uptime de WeeChat + +---- +/uptime [-o | -ol] + + -o : envoyer l'uptime sur le tampon courant comme entrée (chaîne en anglais) +-ol : envoyer l'uptime sur le tampon courant comme entrée (chaîne traduite) +---- + +[[command_weechat_version]] +* `+version+`: afficher la version de WeeChat et la date de compilation + +---- +/version [-o | -ol] + + -o : envoyer la version sur le tampon courant comme entrée (chaîne en anglais) +-ol : envoyer la version sur le tampon courant comme entrée (chaîne traduite) + +L'alias par défaut /v peut être utilisé pour exécuter cette commande sur tous les tampons (sinon la commande irc /version est utilisée sur les tampons irc). +---- + +[[command_weechat_wait]] +* `+wait+`: planifier l'exécution d'une commande dans le futur + +---- +/wait <nombre>[<unité>] <commande> + + nombre : temps à attendre (nombre entier) + unité : optionnelle, valeurs possibles : + ms : millisecondes + s : secondes (par défaut) + m : minutes + h : heures +commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/') + +Note : la commande est exécutée sur le tampon où /wait a été exécuté (si le tampon n'est pas trouvé, alors la commande est exécutée sur le tampon WeeChat principal). + +Exemples : + rejoindre le canal dans 10 secondes : + /wait 10 /join #test + passer absent dans 15 minutes : + /wait 15m /away -all I'm away + dire 'bonjour' dans 2 minutes : + /wait 2m bonjour +---- + +[[command_weechat_window]] +* `+window+`: gestion des fenêtres + +---- +/window list + -1|+1|b#|up|down|left|right [-window <numéro>] + <numéro> + splith|splitv [-window <numéro>] [<pct>] + resize [-window <numéro>] [+/-]<pct> + balance + merge [-window <numéro>] [all] + page_up|page_down [-window <numéro>] + refresh + scroll [-window <numéro>] [+/-]<valeur>[s|m|h|d|M|y] + scroll_horiz [-window <numéro>] [+/-]<valeur>[%] + scroll_up|scroll_down|scroll_top|scroll_bottom|scroll_beyond_end|scroll_previous_highlight|scroll_next_highlight|scroll_unread [-window <numéro>] + swap [-window <numéro>] [up|down|left|right] + zoom [-window <numéro>] + bare [<délai>] + + list : lister les fenêtres ouvertes (sans paramètre, cette liste est affichée) + -1 : sauter à la fenêtre précédente + +1 : sauter à la fenêtre suivante + b# : sauter à la fenêtre affichant le tampon # + up : sauter à la fenêtre au dessus + down : sauter à la fenêtre au dessous + left : sauter à la fenêtre à gauche + right : sauter à la fenêtre à droite + numéro : numéro de fenêtre (voir /window list) + splith : éclater la fenêtre en deux horizontalement + splitv : éclater la fenêtre en deux verticalement + resize : redimensionner une fenêtre, la nouvelle taille est <pct> pourcentage de la fenêtre parent + balance : équilibrer la taille de toutes les fenêtres + merge : fusionner la fenêtre avec une autre + page_up : faire défiler d'une page vers le haut + page_down : faire défiler d'une page vers le bas + refresh : redessiner l'écran + scroll : faire défiler d'un nombre de lignes (+/-N) ou avec du temps : s=secondes, m=minutes, h=heures, d=jours, M=mois, y=année + scroll_horiz : faire défiler horizontalement d'un nombre de colonnes (+/-N) ou un pourcentage de la taille de fenêtre (ce défilement est possible seulement sur les tampons avec contenu libre) + scroll_up : faire défiler de quelques lignes vers le haut + scroll_down : faire défiler de quelques lignes vers le bas + scroll_top : faire défiler jusqu'au début du tampon +scroll_bottom : faire défiler jusqu'en bas du tampon +scroll_beyond_end : faire défiler au-delà de la fin du tampon +scroll_previous_highlight : faire défiler jusqu'au highlight précédent +scroll_next_highlight : faire défiler jusqu'au highlight suivant +scroll_unread : faire défiler jusqu'au marqueur de données non lues + swap : échanger les tampons de deux fenêtres (avec une direction facultative pour la fenêtre cible) + zoom : zoomer sur la fenêtre + bare : activer/désactiver le mode d'affichage dépouillé (avec un délai facultatif en secondes pour un retour automatique au mode d'affichage standard) + +Pour splith et splitv, pct est un pourcentage qui représente la taille de la nouvelle fenêtre, calculée par rapport à la taille de la fenêtre courante. Par exemple 25 signifie créer une fenêtre qui a pour taille : taille_courante / 4 + +Exemples : + sauter à la fenêtre affichant le tampon 1 : + /window b1 + défilement de 2 lignes vers le haut : + /window scroll -2 + défilement de 2 jours vers le haut : + /window scroll -2d + défilement jusqu'au début du jour courant : + /window scroll -d + zoom sur la fenêtre numéro 2 : + /window zoom -window 2 + activer le mode d'affichage dépouillé pendant 2 secondes : + /window bare 2 +---- |