89 lines
5.8 KiB
Plaintext
89 lines
5.8 KiB
Plaintext
//
|
||
// This file is auto-generated by script docgen.py.
|
||
// DO NOT EDIT BY HAND!
|
||
//
|
||
[[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, 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 la configuration chaque heure (de manière silencieuse) :
|
||
/trigger add cfgsave timer 3600000;0;0 "" "" "/mute /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*
|
||
----
|