diff options
Diffstat (limited to 'doc/it')
| -rw-r--r-- | doc/it/autogen/plugin_api/hdata.txt | 3 | ||||
| -rw-r--r-- | doc/it/autogen/user/weechat_commands.txt | 63 | ||||
| -rw-r--r-- | doc/it/weechat_plugin_api.it.txt | 124 | ||||
| -rw-r--r-- | doc/it/weechat_scripting.it.txt | 3 |
4 files changed, 162 insertions, 31 deletions
diff --git a/doc/it/autogen/plugin_api/hdata.txt b/doc/it/autogen/plugin_api/hdata.txt index 7161912b2..aa0f878fa 100644 --- a/doc/it/autogen/plugin_api/hdata.txt +++ b/doc/it/autogen/plugin_api/hdata.txt @@ -405,6 +405,9 @@ | weechat | key | un tasto (scorciatoia da tastiera) | 'key' (string) + + 'area_type' (pointer) + + 'area_name' (pointer) + + 'area_key' (string) + 'command' (string) + 'prev_key' (pointer, hdata: 'key') + 'next_key' (pointer, hdata: 'key') | diff --git a/doc/it/autogen/user/weechat_commands.txt b/doc/it/autogen/user/weechat_commands.txt index df0998a2d..337218b76 100644 --- a/doc/it/autogen/user/weechat_commands.txt +++ b/doc/it/autogen/user/weechat_commands.txt @@ -341,42 +341,43 @@ Questo comando viene usato dall'associazione tasti o dai plugin. resetall -yes [<contesto>] missing [<contesto>] - list: elenca tutti i tasti correnti (senza argomento, viene visualizzata questa lista) -listdefault: elenca i tasti predefiniti - listdiff: elenca le differenze tra tasti attuali e predefiniti (tasti aggiunti, ridefiniti o eliminati) - contesto: nome del contesto ("default" oppure "search") - bind: associa un comando ad un tasto o visualizza il comando associato al tasto (per il contesto "default") - bindctxt: associa un comando ad un tasto o mostra il comando associato al tasto, per il contesto fornito - unbind: rimuove una associazione di tasti (per il contesto "default") - unbindctxt: rimuove l'associazione tasti per il contesto fornito - reset: ripristina un tasto all'assegnazione predefinita - resetctxt: ripristina un tasto all'associazione predefinita per il contesto fornito - resetall: ripristina le associazioni ai valori predefiniti ed elimina TUTTE le associazioni personalizzate (usare con cautela!) - missing: aggiunge tasti mancanti (utilizzando le associazioni predefinite), utile dopo l'installazione di una nuova versione di WeeChat - -Al momento di associare un comando ad un tasto si raccomanda di utilizzare il tasto alt+k (oppure Esc e k), e digitare il tasto da associare: il codice tasto verrà inserito nella riga di comando. - -Per il contesto "mouse" (possibile anche nel contesto "cursor"), il formato del tasto è: "@area:tasto" oppure "@area1>area2:tasto" dove area può essere: - *: qualunque area sullo schermo - chat: area di chat (qualunque buffer) - chat(xxx): area di chat per il buffer con il nome "xxx" (nome completo includendo il plugin) - bar(*): qualunque barra - bar(xxx): barra "xxx" - item(*): qualunque elemento barra - item(xxx): elemento barra "xxx" -Il tasto può iniziare o terminare con '*' per corrispondere a più eventi del mouse. -Un valore speciale per questo comando con il formato "hsignal:nome" può essere usato per il contesto del mouse, e invierà hsignal "nome" con la tabella hash di focuse come argomento. + list: list all current keys (without argument, this list is displayed) +listdefault: list default keys + listdiff: list differences between current and default keys (keys added, redefined or deleted) + context: name of context ("default" or "search") + bind: bind a command to a key or display command bound to key (for context "default") + bindctxt: bind a command to a key or display command bound to key, for given context + unbind: remove a key binding (for context "default") + unbindctxt: remove a key binding for given context + reset: reset a key to default binding (for context "default") + resetctxt: reset a key to default binding, for given context + resetall: restore bindings to the default values and delete ALL personal bindings (use carefully!) + missing: add missing keys (using default bindings), useful after installing new WeeChat version + +When binding a command to a key, it is recommended to use key alt+k (or Esc then k), and then press the key to bind: this will insert key code in command line. + +For context "mouse" (possible in context "cursor" too), key has format: "@area:key" or "@area1>area2:key" where area can be: + *: any area on screen + chat: chat area (any buffer) + chat(xxx): char area for buffer with name "xxx" (full name including plugin) + bar(*): any bar + bar(xxx): bar "xxx" + item(*): any bar item + item(xxx): bar item "xxx" +The key can start or end with '*' to match many mouse events. +A special value for command wit format "hsignal:name" can be used for context mouse, this will send the hsignal "name" with the focus hashtable as argument. +Another special value "-" can be used to disable key (it will be ignored when looking for keys). -Esempi: - il tasto alt-x per alternare la barra della nicklist: +Examples: + key alt-x to toggle nicklist bar: /key bind meta-x /bar toggle nicklist - il tasto alt-r per passare al canale IRC #weechat: + key alt-r to jump to #weechat IRC channel: /key bind meta-r /buffer #weechat - ripristinare l'associazione predefinita per il tasto alt-r: + restore default binding for key alt-r: /key reset meta-r - il tasto "tab" per fermare la ricerca nel buffer: + key "tab" to stop search in buffer: /key bindctxt search ctrl-I /input search_stop - il tasto centrale del mouse su un nick per ottenere le informazioni: + middle button of mouse on a nick to retrieve info on nick: /key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick} ........................................ diff --git a/doc/it/weechat_plugin_api.it.txt b/doc/it/weechat_plugin_api.it.txt index 0148f89ca..5ea8a2446 100644 --- a/doc/it/weechat_plugin_api.it.txt +++ b/doc/it/weechat_plugin_api.it.txt @@ -5685,6 +5685,130 @@ elif rc == weechat.WEECHAT_CONFIG_OPTION_UNSET_ERROR: # ... ---------------------------------------- +// TRANSLATION MISSING +[[key_bindings]] +Key bindings +~~~~~~~~~~~~ + +Functions for key bindings. + +// TRANSLATION MISSING +weechat_key_bind +^^^^^^^^^^^^^^^^ + +Add new key bindings. + +[NOTE] +Unlike command `/key bind`, this function will never change an existing key +binding, only new keys are created. To remove a key binding, use +<<_weechat_key_unbind,weechat_key_unbind>>. + +Prototype: + +[source,C] +---------------------------------------- +int weechat_key_bind (const char *context, struct t_hashtable *keys); +---------------------------------------- + +Arguments: + +* 'context': context for keys: +** 'default': default context (common actions) +** 'search': search context (when searching text in buffer) +** 'cursor': free movement of cursor on screen +** 'mouse': keys for mouse events +* 'keys': hashtable with key bindings + +Return value: + +* number of key bindings added + +C example: + +[source,C] +---------------------------------------- +struct t_hashtable *keys = weechat_hashtable_new (8, + WEECHAT_HASHTABLE_STRING, + WEECHAT_HASHTABLE_STRING, + NULL, + NULL); +if (keys) +{ + weechat_hashtable_set (keys, "@chat(plugin.buffer):button1", "hsignal:test_mouse"); + weechat_hashtable_set (keys, "@chat(plugin.buffer):wheelup", "/mycommand up"); + weechat_hashtable_set (keys, "@chat(plugin.buffer):wheeldown", "/mycommand down"); + weechat_key_bind ("mouse", keys); + weechat_hashtable_free (keys); +} +---------------------------------------- + +Script (Python): + +[source,python] +---------------------------------------- +# prototype +num_keys = weechat.key_bind(context, keys) + +# example +keys = { "@chat(python.test):button1": "hsignal:test_mouse", + "@chat(python.test):wheelup": "/mycommand up", + "@chat(python.test):wheeldown": "/mycommand down" } +weechat.key_bind("mouse", keys) +---------------------------------------- + +// TRANSLATION MISSING +weechat_key_unbind +^^^^^^^^^^^^^^^^^^ + +Remove key binding(s). + +[WARNING] +When calling this function, ensure that you will not remove a user key binding. + +Prototype: + +[source,C] +---------------------------------------- +int weechat_key_unbind (const char *context, const char *key); +---------------------------------------- + +Arguments: + +* 'context': context for keys (see <<_weechat_key_bind,weechat_key_bind>>) +* 'key': key to remove or a special value "area:XXX" to remove all keys having + 'XXX' as first or second area + +Return value: + +* number of key bindings removed + +C examples: + +[source,C] +---------------------------------------- +/* remove a single key */ +weechat_key_unbind ("mouse", "@chat(plugin.buffer):button1"); + +/* remove all keys with area "chat(plugin.buffer)" */ +weechat_key_unbind ("mouse", "area:chat(plugin.buffer)"); +---------------------------------------- + +Script (Python): + +[source,python] +---------------------------------------- +# prototype +num_keys = weechat.key_unbind(context, key) + +# examples + +# remove a single key +weechat.key_unbind("mouse", "@chat(plugin.buffer):button1") + +# remove all keys with area "chat(python.test)" +weechat.key_unbind("mouse", "area:chat(python.test)") +---------------------------------------- + [[display]] Visualizzazione ~~~~~~~~~~~~~~~ diff --git a/doc/it/weechat_scripting.it.txt b/doc/it/weechat_scripting.it.txt index d631c09f4..982cbc3da 100644 --- a/doc/it/weechat_scripting.it.txt +++ b/doc/it/weechat_scripting.it.txt @@ -275,6 +275,9 @@ Elenco di funzioni nelle API per gli script: config_free, + config_get, config_get_plugin, config_is_set_plugin, config_set_plugin, config_set_desc_plugin, config_unset_plugin +// TRANSLATION MISSING +| key bindings | + key_bind, key_unbind | visualizzazione | prefix, color, print (for python: prnt), print_date_tags (for python: prnt_date_tags), print_y (for python: prnt_y), log_print |