89 lines
4.9 KiB
Plaintext
89 lines
4.9 KiB
Plaintext
//
|
|
// This file is auto-generated by script docgen.py.
|
|
// DO NOT EDIT BY HAND!
|
|
//
|
|
[[command_trigger_trigger]]
|
|
* `+trigger+`: zarządzaj triggerami, scyzorykiem WeeChat
|
|
|
|
----
|
|
/trigger list|listfull|listdefault
|
|
add|addoff|addreplace <nazwa> <hook> ["<argumenty>" ["<warunki>" ["<regex>" ["<komenda>" ["<zwracany_kod>" ["<post_action>"]]]]]]
|
|
addinput [<hook>]
|
|
input|output|recreate <nazwa>
|
|
set <nazwa> <opcja> <wartość>
|
|
rename|copy <nazwa> <nowa_nazwa>
|
|
enable|disable|toggle [<nazwa>|-all [<nazwa>...]]
|
|
restart <nazwa>|-all [<nazwa>...]
|
|
show <nazwa>
|
|
del <nazwa>|-all [<nazwa>...]
|
|
restore <nazwa> [<nazwa>...]
|
|
default -yes
|
|
monitor [<filtr>]
|
|
|
|
list: list triggers (without argument, this list is displayed)
|
|
listfull: list triggers with detailed info for each trigger
|
|
listdefault: list default triggers
|
|
add: add a trigger
|
|
addoff: add a trigger (disabled)
|
|
addreplace: add or replace an existing trigger
|
|
name: name of trigger
|
|
hook: signal, hsignal, modifier, line, print, command, command_run, timer, config, focus, info, info_hashtable
|
|
arguments: arguments for the hook, depending on hook (separated by semicolons):
|
|
signal: name(s) of signal (required)
|
|
hsignal: name(s) of hsignal (required)
|
|
modifier: name(s) of modifier (required)
|
|
line: buffer type ("formatted", "free" or "*"), list of buffer masks, tags
|
|
print: buffer, tags, message, strip colors
|
|
command: command (required), description, arguments, description of arguments, completion (all arguments except command are evaluated, see /help eval)
|
|
command_run: command(s) (required)
|
|
timer: interval (required), align on second, max calls
|
|
config: name(s) of option (required)
|
|
focus: name(s) of area (required)
|
|
info: name(s) of info (required)
|
|
info_hashtable: name(s) of info (required)
|
|
conditions: evaluated conditions for the trigger
|
|
regex: one or more regular expressions to replace strings in variables
|
|
command: command to execute (many commands can be separated by ";")
|
|
return_code: return code in callback (ok (default), ok_eat, error)
|
|
post_action: action to take after execution (none (default), disable, delete)
|
|
addinput: set input with default arguments to create a trigger
|
|
input: set input with the command used to create the trigger
|
|
output: send the command to create the trigger on the buffer
|
|
recreate: same as "input", with option "addreplace" instead of "add"
|
|
set: set an option in a trigger
|
|
option: name of option: name, hook, arguments, conditions, regex, command, return_code
|
|
(for help on option, you can type: /help trigger.trigger.<name>.<option>)
|
|
value: new value for the option
|
|
rename: rename a trigger
|
|
copy: copy a trigger
|
|
enable: enable trigger(s) (without arguments: enable triggers globally)
|
|
disable: disable trigger(s) (without arguments: disable triggers globally)
|
|
toggle: toggle trigger(s) (without arguments: toggle triggers globally)
|
|
restart: restart trigger(s) (recreate the hooks)
|
|
show: show detailed info on a trigger (with some stats)
|
|
del: delete a trigger
|
|
-all: do action on all triggers
|
|
restore: restore trigger(s) with the default values (works only for default triggers)
|
|
default: delete all triggers and restore default ones
|
|
monitor: open the trigger monitor buffer, with optional filter:
|
|
filter: filter hooks/triggers to display (a hook must start with "@", for example "@signal"), many filters can be separated by commas; wildcard "*" is allowed in each trigger name
|
|
|
|
When a trigger callback is called, following actions are performed, in this order:
|
|
1. check conditions; if false, exit
|
|
2. replace text using POSIX extended regular expression(s) (if defined in trigger)
|
|
3. execute command(s) (if defined in trigger)
|
|
4. exit with a return code (except for modifier, line, focus, info and info_hashtable)
|
|
5. perform post action
|
|
|
|
Examples (you can also look at default triggers with /trigger listdefault):
|
|
add text attributes *bold*, _underline_ and /italic/ (only in user messages):
|
|
/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}/"
|
|
hide nicklist bar on small terminals:
|
|
/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"
|
|
silently save config each hour:
|
|
/trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save"
|
|
open trigger monitor and show only modifiers and triggers whose name starts with "resize":
|
|
/trigger monitor @modifier,resize*
|
|
----
|