diff options
| author | Sébastien Helleu <flashcode@flashtux.org> | 2023-03-29 22:38:01 +0200 |
|---|---|---|
| committer | Sébastien Helleu <flashcode@flashtux.org> | 2023-03-30 01:34:55 +0200 |
| commit | 6dbfb638c6586905b3b29df9cf1e41d9166546ef (patch) | |
| tree | c2604c334bfea2d5aa59ac3dea6a73f812e674ce /doc/fr/includes/autogen_user_commands.fr.adoc | |
| parent | 4548b25b78d0ba8fc61421bda88a5a79b09ff9af (diff) | |
| download | weechat-6dbfb638c6586905b3b29df9cf1e41d9166546ef.zip | |
doc: convert docgen.py to C, remove autogen files from repository, add parameter `--doc-gen`
Changes:
- build of doc now requires weechat-headless, translations and all plugins
- convert docgen.py to C
- remove `autogen_*` files from repository
- add command line parameter `--doc-gen` in `weechat-headless` to build
autogen files
- build .mo files with directories like the installed ones
(eg: "<lang>/LC_MESSAGES/weechat.mo")
- remove javascript chapter from user's guide
Diffstat (limited to 'doc/fr/includes/autogen_user_commands.fr.adoc')
| -rw-r--r-- | doc/fr/includes/autogen_user_commands.fr.adoc | 3308 |
1 files changed, 0 insertions, 3308 deletions
diff --git a/doc/fr/includes/autogen_user_commands.fr.adoc b/doc/fr/includes/autogen_user_commands.fr.adoc deleted file mode 100644 index 5040b8897..000000000 --- a/doc/fr/includes/autogen_user_commands.fr.adoc +++ /dev/null @@ -1,3308 +0,0 @@ -// -// This file is auto-generated by script docgen.py. -// DO NOT EDIT BY HAND! -// - -// tag::alias_commands[] -[[command_alias_alias]] -* `+alias+`: lister, ajouter ou retirer des alias de commande - ----- -/alias list [<alias>] - add <alias> [<commande>[;<commande>...]] - addcompletion <complétion> <alias> [<commande>[;<commande>...]] - del <alias> [<alias>...] - rename <alias> <nouvel_alias> - - list : afficher les alias (sans paramètre, cette liste est affichée) - add : ajouter un alias -addcompletion : ajouter un alias avec une complétion personnalisée - del : supprimer un alias - rename : renommer un alias - complétion : complétion pour l'alias : par défaut la complétion se fait avec la commande cible - note : vous pouvez utiliser %%commande pour utiliser la complétion d'une commande existante - alias : nom de l'alias - commande : nom de la commande avec les paramètres (plusieurs commandes peuvent être séparées par des points-virgules) - -Note : dans la commande, les variables spéciales sont remplacées : - $n : paramètre 'n' (entre 1 et 9) - $-m : paramètres de 1 à 'm' - $n- : paramètres de 'n' au dernier - $n-m : paramètres de 'n' à 'm' - $* : tous les paramètres - $~ : le dernier paramètre - $var : où "var" est une variable locale du tampon (voir /buffer listvar) - exemples : $nick, $channel, $server, $plugin, $name - -Exemples : - alias /split pour diviser la fenêtre horizontalement : - /alias add split /window splith - alias /hello pour dire "hello" sur tous les canaux mais pas sur #weechat : - /alias add hello /allchan -exclude=#weechat hello - renommer l'alias "hello" en "Hello" : - /alias rename hello Hello - alias /forcejoin pour envoyer la commande IRC "forcejoin" avec la complétion de /sajoin : - /alias addcompletion %%sajoin forcejoin /quote forcejoin ----- -// end::alias_commands[] - -// tag::buflist_commands[] -[[command_buflist_buflist]] -* `+buflist+`: objet de barre avec la liste des tampons - ----- -/buflist enable|disable|toggle - bar - refresh - - enable : activer buflist -disable : désactiver buflist - toggle : activer/désactiver buflist - bar : ajouter la barre "buflist" -refresh : forcer le rafraichissement des objets de barre (buflist, buflist2 et buflist3) - -Les lignes avec les tampons sont affichées en utilisant l'évaluation de chaînes (voir /help eval pour le format), avec ces options : - - buflist.look.display_conditions : conditions pour afficher un tampon dans la liste - - buflist.format.buffer : format pour un tampon qui n'est pas le tampon courant - - buflist.format.buffer_current: format pour le tampon courant - -Les variables suivantes peuvent être utilisées dans ces options : - - données de l'objet de barre (voir le hdata "bar_item" dans la doc API pour une liste complète), par exemple : - - ${bar_item.name} - - données de la fenêtre ("window"), où l'objet de barre est affiché (il n'y a pas de fenêtre pour les barres de type "root", voir le hdata "window" dans la doc API pour une liste complète), par exemple : - - ${window.number} - - ${window.buffer.full_name} - - données du tampon (voir le hdata "buffer" dans la doc API pour une liste complète), par exemple : - - ${buffer.number} - - ${buffer.name} - - ${buffer.full_name} - - ${buffer.short_name} - - ${buffer.nicklist_nicks_count} - - irc_server: données du serveur IRC, défini seulement sur un tampon IRC (voir le hdata "irc_server" dans la doc API) - - irc_channel: données du canal IRC, défini seulement sur un tampon de canal IRC (voir le hdata "irc_channel" dans la doc API) - - variables additionnelles ajoutées par buflist pour des raisons pratiques : - - ${format_buffer} : la valeur évaluée de l'option buflist.format.buffer ; peut être utilisée dans l'option buflist.format.buffer_current pour juste changer la couleur de fond par exemple - - ${current_buffer} : un booléen ("0" ou "1"), "1" s'il s'agit du tampon courant ; cela peut être utilisé dans une condition : ${if:${current_buffer}?...:...} - - ${merged} : un booléen ("0" ou "1"), "1" si le tampon est mélangé avec au moins un autre tampon ; cela peut être utilisé dans une condition : ${if:${merged}?...:...} - - ${format_number} : numéro indenté avec un séparateur (évaluation de l'option buflist.format.number) - - ${number} : numéro indenté, par exemple " 1" s'il y a entre 10 et 99 tampons ; pour les tampons mélangés, cette variable est définie avec le numéro pour le premier tampon et des espaces pour les tampons suivants avec le même numéro - - ${number2} : numéro indenté, par exemple " 1" s'il y a entre 10 et 99 tampons - - ${number_displayed} : "1" si le numéro est affiché, sinon "0" - - ${indent} : indentation pour le nom (les tampons de canaux ou privés sont indentés) (évaluation de l'option buflist.format.indent) - - ${format_nick_prefix} : le préfixe du pseudo en couleur pour un canal (évaluation de l'option buflist.format.nick_prefix) - - ${color_nick_prefix} : la couleur du préfixe du pseudo pour un canal (défini seulement si l'option buflist.look.nick_prefix est activée) - - ${nick_prefix} : le préfixe du pseudo pour un canal (défini seulement si l'option buflist.look.nick_prefix est activée) - - ${format_name} : le nom formaté (évaluation de l'option buflist.format.name) - - ${name} : le nom court (si défini), sinon le nom - - ${color_hotlist} : la couleur qui dépend du niveau de hotlist le plus élevé pour le tampon (évaluation de l'option buflist.format.hotlist_xxx où xxx est le niveau) - - ${format_hotlist} : la hotlist formatée (évaluation de l'option buflist.format.hotlist) - - ${hotlist} : la hotlist brute - - ${hotlist_priority} : "none", "low", "message", "private" ou "highlight" - - ${hotlist_priority_number} : -1 = none, 0 = low, 1 = message, 2 = private, 3 = highlight - - ${format_lag} : le lag pour un tampon de serveur IRC, vide s'il n'y a pas de lag (évaluation de l'option buflist.format.lag) - - ${format_tls_version}: indicateur de la version de TLS pour le serveur courant, vide pour les canaux (évaluation de l'option buflist.format.tls_version) ----- -// end::buflist_commands[] - -// tag::charset_commands[] -[[command_charset_charset]] -* `+charset+`: changer le charset pour le tampon courant - ----- -/charset decode|encode <charset> - reset - - decode : changer le charset de décodage - encode : changer le charset d'encodage -charset : nouveau charset pour le tampon courant - reset : réinitialiser les charsets pour le tampon courant ----- -// end::charset_commands[] - -// tag::exec_commands[] -[[command_exec_exec]] -* `+exec+`: exécuter des commandes externes - ----- -/exec -list - [-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <nom>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] |-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <délai>] [-name <nom>] [-pipe <commande>] [-hsignal <nom>] <commande> - -in <id> <texte> - -inclose <id> [<texte>] - -signal <id> <signal> - -kill <id> - -killall - -set <id> <propriété> <valeur> - -del <id>|-all [<id>...] - - -list : lister les commandes - -sh : utiliser le shell pour exécuter la commande, plusieurs commandes peuvent être enchaînées avec des pipes (ATTENTION : utilisez cette option SEULEMENT si tous les paramètres sont fiables, voir l'option -nosh) - -nosh : ne pas utiliser le shell pour exécuter la commande (requis si la commande a des données non fiables, par exemple le contenu d'un message d'un autre utilisateur) (par défaut) - -bg : lancer le processus en tâche de fond : ne pas afficher la sortie ni le code retour (non compatible avec les options -o/-oc/-n/-nf/-pipe/-hsignal) - -nobg : capturer la sortie du processus et afficher le code retour (par défaut) - -stdin : créer un tuyau pour envoyer des données sur l'entrée standard du processus (avec /exec -in/-inclose) - -nostdin : ne pas créer de tuyau pour l'entrée standard (par défaut) - -buffer : afficher/envoyer la sortie de la commande sur ce tampon (si le tampon n'est pas trouvé, un nouveau tampon avec le nom "exec.exec.xxx" est créé) - -l : afficher localement la sortie de la commande sur le tampon (par défaut) - -o : envoyer la sortie de la commande au tampon sans exécuter les commandes (non compatible avec les options -bg/-pipe/-hsignal) - -oc : envoyer la sortie de la commande au tampon et exécuter les commandes (lignes commençant par "/" ou un caractère personnalisé de commande) (non compatible avec les options -bg/-pipe/-hsignal) - -n : afficher la sortie de la commande dans un nouveau tampon (non compatible avec les options -bg/-pipe/-hsignal) - -nf : afficher la sortie de la commande dans un nouveau tampon avec contenu libre (pas de coupure des mots, pas de limite sur le nombre de lignes) (non compatible avec les options -bg/-pipe/-hsignal) - -oerr : envoyer aussi stderr (sortie d'erreur) au tampon (peut être utilisé seulement avec les options -o et -oc) - -cl : effacer le nouveau tampon avant d'afficher la sortie - -nocl : ajouter au nouveau tampon sans effacer (par défaut) - -sw : basculer vers le tampon de sortie (par défaut) - -nosw : ne pas basculer vers le tampon de sortie - -ln : afficher les numéros de ligne (par défaut dans un nouveau tampon seulement) - -noln : ne pas afficher les numéros de ligne - -flush : afficher la sortie de la commande en temps réel (par défaut) - -noflush : afficher la sortie de la commande une fois qu'elle est terminée - -color : action sur les couleurs ANSI dans la sortie : - ansi : garder les codes ANSI tels quels - auto : convertir les couleurs ANSI en couleurs WeeChat/IRC (par défaut) - irc : convertir les couleurs ANSI en couleurs IRC - weechat : convertir les couleurs ANSI en couleurs WeeChat - strip : supprimer les couleurs ANSI - -rc : afficher le code retour (par défaut) - -norc : ne pas afficher le code retour - -timeout : définir un délai maximum pour la commande (en secondes) - -name : définir un nom pour la commande (pour la nommer plus tard avec /exec) - -pipe : envoyer la sortie vers une commande WeeChat/extension (ligne par ligne) ; s'il y a des espaces dans la commande/paramètres, entourez les de guillemets ; la variable $line est remplacée par la ligne (par défaut la ligne est ajoutée après la commande, séparée par un espace) (non compatible avec les options -bg/-o/-oc/-n/-nf) - -hsignal : envoyer la sortie sous forme de hsignal (pour être utilisé par exemple dans un trigger) (non compatible avec les options -bg/-o/-oc/-n/-nf) - commande : la commande à exécuter ; si elle commence par "url:", le shell est désactivé et le contenu de l'URL est téléchargé et envoyé comme sortie - id : identifiant de commande : soit le numéro ou le nom (si défini avec "-name xxx") - -in : envoyer le texte sur l'entrée standard du processus - -inclose : identique à -in, mais l'entrée standard est fermée après (et le texte est facultatif : sans texte, l'entrée standard est juste fermée) - -signal : envoyer un signal au processus ; le signal peut être un entier ou l'un de ces noms : hup, int, quit, kill, term, usr1, usr2 - -kill : alias de "-signal <id> kill" - -killall : tuer tous les processus - -set : définir une propriété du hook (voir la fonction hook_set dans l'API de référence extension) -propriété : propriété du hook - valeur : nouvelle valeur pour la propriété du hook - -del : supprimer la commande terminée - -all : supprimer toutes les commandes terminées - -Les options par défaut peuvent être définies dans l'option exec.command.default_options. - -Exemples : - /exec -n ls -l /tmp - /exec -sh -n ps xu | grep weechat - /exec -n -norc url:https://pastebin.com/raw.php?i=xxxxxxxx - /exec -nf -noln links -dump https://weechat.org/files/doc/devel/weechat_user.en.html - /exec -o uptime - /exec -pipe "/print Durée de fonctionnement de la machine :" uptime - /exec -n tail -f /var/log/messages - /exec -kill 0 ----- -// end::exec_commands[] - -// tag::fifo_commands[] -[[command_fifo_fifo]] -* `+fifo+`: configuration de l'extension fifo - ----- -/fifo enable|disable|toggle - - enable : activer le tube FIFO -disable : désactiver le tube FIFO - toggle : activer/désactiver le tube FIFO - -Le tube FIFO est utilisé comme contrôle à distance de WeeChat : vous pouvez envoyer des commandes ou du texte au tube FIFO depuis votre shell. -Par défaut le tube FIFO se nomme weechat_fifo_xxx (où xxx est l'id du processus WeeChat) et situé dans le répertoire "runtime" de WeeChat (voir /debug dirs). - -Le format attendu est l'un des suivants : - plugin.buffer *texte ou commande ici - *texte ou commande ici - -Par exemple pour changer votre pseudo sur libera : - echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345 - -Merci de lire le guide utilisateur pour plus d'information et des exemples. - -Exemples : - /fifo toggle ----- -// end::fifo_commands[] - -// tag::fset_commands[] -[[command_fset_fset]] -* `+fset+`: définir rapidement des options WeeChat et des extensions - ----- -/fset -bar - -refresh - -up|-down [<nombre>] - -left|-right [<pourcentage>] - -go <ligne>|end - -toggle - -add [<valeur>] - -reset - -unset - -set - -setnew - -append - -mark - -format - -export [-help|-nohelp] <fichier> - <filtre> - - -bar : ajouter la barre d'aide - -refresh : rafraîchir la liste des options, puis l'écran entier (commande : /window refresh) - -up : déplacer la ligne sélectionnée de "nombre" lignes vers le haut - -down : déplacer la ligne sélectionnée de "nombre" lignes vers le bas - -left : faire défier le tampon fset de "pourcentage" de largeur vers la gauche - -right : faire défier le tampon fset de "pourcentage" de largeur vers la droite - -go : sélectionner une ligne par numéro, la première ligne est 0 ("end" pour sélectionner la dernière ligne) - -toggle : basculer la valeur booléenne - -add : ajouter "valeur" (qui peut être un nombre négatif) pour les entiers et couleurs, définir/ajouter à la valeur pour les autres types (définir pour une valeur négative, ajouter pour un nombre positif) - -reset : réinitialiser la valeur de l'option - -unset : supprimer/réinitialiser l'option - -set : ajouter la commande /set dans l'entrée pour éditer la valeur de l'option (déplacer le curseur au début de la valeur) - -setnew : ajouter la commande /set dans l'entrée pour éditer une nouvelle valeur pour l'option - -append : ajouter la commande /set pour ajouter quelque chose dans la valeur de l'option (déplacer le curseur à la fin de la valeur) - -mark : marquer/démarquer - -format : basculer vers le prochain format disponible - -export : exporter les options et valeurs affichées dans un fichier (chaque ligne a le format : "/set nom valeur" ou "/unset nom") - -help : forcer l'écriture de l'aide sur les options dans le fichier exporté (voir /help fset.look.export_help_default) - -nohelp : ne pas écrire l'aide sur les options dans le fichier exporté (voir /help fset.look.export_help_default) - filtre : définir un nouveau filtre pour voir seulement les options correspondantes (ce filtre peut aussi être utilisé en entrée du tampon fset) ; les formats autorisés sont : - * afficher toutes les options (pas de filtre) - xxx afficher seulement les options avec "xxx" dans le nom - f:xxx afficher seulement le fichier de configuration "xxx" - t:xxx afficher seulement le type "xxx" (bool/int/str/col) - d afficher seulement les options changées - d:xxx afficher seulement les options changées avec "xxx" dans le nom - d=xxx afficher seulement les options changées avec "xxx" dans la valeur - d==xxx afficher seulement les options changées avec la valeur exacte "xxx" - h=xxx afficher seulement les options avec "xxx" dans la description (traduite) - he=xxx afficher seulement les options avec "xxx" dans la description (en Anglais) - =xxx afficher seulement les options avec "xxx" dans la valeur - ==xxx afficher seulement les options avec la valeur exacte "xxx" - c:xxx afficher seulement les options qui correspondent à la condition évaluée "xxx", en utilisant les variables suivantes : file, section, option, name, parent_name, type, type_en, type_short (bool/int/str/col), type_tiny (b/i/s/c), default_value, default_value_undef, value, quoted_value, value_undef, value_changed, parent_value, min, max, description, description2, description_en, description_en2, string_values - -Les lignes avec des options sont affichées en utilisant l'évaluation de chaîne (voir /help eval pour le format), avec ces options : - - fset.format.option1 : premier format pour une option - - fset.format.option2 : second format pour une option - -Les variables suivantes peuvent être utilisées dans ces options : - - données de l'option, avec couleur et alignées avec des espaces sur la droite : - - ${file} : fichier de configuration (par exemple "weechat" ou "irc") - - ${section} : section - - ${option} : nom de l'option - - ${name} : nom complet de l'option (fichier.section.option) - - ${parent_name} : nom de l'option parente - - ${type} : type de l'option (traduit) - - ${type_en} : type de l'option (en Anglais) - - ${type_short} : type court de l'option (bool/int/str/col) - - ${type_tiny} : type très court de l'option (b/i/s/c) - - ${default_value} : valeur par défaut de l'option - - ${default_value_undef} : "1" si la valeur par défaut est null, sinon "0" - - ${value} : valeur de l'option - - ${value_undef} : "1" si la valer est null, sinon "0" - - ${value_changed} : "1" si la valeur est différente de la valeur par défaut, sinon "0" - - ${value2} : valeur de l'option, avec la valeur héritée si null - - ${parent_value} : valeur de l'option parente - - ${min} : valeur minimale - - ${max} : valeur maximale - - ${description} : description de l'option (traduite) - - ${description2} : description de l'option (traduite), "(pas de description)" s'il n'y a pas de description - - ${description_en} : description de l'option (en Anglais) - - ${description_en2} : description de l'option (en Anglais), "(no description)" s'il n'y a pas de description - - ${string_values} : valeurs chaîne autorisées pour définir une option de type entier utilisant des chaînes - - ${marked} : "1" si l'option est marquée, sinon "0" - - ${index} : index de l'option dans la liste - - données de l'option, avec couleur mais sans espaces : - - mêmes noms préfixés par un underscore, par exemple : ${_name}, ${_type}, ... - - données de l'option, format brut (par de couleurs/espaces) : - - mêmes noms préfixés par deux underscores, par exemple : ${__name}, ${__type}, ... - - données de l'option, seulement des espaces : - - mêmes noms préfixés par "empty_", par exemple : ${empty_name}, ${empty_type} - - autres données : - - ${selected_line} : "1" si la ligne est sélectionnée, sinon "0" - - ${newline} : insérer une nouvelle ligne à cet endroit, pour afficher l'option sur plusieurs lignes - -Touches et entrées pour le déplacement dans le tampon fset : - haut se déplacer d'une ligne vers le haut - bas se déplacer d'une ligne vers le bas - pgup se déplacer d'une page vers le haut - pgdn se déplacer d'une page vers le bas - alt-home << se déplacer à la première ligne - alt-end >> se déplacer à la dernière ligne - F11 < faire défiler horizontalement vers la gauche - F12 > faire défiler horizontalement vers la droite - -Touches et entrées pour définir les options sur le tampon fset : - alt+espace t basculer la valeur booléenne - alt+'-' - soustraire 1 de la valeur pour un entier/couleur, définir la valeur pour les autres types - alt+'+' + ajouter 1 à la valeur pour un entier/couleur, ajouter à la valeur pour les autres types - alt+f, alt+r r réinitialiser la valeur - alt+f, alt+u u supprimer/réinitialiser la valeur - alt+entrée s définir la valeur - alt+f, alt+n n définir une nouvelle valeur - alt+f, alt+a a ajouter à la valeur - alt+',' , marquer/démarquer l'option - shift+haut se déplacer d'une ligne vers le haut et marquer/démarquer l'option - shift+bas marquer/démarquer l'option et se déplacer d'une ligne vers le bas - m:xxx marquer les options affichées qui correspondent au filtre "xxx" (tout filtre sur une option ou valeur est autorisé, voir les filtres ci-dessus) - u:xxx démarquer les options affichées qui correspondent au filtre "xxx" (tout filtre sur une option ou valeur est autorisé, voir les filtres ci-dessus) - -Autres touches et entrées sur le tampon fset : - ctrl+l rafraîchir les options et l'écran entier (commande : /fset -refresh) - $ rafraîchir les options (garder les options marquées) - $$ rafraîchir les options (démarquer toutes les options) - alt+p p activer/désactiver la description des options d'extensions (plugins.desc.*) - alt+v v activer/désactiver la barre d'aide - s:x,y trier les options par les champs x,y (voir /help fset.look.sort) - s: réinitialiser le tri à sa valeur par défaut (voir /help fset.look.sort) - w:xxx exporter les options dans le fichier "xxx" - w-:xxx exporter les options dans le fichier "xxx" sans aide - w+:xxx exporter les options dans le fichier "xxx" avec aide - ctrl+x x basculer le format utilisé pour afficher les options - q fermer le tampon fset - -Actions de la souris sur le tampon fset : - roulette haut/bas se déplacer vers le haut/bas - bouton gauche se déplacer à cette ligne - bouton droit basculer le booléen (on/off) ou éditer la valeur de l'option - bouton droit + glisser gauche/droite incrémenter/décrémenter la valeur pour un entier/couleur, définir/ajouter à la valeur pour les autres types - bouton droit + glisser haut/bas marquer/démarquer plusieurs options - -Note : si l'entrée comporte un ou plusieurs espaces en tête, le texte suivant est interprété comme un filtre, sans les espaces. Par exemple " q" cherche toutes les options avec "q" dans le nom, tandis que "q" ferme le tampon fset. - -Exemples : - afficher les options IRC changées : - /fset d:irc.* - afficher les options avec "nicklist" dans le nom : - /fset nicklist - afficher les valeurs qui contiennent "red" : - /fset =red - afficher les valeurs qui sont exactement "red" : - /fset ==red - afficher toutes les options de type "entier" dans l'extension irc : - /fset c:${file} == irc && ${type_en} == integer ----- -// end::fset_commands[] - -// tag::guile_commands[] -[[command_guile_guile]] -* `+guile+`: lister/charger/décharger des scripts - ----- -/guile list|listfull [<nom>] - load [-q] <fichier> - autoload - reload|unload [-q] [<nom>] - eval [-o|-oc] <code> - version - - list : lister les scripts chargés -listfull : lister les scripts chargés (verbeux) - load : charger un script -autoload : charger tous les scripts dans le répertoire "autoload" - reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload") - unload : décharger un script (si pas de nom donné, décharger tous les scripts) - fichier : script (fichier) à charger - -q : mode silencieux : ne pas afficher de messages - nom : nom de script (nom utilisé dans l'appel à la fonction "register") - eval : évaluer le code source et afficher le résultat sur le tampon courant - -o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes - -oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes - code : le code source à évaluer - version : afficher la version de l'interpréteur utilisé - -Sans paramètre, cette commande liste les scripts chargés. ----- -// end::guile_commands[] - -// tag::irc_commands[] -[[command_irc_admin]] -* `+admin+`: trouver les informations sur l'administrateur du serveur - ----- -/admin [<cible>] - -cible : nom du serveur ----- - -[[command_irc_allchan]] -* `+allchan+`: exécuter une commande sur tous les canaux de tous les serveurs connectés - ----- -/allchan [-current] [-parted] [-exclude=<canal>[,<canal>...]] <commande> - [-current] [-parted] -include=<canal>[,<canal>...] <commande> - - -current : exécuter la commande pour les canaux du serveur courant seulement - -parted : exécuter la commande sur les canaux quittés seulement - -exclude : exclure certains canaux (le caractère joker "*" est autorisé) - -include : inclure seulement certains canaux (le caractère joker "*" est autorisé) - commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/') - -La commande et les paramètres sont évalués (voir /help eval), les variables suivantes sont remplacées : - $server nom du serveur - $channel nom du canal - $nick pseudo sur le serveur - ${irc_server.xxx} variable xxx dans le serveur - ${irc_channel.xxx} variable xxx dans le canal - -Exemples : - exécuter '/me teste' sur tous les canaux : - /allchan /me teste - dire 'bonjour' partout sauf sur #weechat : - /allchan -exclude=#weechat bonjour - dire 'bonjour' partout sauf sur #weechat et les canaux commençant par #linux : - /allchan -exclude=#weechat,#linux* bonjour - dire 'bonjour' sur tous les canaux commençant par #linux : - /allchan -include=#linux* bonjour - fermer tous les tampons avec des canaux quittés : - /allchan -parted /close ----- - -[[command_irc_allpv]] -* `+allpv+`: exécuter une commande sur tous les tampons privés de tous les serveurs connectés - ----- -/allpv [-current] [-exclude=<pseudo>[,<pseudo>...]] <commande> - [-current] [-include=<pseudo>[,<pseudo>...]] <commande> - - -current : exécuter la commande pour les tampons privés du serveur courant seulement - -exclude : exclure certains pseudos (le caractère joker "*" est autorisé) - -include : inclure seulement certains pseudos (le caractère joker "*" est autorisé) - commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/') - -La commande et les paramètres sont évalués (voir /help eval), les variables suivantes sont remplacées : - $server nom du serveur - $channel nom du canal - $nick pseudo sur le serveur - ${irc_server.xxx} variable xxx dans le serveur - ${irc_channel.xxx} variable xxx dans le canal - -Exemples : - exécuter '/me teste' sur tous les tampons privés : - /allpv /me teste - dire 'bonjour' partout sauf sur pour le pseudo foo : - /allpv -exclude=foo bonjour - dire 'bonjour' partout sauf pour le pseudo foo et les pseudos commençant par bar : - /allpv -exclude=foo,bar* bonjour - dire 'bonjour' pour tous les pseudos commençant par bar : - /allpv -include=bar* bonjour - fermer tous les tampons privés : - /allpv /close ----- - -[[command_irc_allserv]] -* `+allserv+`: exécuter une commande sur tous les serveurs connectés - ----- -/allserv [-exclude=<serveur>[,<serveur>...]] <commande> - [-include=<serveur>[,<serveur>...]] <commande> - - -exclude : exclure certains serveurs (le caractère joker "*" est autorisé) - -include : inclure seulement certains serveurs (le caractère joker "*" est autorisé) - commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/') - -La commande et les paramètres sont évalués (voir /help eval), les variables suivantes sont remplacées : - $server nom du serveur - $nick pseudo sur le serveur - ${irc_server.xxx} variable xxx dans le serveur - -Exemples : - changer de pseudo sur tous les serveurs : - /allserv /nick newnick - positionner l'absence sur tous les serveurs : - /allserv /away Je suis absent - faire un whois sur mon pseudo sur tous les serveurs : - /allserv /whois $nick ----- - -[[command_irc_auth]] -* `+auth+`: s'authentifier avec SASL - ----- -/auth [<utilisateur> <mot_de_passe>] - - utilisateur : nom d'utilisateur SASL (le contenu est évalué, voir /help eval ; les options de serveur sont évaluées avec ${irc_server.xxx} et ${server} est remplacé par le nom du serveur) -mot_de_passe : mot de passe SASL ou chemin vers le fichier de clé privée (le contenu est évalué, voir /help eval ; les options de serveur sont évaluées avec ${irc_server.xxx} et ${server} est remplacé par le nom du serveur) - -Si le nom d'utilisateur et mot de passe ne sont pas donnés, les valeurs des options serveur "sasl_username" et "sasl_password" (ou "sasl_key") sont utilisées. - -Exemples : - s'authentifier avec le nom d'utilisateur et mot de passe défini dans le serveur : - /auth - s'authentifier avec un utilisateur différent : - /auth utilisateur2 mot_de_passe2 - s'authentifier avec un utilisateur différent et le mécanisme ecdsa-nist256p-challenge : - /auth utilisateur2 ${weechat_config_dir}/ecdsa2.pem ----- - -[[command_irc_autojoin]] -* `+autojoin+`: configurer l'option serveur "autojoin" - ----- -/autojoin add [<canal1> [<canal2>...]] - addraw <canal1>[,<canal2>...] [<clé1>[,<clé2>...]] - del [<canal1> [<canal2>...]] - apply - join - sort - - add : ajouter le canal courant ou une liste de canaux (avec clés facultatives) dans l'option autojoin ; si vous êtes sur le canal et que la clé n'est pas fournie, la clé est lue sur ce canal - addraw : utiliser le format brut IRC (identique à la commande /join) : tous les canaux séparés par des virgules, clés facultatives séparées par des virgules - del : supprimer le canal courant ou une liste de canaux de l'option autojoin -channel : nom du canal - key : clé pour le canal - apply : définir les canaux actuellement joints dans l'option autojoin - join : joindre les canaux de l'option autojoin - sort : trier les canaux de l'option autojoin par ordre alphabétique - -Exemples : - /autojoin add - /autojoin add #test - /autojoin add #chan1 #chan2 - /allchan /autojoin add - /autojoin addraw #chan1,#chan2,#chan3 key1,key2 - /autojoin del - /autojoin del #chan1 - /autojoin apply - /autojoin join - /autojoin sort ----- - -[[command_irc_ban]] -* `+ban+`: bannir des pseudos ou hôtes - ----- -/ban [<canal>] [<pseudo> [<pseudo>...]] - - canal : nom du canal -pseudo : pseudo ou hôte - -Sans paramètre, cette commande affiche la liste des bannissements pour le canal courant. ----- - -[[command_irc_cap]] -* `+cap+`: négociation de capacité client - ----- -/cap ls - list - req|ack [<capacité> [<capacité>...]] - end - - ls : lister les capacités supportées par le serveur - list : lister les capacités actuellement activées - req : demander une nouvelle capacité ou supprimer une capacité (si elle commence par "-", par exemple : "-multi-prefix") - ack : accuser réception de capacités qui nécessitent un accusé de réception du client - end : terminer la négociation de capacité - -Sans paramètre, "ls" et "list" sont envoyés. - -Les capacités supportées par WeeChat sont : account-notify, away-notify, cap-notify, chghost, extended-join, invite-notify, message-tags, multi-prefix, server-time, setname, userhost-in-names. - -Les capacités à activer automatiquement sur les serveurs peuvent être définies dans l'option irc.server_default.capabilities (ou par serveur dans l'option irc.server.xxx.capabilities). - -Exemples : - afficher les capacités supportées et activées : - /cap - demander les capacités multi-prefix et away-notify : - /cap req multi-prefix away-notify - demander la capacité extended-join, supprimer la capacité multi-prefix : - /cap req extended-join -multi-prefix - supprimer la capacité away-notify : - /cap req -away-notify ----- - -[[command_irc_connect]] -* `+connect+`: se connecter à un/plusieurs serveur(s) IRC - ----- -/connect [<serveur> [<serveur>...]] [-<option>[=<valeur>]] [-no<option>] [-nojoin] [-switch] - -all|-auto|-open [-nojoin] [-switch] - - serveur : nom du serveur, qui peut être : - - nom interne de serveur (ajouté par /server add, usage recommandé) - - nom/port ou IP/port, le port par défaut est 6667 - - URL avec le format : irc[6][s]://[pseudo[:mot_passe]@]irc.example.org[:port][/#canal1][,#canal2[...]] - Note : pour une adresse/IP/URL, un serveur temporaire est ajouté (NON SAUVÉ), voir /help irc.look.temporary_servers - option : définir l'option pour le serveur (pour une option booléenne, la valeur peut être omise) -nooption : définir l'option booléenne à 'off' (par exemple : -nossl) - -all : se connecter à tous les serveurs définis dans la configuration - -auto : se connecter aux serveurs qui ont "autoconnect" activé - -open : se connecter à tous les serveurs ouverts qui ne sont pas actuellement connectés - -nojoin : ne rejoindre aucun canal (même si l'autojoin est activé pour le serveur) - -switch : basculer vers l'adresse suivante du serveur - -Pour se déconnecter du serveur ou stopper toute tentative de connexion, utilisez la commande /disconnect. - -Exemples : - /connect libera - /connect irc.oftc.net/6667 - /connect irc6.oftc.net/6667 -ipv6 - /connect irc6.oftc.net/6697 -ipv6 -ssl - /connect my.server.org/6697 -ssl -password=test - /connect irc://nick@irc.oftc.net/#channel - /connect -switch ----- - -[[command_irc_ctcp]] -* `+ctcp+`: envoyer un message CTCP (Client-To-Client Protocol) - ----- -/ctcp [-server <serveur>] <cible>[,<cible>...] <type> [<paramètres>] - - server : envoyer à ce serveur (nom interne) - cible : pseudo ou nom de canal ('*' = canal courant) - type : type de CTCP (exemples : "version", "ping", etc.) -arguments : paramètres pour le CTCP - -Exemples : - /ctcp toto time - /ctcp toto version - /ctcp * version ----- - -[[command_irc_cycle]] -* `+cycle+`: quitter et rejoindre un canal - ----- -/cycle [<canal>[,<canal>...]] [message] - - canal : nom du canal à quitter -message : message de fin (affiché aux autres utilisateurs) ----- - -[[command_irc_dcc]] -* `+dcc+`: démarrer un DCC (transfert de fichier ou discussion directe) - ----- -/dcc chat <pseudo> - send <pseudo> <fichier> - - pseudo : pseudo -fichier : nom du fichier (sur la machine locale) - -Exemples : - discuter avec le pseudo "toto" : - /dcc chat toto - envoyer le fichier "/home/foo/bar.txt" au pseudo "toto" : - /dcc send toto /home/foo/bar.txt ----- - -[[command_irc_dehalfop]] -* `+dehalfop+`: retirer le statut de demi-opérateur du canal à/aux pseudo(s) - ----- -/dehalfop <pseudo> [<pseudo>...] - * -yes - -pseudo : pseudo ou masque (le caractère joker "*" est autorisé) - * : retirer le statut de demi-opérateur de tout le monde sur le canal excepté vous-même ----- - -[[command_irc_deop]] -* `+deop+`: retirer le statut d'opérateur du canal à/aux pseudo(s) - ----- -/deop <pseudo> [<pseudo>...] - * -yes - -pseudo : pseudo ou masque (le caractère joker "*" est autorisé) - * : retirer le statut d'opérateur de tout le monde sur le canal excepté vous-même ----- - -[[command_irc_devoice]] -* `+devoice+`: retirer la voix du/des pseudo(s) - ----- -/devoice <pseudo> [<pseudo>...] - * -yes - -pseudo : pseudo ou masque (le caractère joker "*" est autorisé) - * : retirer la voix de tout le monde sur le canal ----- - -[[command_irc_die]] -* `+die+`: arrêter le serveur - ----- -/die [<cible>] - -cible : nom du serveur ----- - -[[command_irc_disconnect]] -* `+disconnect+`: se déconnecter d'un ou de tous les serveurs IRC - ----- -/disconnect [<serveur>|-all|-pending [<raison>]] - - serveur : nom interne du serveur - -all : se déconnecter de tous les serveurs --pending : annuler la reconnexion automatique sur les serveurs en cours de reconnexion - raison : raison pour le "quit" ----- - -[[command_irc_halfop]] -* `+halfop+`: donner le statut de demi-opérateur à un/des pseudo(s) - ----- -/halfop <pseudo> [<pseudo>...] - * -yes - -pseudo : pseudo ou masque (le caractère joker "*" est autorisé) - * : donner le statut de demi-opérateur à tout le monde sur le canal ----- - -[[command_irc_ignore]] -* `+ignore+`: ignorer des pseudos/hôtes de serveurs ou canaux - ----- -/ignore list - add [re:]<pseudo> [<serveur> [<canal>]] - del <numéro>|-all - - list : lister tous les ignores - add : ajouter un ignore - pseudo : pseudo ou hôte (peut être une expression régulière POSIX étendue si "re:" est donné ou un masque avec "*" pour remplacer zéro ou plusieurs caractères) - del : supprimer un ignore - numéro : numéro du ignore à supprimer (voir la liste des ignore pour le trouver) - -all : supprimer tous les ignores - serveur : nom de serveur interne où l'ignore fonctionnera - canal : canal où l'ignore fonctionnera - -Note : l'expression régulière peut commencer par "(?-i)" pour devenir sensible à la casse. - -Exemples : - ignorer le pseudo "toto" partout : - /ignore add toto - ignorer le hôte "toto@domain.com" sur le serveur libera : - /ignore add toto@domain.com libera - ignorer le hôte "toto*@*.domain.com" sur libera/#weechat : - /ignore add toto*@*.domain.com libera #weechat ----- - -[[command_irc_info]] -* `+info+`: voir les informations décrivant le serveur - ----- -/info [<cible>] - -cible : nom du serveur ----- - -[[command_irc_invite]] -* `+invite+`: inviter un pseudo sur un canal - ----- -/invite <pseudo> [<pseudo>...] [<canal>] - -pseudo : pseudo - canal : canal ----- - -[[command_irc_ison]] -* `+ison+`: vérifier si un pseudo est actuellement sur IRC - ----- -/ison <pseudo> [<pseudo>...] - -pseudo : pseudo ----- - -[[command_irc_join]] -* `+join+`: rejoindre un canal - ----- -/join [-noswitch] [-server <serveur>] [<canal1>[,<canal2>...]] [<clé1>[,<clé2>...]] - --noswitch : ne pas basculer sur le nouveau tampon - serveur : envoyer à ce serveur (nom interne) - canal : nom du canal à rejoindre - clé : clé pour rejoindre le canal (les canaux avec une clé doivent être les premiers dans la liste) - -Exemples : - /join #weechat - /join #protectedchan,#weechat key - /join -server libera #weechat - /join -noswitch #weechat ----- - -[[command_irc_kick]] -* `+kick+`: éjecter un utilisateur d'un canal - ----- -/kick [<canal>] <pseudo> [<raison>] - - canal : nom du canal -pseudo : pseudo -raison : raison (évaluée, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs) ----- - -[[command_irc_kickban]] -* `+kickban+`: éjecter un utilisateur d'un canal et bannir l'hôte - ----- -/kickban [<canal>] <pseudo> [<raison>] - - canal : nom du canal -pseudo : pseudo -raison : raison (évaluée, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs) - -Il est possible d'éjecter/bannir avec un masque, le pseudo sera extrait du masque et remplacé par "*". - -Exemple : - bannir "*!*@host.com" puis éjecter "toto" : - /kickban toto!*@host.com ----- - -[[command_irc_kill]] -* `+kill+`: fermer la connexion client-serveur - ----- -/kill <pseudo> [<raison>] - -pseudo : pseudo -raison : raison ----- - -[[command_irc_knock]] -* `+knock+`: envoyer une notice à un canal en invitation seulement, en demandant une invitation - ----- -/knock <canal> [<message>] - - canal : nom du canal -message : message à envoyer ----- - -[[command_irc_links]] -* `+links+`: lister tous les noms de serveurs connus du serveur qui répondent à la requête - ----- -/links [[<cible>] <masque_serveur>] - - cible : ce serveur doit répondre à la requête -masque_serveur : liste des serveurs correspondant au masque ----- - -[[command_irc_list]] -* `+list+`: lister les canaux et leurs titres - ----- -/list [-server <serveur>] [-re <regex>] [<canal>[,<canal>...]] [<cible>] - -serveur : envoyer à ce serveur (nom interne) - regex : expression régulière POSIX étendue utilisée pour filtrer les résultats (insensible à la casse, peut commencer par "(?-i)" pour devenir sensible à la casse) - canal : canal à lister - cible : nom du serveur - -Exemples : - lister tous les canaux du serveur (peut être très lent pour les grands réseaux) : - /list - lister le canal #weechat : - /list #weechat - lister tous les canaux commençant par "#weechat" (peut être très lent pour les grands réseaux) : - /list -re #weechat.* ----- - -[[command_irc_lusers]] -* `+lusers+`: obtenir des statistiques sur la taille du réseau IRC - ----- -/lusers [<masque> [<cible>]] - -masque : serveurs qui correspondent au masque seulement - cible : serveur pour faire suivre la requête ----- - -[[command_irc_map]] -* `+map+`: afficher une carte graphique du réseau IRC - ----- ----- - -[[command_irc_me]] -* `+me+`: envoyer une action CTCP au canal courant - ----- -/me <message> - -message : message à envoyer ----- - -[[command_irc_mode]] -* `+mode+`: changer le mode du canal ou de l'utilisateur - ----- -/mode [<canal>] [+|-]o|p|s|i|t|n|m|l|b|e|v|k [<paramètres>] - <pseudo> [+|-]i|s|w|o - -modes de canaux : - canal : nom du canal à modifier (par défaut le canal courant) - o : donner/reprendre le statut privilégié d'opérateur - p : indicateur de canal privé - s : indicateur de canal secret - i : indicateur de canal avec invitation seulement - t : le titre est modifiable seulement par un opérateur du canal - n : aucun message au canal depuis l'extérieur - m : canal modéré - l : fixer la limite d'utilisateurs pour le canal - b : paramétrer un masque de bannissement pour garder des utilisateurs dehors - e : paramétrer un masque d'exception - v : donner/reprendre la possibilité de parler sur un canal modéré - k : définir une clé (mot de passe) pour accéder au canal -modes utilisateur : - pseudo : pseudo à modifier - i : marquer un utilisateur comme invisible - s : marquer un utilisateur pour recevoir les notices du serveur - w : l'utilisateur reçoit les wallops - o : drapeau opérateur - -La liste des modes n'est pas exhaustive, vous devriez lire la documentation de votre serveur pour voir tous les modes possibles. - -Exemples : - protéger le titre du canal #weechat : - /mode #weechat +t - devenir invisible sur le serveur : - /mode nick +i ----- - -[[command_irc_motd]] -* `+motd+`: obtenir le message du jour - ----- -/motd [<cible>] - -cible : nom du serveur ----- - -[[command_irc_msg]] -* `+msg+`: envoyer un message à un pseudo ou canal - ----- -/msg [-server <serveur>] <cible>[,<cible>...] <texte> - -serveur : envoyer à ce serveur (nom interne) - cible : pseudo ou canal (peut-être un masque, '*' = canal courant) - texte : texte à envoyer ----- - -[[command_irc_names]] -* `+names+`: lister les pseudos sur des canaux - ----- -/names [<canal>[,<canal>...]] - -canal : nom du canal ----- - -[[command_irc_nick]] -* `+nick+`: changer le pseudo courant - ----- -/nick [-all] <pseudo> - - -all : définir le nouveau pseudo sur tous les serveurs connectés -pseudo : nouveau pseudo ----- - -[[command_irc_notice]] -* `+notice+`: envoyer un message notice à un utilisateur - ----- -/notice [-server <serveur>] <cible> <texte> - -serveur : envoyer à ce serveur (nom interne) - cible : pseudo ou nom de canal - texte : texte à envoyer ----- - -[[command_irc_notify]] -* `+notify+`: ajouter une notification de présence ou de statut d'absence pour des pseudos sur les serveurs - ----- -/notify add <pseudo> [<serveur> [-away]] - del <pseudo>|-all [<serveur>] - - add : ajouter une notification - pseudo : pseudo -serveur : nom interne du serveur (par défaut le serveur courant) - -away : notifier quand le message d'absence est changé (en faisant un whois sur le pseudo) - del : supprimer une notification - -all : supprimer toutes les notifications - -Sans paramètre, cette commande affiche les notifications pour le serveur courant (ou tous les serveurs si la commande est exécutée sur le tampon "core"). - -Exemples : - notifier quand "toto" rejoint/quitte le serveur courant : - /notify add toto - notifier quand "toto" rejoint/quitte le serveur libera : - /notify add toto libera - notifier quand "toto" est absent ou de retour sur le serveur libera : - /notify add toto libera -away ----- - -[[command_irc_op]] -* `+op+`: donner le statut d'opérateur à un/des pseudo(s) - ----- -/op <pseudo> [<pseudo>...] - * -yes - -pseudo : pseudo ou masque (le caractère joker "*" est autorisé) - * : donner le statut d'opérateur à tout le monde sur le canal ----- - -[[command_irc_oper]] -* `+oper+`: obtenir le statut d'opérateur - ----- -/oper <utilisateur> <mot_de_passe> - - utilisateur : utilisateur -mot_de_passe : mot de passe ----- - -[[command_irc_part]] -* `+part+`: quitter un canal - ----- -/part [<canal>[,<canal>...]] [message] - - canal : canal à quitter -message : message de fin (affiché aux autres utilisateurs) ----- - -[[command_irc_ping]] -* `+ping+`: envoyer un ping au serveur - ----- -/ping <cible1> [<cible2>] - -cible1 : serveur -cible2 : faire suivre le ping à ce serveur ----- - -[[command_irc_pong]] -* `+pong+`: répondre à un message ping - ----- -/pong <démon> [<démon2>] - - démon : démon qui a répondu au message Ping -démon2 : faire suivre le message à ce démon ----- - -[[command_irc_query]] -* `+query+`: envoyer un message privé à un pseudo - ----- -/query [-noswitch] [-server <serveur>] <pseudo>[,<pseudo>...] [<texte>] - --noswitch : ne pas basculer sur le nouveau tampon - serveur : envoyer à ce serveur (nom interne) - pseudo : pseudo - texte : texte à envoyer ----- - -[[command_irc_quiet]] -* `+quiet+`: faire taire des pseudos ou hôtes - ----- -/quiet [<canal>] [<pseudo> [<pseudo>...]] - - canal : nom du canal -pseudo : pseudo ou hôte - -Sans paramètre, cette commande affiche la liste des "quiet" pour le canal courant. ----- - -[[command_irc_quote]] -* `+quote+`: envoyer des données brutes au serveur sans analyse - ----- -/quote [-server <serveur>] <données> - -serveur : envoyer à ce serveur (nom interne) -données : données brutes à envoyer ----- - -[[command_irc_reconnect]] -* `+reconnect+`: se reconnecter à un/plusieurs serveur(s) - ----- -/reconnect <serveur> [<serveur>...] [-nojoin] [-switch] - -all [-nojoin] [-switch] - -serveur : serveur pour se reconnecter (nom interne) - -all : se reconnecter à tous les serveurs --nojoin : ne rejoindre aucun canal (même si l'autojoin est activé pour le serveur) --switch : basculer vers l'adresse suivante du serveur ----- - -[[command_irc_rehash]] -* `+rehash+`: demander au serveur de recharger son fichier de configuration - ----- -/rehash [<option>] - -option : option supplémentaire, pour certains serveurs ----- - -[[command_irc_remove]] -* `+remove+`: forcer un utilisateur à quitter un canal - ----- -/remove [<canal>] <pseudo> [<raison>] - - canal : nom du canal -pseudo : pseudo -raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leurs valeurs) ----- - -[[command_irc_restart]] -* `+restart+`: demander au serveur de redémarrer - ----- -/restart [<cible>] - -cible : nom du serveur ----- - -[[command_irc_rules]] -* `+rules+`: demander les règles du serveur - ----- ----- - -[[command_irc_sajoin]] -* `+sajoin+`: forcer un utilisateur à rejoindre un ou plusieurs canaux - ----- -/sajoin <pseudo> <canal>[,<canal>...] - -pseudo : pseudo - canal : canal ----- - -[[command_irc_samode]] -* `+samode+`: changer le mode du canal, sans avoir le statut d'opérateur - ----- -/samode [<canal>] <mode> - -canal : nom du canal - mode : mode pour le canal ----- - -[[command_irc_sanick]] -* `+sanick+`: forcer un utilisateur à utiliser un autre pseudo - ----- -/sanick <pseudo> <nouveau_pseudo> - - pseudo : pseudo -nouveau_pseudo : nouveau pseudo ----- - -[[command_irc_sapart]] -* `+sapart+`: forcer un utilisateur à quitter un ou plusieurs canaux - ----- -/sapart <pseudo> <canal>[,<canal>...] - -pseudo : pseudo - canal : canal ----- - -[[command_irc_saquit]] -* `+saquit+`: forcer un utilisateur à quitter le serveur avec une raison - ----- -/saquit <pseudo> <raison> - -pseudo : pseudo -raison : raison ----- - -[[command_irc_server]] -* `+server+`: lister, ajouter ou retirer des serveurs IRC - ----- -/server list|listfull [<nom>] - add <nom> <nom_machine>[/<port>] [-temp] [-<option>[=<valeur>]] [-no<option>] - copy|rename <nom> <nouveau_nom> - reorder <nom> [<nom>...] - open <nom>|-all [<nom>...] - del|keep <nom> - deloutq|jump - raw [<filtre>] - - list : afficher les serveurs (sans paramètre, cette liste est affichée) - listfull : afficher les serveurs avec de l'info détaillée pour chaque - add : ajouter un nouveau serveur - nom : nom du serveur, pour usage interne et affichage ; ce nom est utilisé pour se connecter au serveur (/connect nom) et pour définir les options du serveur : irc.server.name.xxx -nom_machine : nom ou adresse IP du serveur avec port en option (défaut : 6667), plusieurs adresses peuvent être séparées par une virgule - -temp : ajouter un serveur temporaire (non sauvé) - option : définir l'option pour le serveur (pour une option booléenne, la valeur peut être omise) - nooption : définir l'option booléenne à 'off' (par exemple : -nossl) - copy : dupliquer un serveur - rename : renommer un serveur - reorder : réordonner la liste des serveurs - open : ouvrir le tampon du serveur sans s'y connecter - keep : garder le serveur dans le fichier de configuration (pour les serveurs temporaires seulement) - del : supprimer un serveur - deloutq : supprimer la file d'attente des messages sortants pour tous les serveurs (tous les messages que WeeChat est actuellement en train d'envoyer) - jump : sauter au tampon du serveur - raw : ouvrir le tampon avec les données brutes IRC - filtre : définir un nouveau filtre pour voir seulement les messages correspondants (ce filtre peut aussi être utilisé en entrée du tampon des données brutes) ; les formats autorisés sont : - * afficher tous les messages (pas de filtre) - xxx afficher seulement les messages contenant "xxx" - s:xxx afficher seulement les messages pour le serveur "xxx" - f:xxx afficher seulement les messages avec un drapeau : recv (message reçu), sent (message envoyé), modified (message modifié par un modificateur), redirected (message redirigé) - m:xxx afficher seulement les messages pour la commande IRC "xxx" - c:xxx afficher seulement les messages qui correspondent à la condition évaluée "xxx", en utilisant les variables suivantes : sortie de la fonction irc_message_parse (comme nick, command, channel, text, etc., voir la fonction info_get_hashtable dans la référence API extension pour la liste de toutes les variables), date (format : "yyyy-mm-dd hh:mm:ss"), server, recv, sent, modified, redirected - -Exemples : - /server listfull - /server add libera irc.libera.chat - /server add libera irc.libera.chat/6697 -ssl -autoconnect - /server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667 - /server copy libera libera-test - /server rename libera-test libera2 - /server reorder libera2 libera - /server del libera - /server deloutq - /server raw - /server raw s:libera - /server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo ----- - -[[command_irc_service]] -* `+service+`: enregistrer un nouveau service - ----- -/service <pseudo> <réservé> <distribution> <type> <réservé> <info> - -distribution : visibilité du service - type : réservé pour une utilisation future ----- - -[[command_irc_servlist]] -* `+servlist+`: lister les services actuellement connectés au réseau - ----- -/servlist [<masque> [<type>]] - -masque : lister seulement les services qui correspondent à ce masque - type : lister seulement les services de ce type ----- - -[[command_irc_setname]] -* `+setname+`: définir le nom réel - ----- -/setname <nom_réel> - -nom_réel : nouveau nom réel ----- - -[[command_irc_squery]] -* `+squery+`: envoyer un message à un service - ----- -/squery <service> <texte> - -service : nom du service - texte : texte à envoyer ----- - -[[command_irc_squit]] -* `+squit+`: déconnecter les liens vers un serveur - ----- -/squit <cible> <commentaire> - - cible : nom du serveur -commentaire : commentaire ----- - -[[command_irc_stats]] -* `+stats+`: demander des statistiques sur le serveur - ----- -/stats [<requête> [<cible>]] - -requête : c/h/i/k/l/m/o/y/u (voir la RFC1459) - cible : nom du serveur ----- - -[[command_irc_summon]] -* `+summon+`: envoyer aux utilisateurs d'un serveur IRC un message leur demandant de rejoindre IRC - ----- -/summon <utilisateur> [<cible> [<canal>]] - -utilisateur : nom d'utilisateur - cible : nom du serveur - canal : nom du canal ----- - -[[command_irc_time]] -* `+time+`: demander l'heure locale de serveur - ----- -/time [<cible>] - -cible : demander l'heure de ce serveur ----- - -[[command_irc_topic]] -* `+topic+`: recevoir/définir le titre du canal - ----- -/topic [<canal>] [<titre>|-delete] - - canal : nom du canal - titre : nouveau titre --delete : supprimer le titre du canal ----- - -[[command_irc_trace]] -* `+trace+`: trouver le chemin jusqu'à un serveur spécifique - ----- -/trace [<cible>] - -cible : nom du serveur ----- - -[[command_irc_unban]] -* `+unban+`: supprimer le bannissement sur des pseudos ou hôtes - ----- -/unban [<canal>] <pseudo>|<nombre> [<pseudo>|<nombre>...] - - canal : nom du canal -pseudo : pseudo ou hôte -nombre : numéro de bannissement (comme affiché par la commande /ban) ----- - -[[command_irc_unquiet]] -* `+unquiet+`: ne plus taire des pseudos ou hôtes - ----- -/unquiet [<canal>] <pseudo>|<nombre> [<pseudo>|<nombre>...] - - canal : nom du canal -pseudo : pseudo ou hôte -nombre : numéro de "quiet" (comme affiché par la commande /quiet) ----- - -[[command_irc_userhost]] -* `+userhost+`: retourner une liste d'informations sur des pseudos - ----- -/userhost <pseudo> [<pseudo>...] - -pseudo : pseudo ----- - -[[command_irc_users]] -* `+users+`: liste des utilisateurs connectés au serveur - ----- -/users [<cible>] - -cible : nom du serveur ----- - -[[command_irc_version]] -* `+version+`: retourner la version du pseudo ou du serveur (courant ou spécifié) - ----- -/version [<cible>|<pseudo>] - - cible : nom du serveur -pseudo : pseudo ----- - -[[command_irc_voice]] -* `+voice+`: donner la voix à/aux pseudo(s) - ----- -/voice <pseudo> [<pseudo>...] - * -yes - -pseudo : pseudo ou masque (le caractère joker "*" est autorisé) - * : donner la voix à tout le monde sur le canal ----- - -[[command_irc_wallchops]] -* `+wallchops+`: envoyer une notice aux opérateurs du canal - ----- -/wallchops [<canal>] <texte> - -canal : nom du canal -texte : texte à envoyer ----- - -[[command_irc_wallops]] -* `+wallops+`: envoyer un message à tous les utilisateurs connectés qui ont activé le mode utilisateur 'w' pour eux-mêmes - ----- -/wallops <texte> - -texte : texte à envoyer ----- - -[[command_irc_who]] -* `+who+`: générer une requête qui retourne une liste d'information - ----- -/who [<masque> [o]] - -masque : information qui correspond à ce masque uniquement - o : seuls les opérateurs sont retournés correspondant au masque fourni ----- - -[[command_irc_whois]] -* `+whois+`: demander les informations sur le(s) utilisateur(s) - ----- -/whois [<cible>] [<pseudo>[,<pseudo>...]] - - cible : nom de serveur -pseudo : pseudo (peut être un masque) - -Sans paramètre, cette commande effectuera un whois sur : -- votre propre pseudo si le tampon est un serveur/canal -- le pseudo distant si le tampon est un privé. - -Si l'option irc.network.whois_double_nick est activée, deux pseudos sont envoyés (si un seul est donné), pour avoir le temps d'inactivité dans la réponse. ----- - -[[command_irc_whowas]] -* `+whowas+`: demander de l'information sur un pseudo qui n'existe plus - ----- -/whowas <pseudo>[,<pseudo>...] [<nombre> [<cible>]] - -pseudo : pseudo -nombre : nombre de réponses à retourner (recherche complète si nombre négatif) - cible : la réponse doit correspondre à ce masque ----- -// end::irc_commands[] - -// tag::javascript_commands[] -[[command_javascript_javascript]] -* `+javascript+`: lister/charger/décharger des scripts - ----- -/javascript list|listfull [<nom>] - load [-q] <fichier> - autoload - reload|unload [-q] [<nom>] - eval [-o|-oc] <code> - version - - list : lister les scripts chargés -listfull : lister les scripts chargés (verbeux) - load : charger un script -autoload : charger tous les scripts dans le répertoire "autoload" - reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload") - unload : décharger un script (si pas de nom donné, décharger tous les scripts) - fichier : script (fichier) à charger - -q : mode silencieux : ne pas afficher de messages - nom : nom de script (nom utilisé dans l'appel à la fonction "register") - eval : évaluer le code source et afficher le résultat sur le tampon courant - -o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes - -oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes - code : le code source à évaluer - version : afficher la version de l'interpréteur utilisé - -Sans paramètre, cette commande liste les scripts chargés. ----- -// end::javascript_commands[] - -// tag::logger_commands[] -[[command_logger_logger]] -* `+logger+`: configuration de l'extension logger - ----- -/logger list - set <niveau> - flush - disable - - list : afficher le statut d'enregistrement pour les tampons ouverts - set : définir le niveau d'enregistrement pour le tampon courant - niveau : niveau pour les messages à enregistrer (0 = pas d'enregistrement, 1 = quelques messages (les plus importants) .. 9 = tous les messages) - flush : écrire tous les fichiers de log maintenant -disable : désactiver l'enregistrement pour le tampon courant (définir le niveau à 0) - -Les options "logger.level.*" et "logger.mask.*" peuvent être utilisées pour définir le niveau ou le masque de nom de fichier pour un tampon, ou plusieurs tampons commençant par un nom. - -Niveaux de log utilisés par l'extension IRC : - 1 : message d'utilisateur (canal et privé), notice (serveur et canal) - 2 : changement de pseudo - 3 : message du serveur - 4 : join/part/quit - 9 : tous les autres messages - -Exemples : - définir le niveau d'enregistrement à 5 pour le tampon courant : - /logger set 5 - désactiver l'enregistrement pour le tampon courant : - /logger disable - définir le niveau à 3 pour les tampons IRC : - /set logger.level.irc 3 - désactiver l'enregistrement pour le tampon principal de WeeChat : - /set logger.level.core.weechat 0 - utiliser un répertoire par serveur IRC et un fichier par canal dedans : - /set logger.mask.irc "$server/$channel.weechatlog" ----- -// end::logger_commands[] - -// tag::lua_commands[] -[[command_lua_lua]] -* `+lua+`: lister/charger/décharger des scripts - ----- -/lua list|listfull [<nom>] - load [-q] <fichier> - autoload - reload|unload [-q] [<nom>] - eval [-o|-oc] <code> - version - - list : lister les scripts chargés -listfull : lister les scripts chargés (verbeux) - load : charger un script -autoload : charger tous les scripts dans le répertoire "autoload" - reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload") - unload : décharger un script (si pas de nom donné, décharger tous les scripts) - fichier : script (fichier) à charger - -q : mode silencieux : ne pas afficher de messages - nom : nom de script (nom utilisé dans l'appel à la fonction "register") - eval : évaluer le code source et afficher le résultat sur le tampon courant - -o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes - -oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes - code : le code source à évaluer - version : afficher la version de l'interpréteur utilisé - -Sans paramètre, cette commande liste les scripts chargés. ----- -// end::lua_commands[] - -// tag::perl_commands[] -[[command_perl_perl]] -* `+perl+`: lister/charger/décharger des scripts - ----- -/perl list|listfull [<nom>] - load [-q] <fichier> - autoload - reload|unload [-q] [<nom>] - eval [-o|-oc] <code> - version - - list : lister les scripts chargés -listfull : lister les scripts chargés (verbeux) - load : charger un script -autoload : charger tous les scripts dans le répertoire "autoload" - reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload") - unload : décharger un script (si pas de nom donné, décharger tous les scripts) - fichier : script (fichier) à charger - -q : mode silencieux : ne pas afficher de messages - nom : nom de script (nom utilisé dans l'appel à la fonction "register") - eval : évaluer le code source et afficher le résultat sur le tampon courant - -o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes - -oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes - code : le code source à évaluer - version : afficher la version de l'interpréteur utilisé - -Sans paramètre, cette commande liste les scripts chargés. ----- -// end::perl_commands[] - -// tag::php_commands[] -[[command_php_php]] -* `+php+`: lister/charger/décharger des scripts - ----- -/php list|listfull [<nom>] - load [-q] <fichier> - autoload - reload|unload [-q] [<nom>] - eval [-o|-oc] <code> - version - - list : lister les scripts chargés -listfull : lister les scripts chargés (verbeux) - load : charger un script -autoload : charger tous les scripts dans le répertoire "autoload" - reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload") - unload : décharger un script (si pas de nom donné, décharger tous les scripts) - fichier : script (fichier) à charger - -q : mode silencieux : ne pas afficher de messages - nom : nom de script (nom utilisé dans l'appel à la fonction "register") - eval : évaluer le code source et afficher le résultat sur le tampon courant - -o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes - -oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes - code : le code source à évaluer - version : afficher la version de l'interpréteur utilisé - -Sans paramètre, cette commande liste les scripts chargés. ----- -// end::php_commands[] - -// tag::python_commands[] -[[command_python_python]] -* `+python+`: lister/charger/décharger des scripts - ----- -/python list|listfull [<nom>] - load [-q] <fichier> - autoload - reload|unload [-q] [<nom>] - eval [-o|-oc] <code> - version - - list : lister les scripts chargés -listfull : lister les scripts chargés (verbeux) - load : charger un script -autoload : charger tous les scripts dans le répertoire "autoload" - reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload") - unload : décharger un script (si pas de nom donné, décharger tous les scripts) - fichier : script (fichier) à charger - -q : mode silencieux : ne pas afficher de messages - nom : nom de script (nom utilisé dans l'appel à la fonction "register") - eval : évaluer le code source et afficher le résultat sur le tampon courant - -o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes - -oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes - code : le code source à évaluer - version : afficher la version de l'interpréteur utilisé - -Sans paramètre, cette commande liste les scripts chargés. ----- -// end::python_commands[] - -// tag::relay_commands[] -[[command_relay_relay]] -* `+relay+`: contrôle du relai - ----- -/relay list|listfull|listrelay - add <nom> <port>|<chemin> - del|start|restart|stop <nom> - raw - sslcertkey - - list : lister les clients pour le relai - listfull : lister les clients pour le relai (verbeux) - listrelay : lister les relais (nom et port) - add : ajouter un relai (écouter sur un port) - del : supprimer un relai (les clients restent connectés) - start : écouter sur le port - restart : fermer le socket serveur et écouter à nouveau sur le port (les clients restent connectés) - stop : fermer le socket serveur (les clients restent connectés) - nom : nom du relai (voir le format ci-dessous) - port : port utilisé pour le relai - chemin : chemin utilisé pour le relai (pour un socket de domaine UNIX seulement) ; le chemin est évalué (voir la fonction string_eval_path_home dans la référence API extension) - raw : ouvrir le tampon avec les données brutes Relay -sslcertkey : définir le certificat/clé SSL en utilisant le chemin de l'option relay.network.ssl_cert_key - -Le nom du relai est : [ipv4.][ipv6.][ssl.]<protocole.nom> ou unix[.ssl].<protocole.nom> - ipv4 : forcer l'utilisation d'IPv4 - ipv6 : forcer l'utilisation d'IPv6 - ssl : activer SSL - unix : utiliser un socket de domaine UNIX -protocole.nom : protocole et nom à relayer : - - protocole "irc" : le nom est le serveur à partager (optionnel, si non donné, le nom de serveur doit être envoyé par le client dans la commande "PASS", avec le format : "PASS serveur:motdepasse") - - protocole "weechat" (le nom n'est pas utilisé) - -Le protocole "irc" permet à n'importe quel client IRC (incluant WeeChat lui-même) de se connecter sur le port. -Le protocole "weechat" permet à une interface distante de se connecter sur le port, voir la liste ici : https://weechat.org/about/interfaces/ - -Sans paramètre, cette commande ouvre le tampon avec la liste des clients pour le relai. - -Exemples : - proxy irc, pour le serveur "libera" : - /relay add irc.libera 8000 - proxy irc, pour le serveur "libera", avec SSL : - /relay add ssl.irc.libera 8001 - proxy irc, pour tous les serveurs (le client choisira), avec SSL : - /relay add ssl.irc 8002 - protocole weechat : - /relay add weechat 9000 - protocole weechat avec SSL : - /relay add ssl.weechat 9001 - protocole weechat avec SSL, en utilisant seulement IPv4 : - /relay add ipv4.ssl.weechat 9001 - protocole weechat avec SSL, en utilisant seulement IPv6 : - /relay add ipv6.ssl.weechat 9001 - protocole weechat avec SSL, en utilisant IPv4 + IPv6 : - /relay add ipv4.ipv6.ssl.weechat 9001 - protocole weechat avec un socket de domaine UNIX : - /relay add unix.weechat ${weechat_runtime_dir}/relay_socket ----- -// end::relay_commands[] - -// tag::ruby_commands[] -[[command_ruby_ruby]] -* `+ruby+`: lister/charger/décharger des scripts - ----- -/ruby list|listfull [<nom>] - load [-q] <fichier> - autoload - reload|unload [-q] [<nom>] - eval [-o|-oc] <code> - version - - list : lister les scripts chargés -listfull : lister les scripts chargés (verbeux) - load : charger un script -autoload : charger tous les scripts dans le répertoire "autoload" - reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload") - unload : décharger un script (si pas de nom donné, décharger tous les scripts) - fichier : script (fichier) à charger - -q : mode silencieux : ne pas afficher de messages - nom : nom de script (nom utilisé dans l'appel à la fonction "register") - eval : évaluer le code source et afficher le résultat sur le tampon courant - -o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes - -oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes - code : le code source à évaluer - version : afficher la version de l'interpréteur utilisé - -Sans paramètre, cette commande liste les scripts chargés. ----- -// end::ruby_commands[] - -// tag::script_commands[] -[[command_script_script]] -* `+script+`: Gestionnaire de scripts WeeChat - ----- -/script list [-o|-ol|-i|-il] - search <texte> - show <script> - load|unload|reload <script> [<script>...] - autoload|noautoload|toggleautoload <script> [<script>...] - install|remove|installremove|hold [-q] <script> [<script>...] - upgrade - update - - list : lister les scripts chargés (tous les langages) - -o : envoyer la liste des scripts chargés au tampon (chaîne en anglais) - -ol : envoyer la liste des scripts chargés au tampon (chaîne traduite) - -i : copier la liste des scripts chargés dans la ligne de commande (pour envoi au tampon) (chaîne en anglais) - -il : copier la liste des scripts chargés dans la ligne de commande (pour envoi au tampon) (chaîne traduite) - search : chercher des scripts par étiquettes, langage (python, perl, ...), extension de fichier (py, pl, ...) ou texte ; le résultat est affiché sur le tampon des scripts - show : afficher des infos détaillées sur le script - load : charger un ou plusieurs scripts - unload : décharger un ou plusieurs scripts - reload : recharger un ou plusieurs scripts - autoload : charger automatiquement un ou plusieurs scripts - noautoload : ne pas charger automatiquement un ou plusieurs scripts -toggleautoload : activer/désactiver le chargement automatique - install : installer/mettre à jour un ou plusieurs scripts - remove : supprimer un ou plusieurs scripts - installremove : installer ou supprimer un ou plusieurs scripts, selon l'état courant - hold : figer/défiger un ou plusieurs scripts (un script figé ne sera plus mis à jour et ne peut pas être supprimé) - -q : mode silencieux : ne pas afficher de messages - upgrade : mettre à jour les scripts obsolètes (avec nouvelle version disponible) - update : mettre à jour le cache local des scripts - -Sans paramètre, cette commande ouvre un tampon avec la liste des scripts. - -Sur le tampon des scripts, les statuts pour chaque script sont : - * i a H r N - | | | | | | - | | | | | obsolète (nouvelle version disponible) - | | | | chargé - | | | figé - | | chargé auto - | installé - script populaire - -Dans la sortie de /script list, les statuts pour chaque script sont : - * ? i a H N - | | | | | | - | | | | | obsolète (nouvelle version disponible) - | | | | figé - | | | chargé auto - | | installé - | script inconnu (ne peut pas être téléchargé/mis à jour) - script populaire - -Les touches sur le tampon des scripts : - alt+i installer le script - alt+r supprimer le script - alt+l charger le script - alt+L recharger le script - alt+u décharger le script - alt+A chargement automatique du script - alt+h (dé)figer le script - alt+v voir le script - -Entrée autorisée sur le tampon des scripts : - i/r/l/L/u/A/h/v action sur le script (identique aux touches ci-dessus) - q fermer le tampon - $ rafraîchir le tampon - s:x,y trier le tampon en utilisant les clés x et y (voir /help script.look.sort) - s: réinitialiser le tri (utiliser le tri par défaut) - word(s) filtrer les scripts : recherche du/des mot(s) dans les scripts (description, étiquettes, ...) - * supprimer le filtre - -Actions de la souris sur le tampon des scripts : - roulette faire défiler la liste - bouton gauche sélectionner le script - bouton droit installer/supprimer le script - -Exemples : - /script search url - /script install go.py urlserver.py - /script remove go.py - /script hold urlserver.py - /script reload urlserver - /script upgrade ----- -// end::script_commands[] - -// tag::spell_commands[] -[[command_spell_spell]] -* `+spell+`: configuration de l'extension spell - ----- -/spell enable|disable|toggle - listdict - setdict -|<dict>[,<dict>...] - deldict - addword [<dict>] <mot> - - enable : activer le vérificateur d'orthographe - disable : désactiver le vérificateur d'orthographe - toggle : activer/désactiver le vérificateur d'orthographe -listdict : afficher les dictionnaires installés - setdict : définir le dictionnaire pour le tampon courant (plusieurs dictionnaires peuvent être séparés par une virgule, la valeur spéciale "-" désactive la vérification orthographique sur le tampon courant) - deldict : supprimer le dictionnaire utilisé sur le tampon courant - addword : ajouter un mot dans le dictionnaire personnel - -Les lignes d'entrée commençant par '/' ne sont pas vérifiées, sauf pour certaines commandes (voir /set spell.check.commands). - -Pour activer le vérificateur d'orthographe sur tous les tampons, utilisez l'option "default_dict", par exemple : - /set spell.check.default_dict "en" - /spell enable - -Pour afficher une liste des suggestions dans une barre, utilisez l'objet "spell_suggest". - -La touche par défaut pour activer/désactiver le vérificateur d'orthographe est alt-s. ----- -// end::spell_commands[] - -// tag::tcl_commands[] -[[command_tcl_tcl]] -* `+tcl+`: lister/charger/décharger des scripts - ----- -/tcl list|listfull [<nom>] - load [-q] <fichier> - autoload - reload|unload [-q] [<nom>] - eval [-o|-oc] <code> - version - - list : lister les scripts chargés -listfull : lister les scripts chargés (verbeux) - load : charger un script -autoload : charger tous les scripts dans le répertoire "autoload" - reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload") - unload : décharger un script (si pas de nom donné, décharger tous les scripts) - fichier : script (fichier) à charger - -q : mode silencieux : ne pas afficher de messages - nom : nom de script (nom utilisé dans l'appel à la fonction "register") - eval : évaluer le code source et afficher le résultat sur le tampon courant - -o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes - -oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes - code : le code source à évaluer - version : afficher la version de l'interpréteur utilisé - -Sans paramètre, cette commande liste les scripts chargés. ----- -// end::tcl_commands[] - -// tag::trigger_commands[] -[[command_trigger_trigger]] -* `+trigger+`: gestion des triggers, le couteau Suisse pour WeeChat - ----- -/trigger list|listfull|listdefault - add|addoff|addreplace <nom> <hook> ["<paramètres>" ["<conditions>" ["<regex>" ["<commande>" ["<code_retour>" ["action_post"]]]]]] - addinput [<hook>] - input|output|recreate <nom> - set <nom> <option> <valeur> - rename|copy <nom> <nouveau_nom> - enable|disable|toggle [<nom>|-all [<nom>...]] - restart <nom>|-all [<nom>...] - show <nom> - del <nom>|-all [<nom>...] - restore <nom> [<nom>...] - default -yes - monitor [<filtre>] - - list : lister les triggers (sans paramètre, cette liste est affichée) - listfull : lister les triggers avec des informations détaillées pour chaque trigger -listdefault : lister les triggers par défaut - add : ajouter un trigger - addoff : ajouter un trigger (désactivé) - addreplace : ajouter ou remplacer un trigger existant - nom : nom du trigger - hook : signal, hsignal, modifier, line, print, command, command_run, timer, config, focus, info, info_hashtable - paramètres : paramètres pour le hook, dépendant du hook (séparés par des points-virgules) : - signal : nom(s) de signal (obligatoire) - hsignal : nom(s) de signal (obligatoire) - modifier : nom(s) de modificateur (obligatoire) - line : type de tampon ("formatted", "free" ou "*"), liste de masques de tampons, étiquettes - print : tampon, étiquettes, message, suppression des couleurs (0/1) - command : commande (obligatoire), description, paramètres, description des paramètres, complétion (tous les paramètres sauf la commande sont évalués, "${tg_trigger_name}" est remplacé par le nom du trigger, voir /help eval) - command_run : commande(s) (obligatoire) - timer : intervalle (obligatoire), alignement sur la seconde, nombre max d'appels - config : nom(s) de l'option (obligatoire) - focus : nom(s) de la zone (obligatoire) - info : nom(s) de l'info (obligatoire) - info_hashtable : nom(s) de l'info (obligatoire) - conditions : conditions évaluées pour le trigger - regex : une ou plusieurs expressions régulières pour remplacer des chaînes dans les variables - commande : commande à exécuter (plusieurs commandes peuvent être séparées par ";") -code_retour : code retour dans la fonction de rappel (ok (par défaut), ok_eat, error) -action_post : action à effectuer après l'exécution (none (par défaut), disable, delete) - addinput : définir la ligne de commande avec les paramètres par défaut pour créer un trigger - input : définir la ligne de commande utilisée pour créer le trigger - output : envoyer la commande pour créer le trigger sur le tampon - recreate : comme "input", avec l'option "addreplace" au lieu de "add" - set : définir une option dans un trigger - option : nom de l'option : name, hook, arguments, conditions, regex, command, return_code - (pour l'aide sur l'option, vous pouvez taper : /help trigger.trigger.<nom>.<option>) - valeur : nouvelle valeur pour l'option - rename : renommer un trigger - copy : copier un trigger - enable : activer un/des trigger(s) (sans paramètre : activer les triggers globalement) - disable : désactiver un/des trigger(s) (sans paramètre : désactiver les triggers globalement) - toggle : activer/désactiver un/des trigger(s) (sans paramètre : activer/désactiver les triggers globalement) - restart : redémarrer un/des trigger(s) (recréer les hooks) - show : afficher des informations détaillées sur un trigger (avec quelques statistiques) - del : supprimer un trigger - -all : effectuer l'action sur tous les triggers - restore : restaurer un/des trigger(s) avec les valeurs par défaut (fonctionne seulement pour les triggers par défaut) - default : restaurer les triggers par défaut - monitor : ouvrir le tampon moniteur des triggers - filtre : filtrer les hooks/triggers à afficher (un hook doit commencer par "@", par exemple "@signal"), plusieurs filtres peuvent être séparés par des virgules ; le caractère joker "*" est autorisé dans chaque nom de trigger - -Lorsqu'une fonction de rappel de trigger est appelée, les actions suivantes sont exécutées, dans cet ordre : - 1. vérifier les conditions ; si faux, sortir - 2. remplacer le texte en utilisant une/des expression(s)s régulière(s)s POSIX étendue(s)s (si définie(s) dans le trigger) - 3. exécuter le(s) commande(s) (si définie(s) dans le trigger) - 4. sortir avec le code retour (sauf pour les modificateurs, line, focus, info et info_hashtable) - 5. effectuer l'action "post" - -Exemples (vous pouvez aussi regarder les triggers par défaut avec /trigger listdefault) : - ajouter des attributs *gras*, _souligné_ et /italique/ (seulement dans les messages d'utilisateurs) : - /trigger add effects modifier weechat_print "${tg_tag_nick}" "==\*([^ ]+)\*==*${color:bold}${re:1}${color:-bold}*== ==_([^ ]+)_==_${color:underline}${re:1}${color:-underline}_== ==/([^ ]+)/==/${color:italic}${re:1}${color:-italic}/" - cacher la barre de pseudos sur les petits terminaux : - /trigger add resize_small signal signal_sigwinch "${info:term_width} < 100" "" "/bar hide nicklist" - /trigger add resize_big signal signal_sigwinch "${info:term_width} >= 100" "" "/bar show nicklist" - sauver silencieusement la configuration chaque heure : - /trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save" - sauver silencieusement la session WeeChat à minuit (voir /help upgrade) : - /trigger add session_save signal day_changed "" "" "/mute /upgrade -save" - ouvrir le tampon moniteur des triggers et afficher seulement les modificateurs et les triggers dont le nom commence par "resize" : - /trigger monitor @modifier,resize* ----- -// end::trigger_commands[] - -// tag::weechat_commands[] -[[command_weechat_allbuf]] -* `+allbuf+`: exécuter une commande sur tous les tampons - ----- -/allbuf <commande> - -commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/') - -Exemples : - définir le marqueur de lecture sur tous les tampons : - /allbuf /buffer set unread ----- - -[[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] - rename <nom> <nouveau_nom> - 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é) - rename : renommer une barre - 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 - add [-free] [-switch] <nom> - clear [<nombre>|<nom>|-merged|-all [<nombre>|<nom>...]] - move <nombre>|-|+ - swap <nombre1>|<nom1> [<nombre2>|<nom2>] - cycle <nombre>|<nom> [<nombre>|<nom>...] - merge <nombre>|<nom> - unmerge [<nombre>|-all] - hide [<nombre>|<nom>|-all [<nombre>|<nom>...]] - unhide [<nombre>|<nom>|-all [<nombre>|<nom>...]] - switch [-previous] - zoom - renumber <nombre1> [<nombre2> [<départ>]] - close [<n1>[-<n2>]|<nom>...] - notify [<niveau>] - listvar [<nombre>|<nom>] - setvar <nom> [<valeur>] - delvar <nom> - set <propriété> [<valeur>] - get <propriété> - jump smart|last_displayed|prev_visited|next_visited - <nombre>|-|+|<nom> - - list : lister les tampons ouverts (sans paramètre, cette liste est affichée) - add : ajouter un nouveau tampon (il peut être fermé avec "/buffer close" ou l'entrée "q") - 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é) - cycle : sauter en boucle entre une liste de plusieurs tampons - 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 - switch : basculer vers le tampon mélangé suivant (ou vers le tampon précédent avec -previous) - zoom : zoom sur le tampon mélangé -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 : afficher ou 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) - listvar : afficher la liste des variables locales d'un tampon - setvar : modifier une variable locale du tampon courant - delvar : supprimer une variable locale du tampon courant - set : modifier une propriété du tampon courant - get : afficher une propriété du tampon courant - jump : sauter vers un autre tampon : - smart : prochain tampon avec de l'activité - last_displayed : dernier tampon affiché (avant le dernier saut vers un tampon) - prev_visited : tampon visité précédemment - next_visited : tampon visité après - 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 - sauter sur #canal1, #canal2, #canal3 en boucle : - /buffer cycle #canal1 #canal2 #canal3 - mélanger avec le tampon core : - /buffer merge 1 - mélanger avec le tampon #weechat : - /buffer merge #weechat - 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) - -Autres touches par défaut dans le mode curseur : - flèche déplacer le curseur - alt+flèche déplacer le curseur vers la zone suivante - entrée sortir du mode curseur - -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+`: fonctions de debug - ----- -/debug list - set <extension> <niveau> - dump|hooks [<extension>] - buffer|certs|color|dirs|infolists|libs|memory|tags|term|windows - cursor|mouse [verbose] - hdata [free] - time <commande> - unicode <chaîne> - - 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) - hooks : afficher des infos sur les hooks (avec une extension : afficher les infos détaillées sur les hooks créés par l'extension) - buffer : afficher le contenu du tampon en valeurs hexadécimales dans le fichier log - certs : afficher le nombre de certificats des autorités de certification chargés - 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) -infolists : afficher des infos sur les infolists - key : activer le debug pour le clavier et la souris : afficher les codes bruts, le nom étendu et la commande associée ('q' pour quitter ce mode) - 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 - time : mesurer le temps pour exécuter une commande ou pour envoyer du texte au tampon courant - unicode : afficher des informations sur la chaîne et les caractères unicode (évaluée, voir /help eval) - -Exemples : - /debug set irc 1 - /debug mouse verbose - /debug time /filter toggle - /debug unicode ${chars:${\u26C0}-${\u26CF}} ----- - -[[command_weechat_eval]] -* `+eval+`: évaluer une expression - ----- -/eval [-n|-s] [-d [-d]] <expression> - [-n] [-d] -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) - -d : afficher la sortie de debug après l'évaluation (avec deux -d : mode debug plus verbeux) - -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 - ==* correspond au masque, sensible à la casse (le caractère joker "*" est autorisé) - !!* ne correspond PAS au masque, sensible à la casse (le caractère joker "*" est autorisé) - =* correspond au masque, insensible à la casse (le caractère joker "*" est autorisé) - != ne correspond PAS au masque, insensible à la casse (le caractère joker "*" est autorisé) - ==- est inclus, sensible à la casse - !!- n'est PAS inclus, sensible à la casse - =- est inclus, insensible à la casse - !- n'est PAS inclus, insensible à la casse - -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 nombres à virgule si les deux expressions sont des nombres valides, avec l'un de ces formats : - - entier (exemples : 5, -7) - - nombre à virgule (exemples : 5.2, -7.5, 2.83e-2) - - nombre hexadécimal (exemples : 0xA3, -0xA3) -Pour forcer une comparaison de chaînes, vous pouvez ajouter 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é : - - la chaîne elle-même sans évaluation (format : "raw:xxx") - - une variable définie par l'utilisateur (format : "nom") - - une sous-chaîne évaluée (format : "eval:xxx") - - une condition évaluée (format : "eval_cond:xxx") - - une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx") - - une chaîne avec un intervalle de caractères (format : "chars:xxx" ou "chars:c1-c2") - - une chaîne convertie en minuscules (format : "lower:xxx") - - une chaîne convertie en majuscules (format : "upper:xxx") - - une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne") - - une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne") - ou un maximum de caractères affichés à l'écran (format : "cutscr:max,suffixe,chaîne" ou "cutscr:+max,suffixe,chaîne") - - une chaîne inversée (format : "rev:xxx" ou "revscr:xxx") - - une chaîne répétée (format : "repeat:nombre,chaîne") - - longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx") - - découpage d'une chaîne (format : "split:nombre,séparateurs,flags,xxx") - - découpage de paramètres shell (format : "split_shell:nombre,xxx") - - une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color") - - un modificateur (format : "modifier:nom,données,chaîne") - - une info (format : "info:nom,paramètres", les paramètres sont optionnels) - - une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx") - - la date/heure courante (format : "date" ou "date:format") - - une variable d'environnement (format : "env:XXX") - - un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux") - - le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format : "calc:xxx") - - un nombre entier aléatoire (format : "random:min,max") - - une chaîne traduite (format : "translate:xxx") - - déclaration d'une variable utilisateur (format : "define:nom,valeur") - - une option (format : "fichier.section.option") - - une variable locale du tampon - - 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/pointeur/nom de pointeur, 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) - ${buffer[my_pointer].full_name} : nom complet du tampon avec ce nom de pointeur (peut être utilisé dans les triggers) - hdata[pointeur].var1.méthode() : lorsque var1 est une table de hachage, les méthodes "keys()", "values()", "keys_sorted()", "keys_values()" et "keys_values_sorted()" peuvent être appelées -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 ${raw:${info:version}} ==> ${info:version} - /eval -n ${eval_cond:${window.win_width}>100} ==> 1 - /eval -n ${info:version} ==> 0.4.3 - /eval -n ${env:HOME} ==> /home/user - /eval -n ${weechat.look.scroll_amount} ==> 3 - /eval -n ${sec.data.password} ==> secret - /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 ${buffer.local_variables.keys_values()} ==> plugin:core,name:weechat - /eval -n ${buffer.local_variables.plugin} ==> core - /eval -n ${\t} ==> <tab> - /eval -n ${chars:digit} ==> 0123456789 - /eval -n ${chars:J-T} ==> JKLMNOPQRST - /eval -n ${lower:TEST} ==> test - /eval -n ${upper:test} ==> TEST - /eval -n ${hide:-,${relay.network.password}} ==> -------- - /eval -n ${cut:3,+,test} ==> tes+ - /eval -n ${cut:+3,+,test} ==> te+ - /eval -n ${date:%H:%M:%S} ==> 07:46:40 - /eval -n ${if:${info:term_width}>80?big:small} ==> big - /eval -n ${rev:Hello} ==> olleH - /eval -n ${repeat:5,-} ==> ----- - /eval -n ${length:test} ==> 4 - /eval -n ${split:1,,,abc,def,ghi} ==> abc - /eval -n ${split:-1,,,abc,def,ghi} ==> ghi - /eval -n ${split:count,,,abc,def,ghi} ==> 3 - /eval -n ${split:random,,,abc,def,ghi} ==> def - /eval -n ${split_shell:1,"arg 1" arg2} ==> arg 1 - /eval -n ${split_shell:-1,"arg 1" arg2} ==> arg2 - /eval -n ${split_shell:count,"arg 1" arg2} ==> 2 - /eval -n ${split_shell:random,"arg 1" arg2} ==> arg2 - /eval -n ${calc:(5+2)*3} ==> 21 - /eval -n ${random:0,10} ==> 3 - /eval -n ${base_encode:64,test} ==> dGVzdA== - /eval -n ${base_decode:64,dGVzdA==} ==> test - /eval -n ${translate:Plugin} ==> Extension - /eval -n ${define:len,${calc:5+3}}${len}x${len} ==> 8x8 - -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 - /eval -n -c abcd =* a*d ==> 1 - /eval -n -c abcd =- bc ==> 1 ----- - -[[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|addreplace <nom> <tampon>[,<tampon>...] <étiquettes> <regex> - rename <nom> <nouveau_nom> - recreate <nom> - del <nom>|-all [<nom>...] - - 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 -addreplace : ajouter ou remplacer un filtre existant - rename : renommer un filtre - recreate : définir la ligne de commande utilisée pour modifier le 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.libera.#weechat" ou "irc.server.libera") - - "*" 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 globalement et alt+'-' active/désactive le filtrage sur le tampon courant. - -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, - self_msg, 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.libera.#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.libera.#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_hotlist]] -* `+hotlist+`: gestion de la hotlist - ----- -/hotlist add [low|message|private|highlight] - clear [<niveau>] - remove - restore [-all] - - add : ajouter le tampon courant dans la hotlist (niveau par défaut : "low", les conditions définies dans l'option weechat.look.hotlist_add_conditions ne sont PAS vérifiées) - clear : effacer la hotlist - niveau : "lowest" pour effacer seulement le plus petit niveau dans la hotlist, "highest" pour effacer seulement le niveau le plus haut dans la hotlist, ou un masque de niveaux : entier qui est une combinaison de 1=join/part, 2=message, 4=privé, 8=highlight - remove : supprimer le tampon courant de la hotlist -restore : restaurer la dernière hotlist supprimée dans le tampon courant (ou tous les tampons avec -all) ----- - -[[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_previous_word_whitespace : effacer le mot précédent (jusqu'à un espace) - delete_next_word : effacer le mot suivant - delete_beginning_of_line : effacer du début de la ligne jusqu'au curseur - delete_beginning_of_input : effacer du début de la ligne de commande jusqu'au curseur - delete_end_of_line : effacer du curseur jusqu'à la fin de la ligne - delete_end_of_input : effacer du curseur jusqu'à la fin de la ligne de commande - delete_line : effacer la ligne courante - delete_input : effacer la ligne de commande entière - clipboard_paste : coller depuis le presse-papiers interne - 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_beginning_of_input : déplacer le curseur au début de la ligne de commande - move_end_of_line : déplacer le curseur à la fin de la ligne - move_end_of_input : déplacer le curseur à la fin de la ligne de commande - 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 - move_previous_line : déplacer le curseur sur la ligne précédente - move_next_line : déplacer le curseur sur la ligne suivante - 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 - 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 - 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 - -Cette commande est utilisée par les associations de touches ou les extensions. ----- - -[[command_weechat_item]] -* `+item+`: gestion des objets de barre personnalisés - ----- -/item list - add|addreplace <nom> "<conditions>" "<contenu>" - rename <nom> <nouveau_nom> - refresh <nom> [<nom>...] - recreate <nom> - del <nom>|-all - - list : lister tous les objets de barre personnalisés - add : ajouter un objet de barre personnalisé -addreplace : ajouter ou remplacer un objet de barre personnalisé existant - nom : nom de l'objet de barre personnalisé -conditions : conditions évaluées pour afficher l'objet de barre (par exemple pour afficher l'objet de barre seulement sur certains tampons) - contenu : contenu (évalué, voir /help eval) - rename : renommer un objet de barre personnalisé - refresh : mettre à jour le contenu d'un objet de barre personnalisé dans toutes les barres où l'objet est affiché ; tout objet peut être rafraîchi : défaut/extension/objets de barre personnalisés - recreate : définir la ligne de commande utilisée pour éditer l'objet de barre personnalisé - del : supprimer un objet de barre personnalisé - -all : supprimer tous les objets de barre personnalisés - -Exemples : - ajouter un objet avec la taille du terminal, affiché seulement sur les tampons avec numéro = 1 : - /item add terminfo "${buffer.number} == 1" "term:${info:term_width}x${info:term_height}" - ajouter un objet avec des informations sur le tampon : - /item add bufinfo "" "${buffer.number}:${buffer.name}${if:${buffer.zoomed}?(Z)}" - ajouter un objet avec la date/heure en utilisant le format "Dec 25, 12:34 +0100", rafraîchi chaque minute : - /item add datetime "" "${date:%b %d, %H:%M %z}" - /trigger add datetime_refresh timer "60000;60" "" "" "/item refresh datetime" - ajouter un objet avec le nombre de lignes dans le tampon (affichées/total), rafraîchi à chaque nouvelle ligne affichée ou si les lignes filtrées ont changé : - /item add lines_count "" "${calc:${buffer.lines.lines_count}-${buffer.lines.lines_hidden}}/${buffer.lines.lines_count} lines" - /trigger add lines_count_refresh_print print "" "" "" "/item refresh lines_count" - /trigger add lines_count_refresh_signal signal "window_switch;buffer_switch;buffer_lines_hidden;filters_*" "" "" "/item refresh lines_count" - forcer le rafraîchissement de l'objet "lines_count" : - /item refresh lines_count - recréer l'objet "lines_count" avec différentes conditions ou contenu : - /item recreate lines_count - supprimer l'objet "lines_count" : - /item del lines_count ----- - -[[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>] - legacy <touche> [<touche>...] - - 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 être 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 - legacy : afficher le nouveau nom pour des anciennes touches - -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. - -Modificateurs autorisés (dans cet ordre lorsque plusieurs sont utilisés) : - meta- (touche alt) - ctrl- (touche control) - shift- (touche shift, peut être utilisé seulement avec les noms de touches ci-dessous) - -Noms de touches autorisés : f0 à f20, home, insert, delete, end, backspace, pgup, pgdn, up, down, right, left, tab, return, comma, space. - -La virgule est utilisée pour séparer plusieurs touches. - -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-r pour aller sur le canal IRC #weechat : - /key bind meta-r /buffer #weechat - restaurer l'association par défaut pour la touche alt-r : - /key reset meta-r - touche meta-v puis f1 pour lancer /help : - /key bind meta-v,f1 /help - 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". - -Note : la disposition se souvient seulement de la division des fenêtres et des numéros de tampons. Elle n'ouvre pas les tampons. Cela signifie par exemple que vous devez toujours automatiquement rejoindre les canaux IRC pour ouvrir les tampons, la disposition sauvée ne s'applique qu'une fois les tampons ouverts. ----- - -[[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.libera", "irc.libera.#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.libera.#weechat msg #weechat bonjour ! ----- - -[[command_weechat_plugin]] -* `+plugin+`: lister/charger/décharger des extensions - ----- -/plugin list [-o|-ol|-i|-il|<nom>] - listfull [<nom>] - load <fichier> [<paramètres>] - autoload [<paramètres>] - reload [<nom>|* [<paramètres]] - unload [<nom>] - - list : lister les extensions chargées - -o : envoyer la liste des extensions chargées au tampon (chaîne en anglais) - -ol : envoyer la liste des extensions chargées au tampon (chaîne traduite) - -i : copier la liste des extensions chargées dans la ligne de commande (pour envoi au tampon) (chaîne en anglais) - -il : copier la liste des extensions chargées dans la ligne de commande (pour envoi au tampon) (chaîne traduite) - nom : nom d'extension - listfull : lister les extensions chargées (verbeux) - load : charger une extension - fichier : extension (fichier) à charger -paramètres : paramètres donnés à l'extension lors de son chargement - 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) - -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>] [-newbuffer <nom>] [-free] [-switch] [-core|-current] [-y <ligne>] [-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) --newbuffer : créer un nouveau tampon et afficher le texte dans ce tampon - -free : créer un tampon avec contenu libre (avec -newbuffer seulement) - -switch : basculer vers le tampon - -core : alias de "-buffer core.weechat" - -current : afficher le texte dans le tampon courant - -y : afficher sur une ligne personnalisée (pour un tampon avec contenu libre seulement) - ligne : numéro de ligne pour un tampon avec contenu libre (la première ligne est 0, un nombre négatif affiche après la dernière ligne : -1 = après la dernière ligne, -2 = deux lignes après la dernière ligne, etc.) - -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.libera.#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>[<unité>]] <nombre> <commande> - - délai : délai entre l'exécution des commandes - unité : optionnelle, valeurs possibles : - ms : millisecondes - s : secondes (par défaut) - m : minutes - h : heures - nombre : nombre de fois que la commande sera exécutée -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ù /repeat a été exécuté (si le tampon n'existe plus, la commande n'est pas exécutée). - -Exemple : - faire défiler de 2 pages vers le haut : - /repeat 2 /window page_up ----- - -[[command_weechat_reset]] -* `+reset+`: réinitialiser des options de configuration - ----- -/reset <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 !) - -Exemples : - réinitialiser une option : - /reset weechat.look.item_time_format - réinitialiser toutes les options de couleur : - /reset -mask weechat.color.* ----- - -[[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. - -Les touches sur le tampon des données sécurisées : - alt+v afficher/cacher les valeurs - -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) ou de définir l'option sec.crypt.passphrase_command pour lire la phrase de chiffrement depuis la sortie d'une commande externe comme un coffre-fort à mots de passe (voir /help sec.crypt.passphrase_command). - -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 - utiliser le programme "pass" pour lire la phrase de chiffrement au démarrage : - /set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase" - chiffrer le mot de passe libera SASL : - /secure set libera motdepasse - /set irc.server.libera.sasl_password "${sec.data.libera}" - 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 libera nickserv ghost pseudo ${sec.data.libera} ----- - -[[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é pour lister les options, si aucune valeur n'est spécifiée) -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_toggle]] -* `+toggle+`: basculer la valeur d'une option de configuration - ----- -/toggle <option> [<valeur> [<valeur>...]] - -option : nom d'une option -valeur : valeurs possibles pour l'option (les valeurs sont découpées comme le les paramètres d'une commande par le shell : des guillemets peuvent être utilisés pour préserver les espaces au début et à la fin des valeurs) - -Comportement : - - seule une option de type booléen ou chaîne peut être basculée sans valeur : - - booléen : basculer on/off selon la valeur courante - - chaîne : basculer entre chaîne vide et la valeur par défaut (fonctionne seulement si une chaîne vide est autorisée pour l'option) - - avec une seule valeur donnée, basculer entre cette valeur et la valeur par défaut de l'option - - avec plusieurs valeurs données, basculer entre les valeurs : la valeur utilisée est celle qui suit la valeur courante de l'option ; si la valeur courante n'est pas dans la liste, la première valeur de la liste est utilisée - - la valeur spéciale "null" peut être donnée, mais seulement comme première valeur dans la liste et sans guillemets autour. - -Exemples : - basculer l'affichage de l'heure dans la zone de discussion (sans afficher la nouvelle valeur utilisée) : - /mute /toggle weechat.look.buffer_time_format - basculer le format de l'heure dans la zone de discussion (avec secondes, sans secondes, désactivé) : - /toggle weechat.look.buffer_time_format "%H:%M:%S" "%H:%M" "" - basculer le "join" automatique du canal #weechat sur le serveur libera : - /toggle irc.server.libera.autojoin null #weechat ----- - -[[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+`: sauvegarder la session WeeChat et relancer le binaire WeeChat sans se déconnecter des serveurs - ----- -/upgrade [-yes] [<chemin_vers_binaire>|-save|-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") - -save : sauvegarder seulement la session, ne pas quitter ni relancer WeeChat ; les fichiers de configuration ne sont pas sauvegardés (si besoin vous pouvez utiliser /save avant cette commande) - -quit : fermer *TOUTES* les connexions, sauvegarder 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. - -Important : l'utilisation de l'option -save peut être dangereuse, il est recommandé d'utiliser seulement /upgrade (ou avec -quit) pour une mise à jour standard et un redémarrage ; l'option -save peut être utilisée pour sauvegarder régulièrement la session et la restaurer en cas de sortie anormale (panne de courant, crash, etc.). - -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 le suivant : - 1. fermer *TOUTES* les connexions - 2. sauvegarder la session (fichiers *.upgrade) - 3. décharger les extensions - 4. sauvegarder la configuration WeeChat - 5. quitter WeeChat - -Avec l'option "-save", le processus est le suivant : - 1. sauvegarder la session (fichiers *.upgrade) avec un état déconnecté pour les serveurs IRC et les clients Relay (mais aucune déconnexion n'est faite) - -Avec "-quit" ou "-save", vous pouvez restaurer la session plus tard avec cette commande : weechat --upgrade -IMPORTANT : vous devez restaurer la session avec exactement la même configuration (fichiers *.conf) et si possible la même version de WeeChat (ou une plus récente). -Il est également possible de restaurer la session WeeChat sur une autre machine si vous y copiez le contenu des répertoires personnels de WeeChat (voir /debug dirs). ----- - -[[command_weechat_uptime]] -* `+uptime+`: montrer la durée de fonctionnement de WeeChat - ----- -/uptime [-o|-ol] - - -o : envoyer la durée de fonctionnement sur le tampon courant comme entrée (chaîne en anglais) --ol : envoyer la durée de fonctionnement 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'existe plus, la commande n'est pas exécutée). - -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>] [h|v][+|-]<pct> - balance - merge [-window <numéro>] [all] - close [-window <numéro>] - 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 (pour défaire : /window merge) - splitv : éclater la fenêtre en deux verticalement (pour défaire : /window merge) - resize : redimensionner une fenêtre, la nouvelle taille est <pct> pourcentage de la fenêtre parente - si "h" ou "v" est spécifié, le redimensionnement affecte la fenêtre parente la plus proche avec un découpage de ce type (horizontal/vertical) - balance : équilibrer la taille de toutes les fenêtres - merge : fusionner la fenêtre avec une autre - close : fermer la fenêtre - 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 lecture - 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 - éclater la fenêtre horizontalement en utilisant 30% de l'espace pour la fenêtre du haut : - /window splith 30 - redimensionner la fenêtre à 75% de la taille de la fenêtre parente : - /window resize 75 - redimensionner le découpage vertical, ajouter 10% dans la taille : - /window resize v+10 - supprimer l'éclatement, garder la fenêtre courante : - /window merge - fermer la fenêtre courante : - /window close - activer le mode d'affichage dépouillé pendant 2 secondes : - /window bare 2 ----- -// end::weechat_commands[] - -// tag::xfer_commands[] -[[command_xfer_me]] -* `+me+`: envoyer une action CTCP à l'hôte distant - ----- -/me <message> - -message : message à envoyer ----- - -[[command_xfer_xfer]] -* `+xfer+`: contrôle xfer - ----- -/xfer [list|listfull] - - list : lister les xfer -listfull : lister les xfer (verbeux) - -Sans paramètre, cette commande ouvre le tampon avec la liste des xfer. ----- -// end::xfer_commands[] |