From 160ffe8e11452a415f5e42916be4d369926fbc2b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= Date: Sun, 5 Dec 2021 17:43:33 +0100 Subject: doc: move sections "Exec", "Fifo" and "Trigger" at top level after "Relay" (user's guide) --- doc/it/weechat_user.it.adoc | 873 ++++++++++++++++++++++---------------------- 1 file changed, 437 insertions(+), 436 deletions(-) (limited to 'doc/it') diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index 83dd5077e..e97e163eb 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -255,10 +255,10 @@ List of commonly used options: Compile <> with Enchant. | ENABLE_EXEC | `ON`, `OFF` | ON | - Compile <>. + Compile <>. | ENABLE_FIFO | `ON`, `OFF` | ON | - Compile <>. + Compile <>. | ENABLE_FSET | `ON`, `OFF` | ON | Compile <>. @@ -320,7 +320,7 @@ List of commonly used options: Compile <>. | ENABLE_TRIGGER | `ON`, `OFF` | ON | - Compile <>. + Compile <>. | ENABLE_TYPING | `ON`, `OFF` | ON | Compile <>. @@ -4370,94 +4370,20 @@ Options: include::includes/autogen_user_options.it.adoc[tag=relay_options] -[[plugins]] -== Plugin - -Un plugin è una libreria dinamica, scritta in C e compilata, che viene caricata -da WeeChat. -In GNU/Linux, il file ha estensione ".so", ".dll" in Windows. - -I plugin trovati vengono caricati automaticamente all'avvio di WeeChat, ed -è possibile caricare o scaricare i plugin durante l'esecuzione del programma. - -È importante evidenziare la differenza tra un _plugin_ ed uno _script_: un -_plugin_ è un file binario compilato e caricato con il comando `/plugin`, -mentre uno _script_ è un file di testo caricato con un plugin come _python_ -con il comando `/python`. - -È possibile utilizzare il comando `/plugin` per caricare/scaricare un plugin, -oppure elencare tutti i plugin caricati. - -// TRANSLATION MISSING -When a plugin is unloaded, WeeChat removes: - -* buffers -* configuration options (options are written in files) -* all hooks: commands, modifiers, process, etc. -* infos and infolists -* hdata -* bar items. - -Esempi per caricare, scaricare oppure elencare i plugin: - ----- -/plugin load irc -/plugin unload irc -/plugin list ----- - -I plugin predefiniti sono: - -[width="100%",cols="1,5",options="header"] -|=== -| Plugin | Descrizione -| alias | Definisce gli alias per i comandi. -// TRANSLATION MISSING -| buflist | Bar item with list of buffers. -| charset | Set di caratteri per la codifica/decodifica nei buffer. -// TRANSLATION MISSING -| exec | Execution of external commands in WeeChat. -| fifo | pipe FIFO utilizzata per inviare comandi da remoto su WeeChat. -// TRANSLATION MISSING -| fset | Fast set of WeeChat and plugins options. -| irc | protocollo chat per IRC. -| logger | Registra i buffer su file. -| relay | Relay dei dati via rete. -| script | Gestore script. -| python | API per lo scripting in Python. -| perl | API per lo scripting in Perl. -| ruby | API per lo scripting in Ruby. -| lua | API per lo scripting in Lua. -| tcl | API per lo scripting in TCL. -| guile | API per lo scripting in Guile (scheme). -| javascript | API per lo scripting in JavaScript. -| php | API per lo scripting in PHP. -| spell | Controllo ortografico per la riga di comando. -// TRANSLATION MISSING -| trigger | Text replacement and command execution on events triggered by WeeChat/plugins. -// TRANSLATION MISSING -| typing | Display users currently writing messages. -| xfer | Trasferimento file e chat diretta. -|=== - -Per saperne di più riguardo lo sviluppo di plugin o script (tramite le API), per -favore consultare link:weechat_plugin_api.it.html[Riferimento API dei Plugin per WeeChat] -oppure link:weechat_scripting.it.html[Guida allo Scripting di WeeChat]. - // TRANSLATION MISSING -[[exec_plugin]] -=== Exec +[[external_commands]] +== External commands The `/exec` command lets you execute external commands inside WeeChat and display the output locally, or send it to a buffer. [[exec_commands]] -==== Comandi +=== Comandi include::includes/autogen_user_commands.it.adoc[tag=exec_commands] [[exec_options]] -==== Opzioni +=== Opzioni // TRANSLATION MISSING Sections in file _exec.conf_: @@ -4473,8 +4399,9 @@ Options: include::includes/autogen_user_options.it.adoc[tag=exec_options] -[[fifo_plugin]] -=== Fifo +// TRANSLATION MISSING +[[fifo_pipe]] +== FIFO pipe È possibile controllare da remoto WeeChat, inviando comandi o del testo ad una pipe FIFO (se l'opzione "fifo.file.enabled" è abilitata, e lo è per default). @@ -4521,12 +4448,12 @@ $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/wee ---- [[fifo_commands]] -==== Comandi +=== Comandi include::includes/autogen_user_commands.it.adoc[tag=fifo_commands] [[fifo_options]] -==== Opzioni +=== Opzioni // TRANSLATION MISSING Sections in file _fifo.conf_: @@ -4544,367 +4471,132 @@ Options: include::includes/autogen_user_options.it.adoc[tag=fifo_options] // TRANSLATION MISSING -[[scripts_plugins]] -=== Scripts - -WeeChat fornisce 8 plugin per lo scripting: Python, Perl, Ruby, Lua, Tcl, Guile -(scheme), JavaScript, PHP. -Questi plugin possono caricare, eseguire e scaricare gli script per questi -linguaggi. +[[trigger]] +== Trigger -// TRANSLATION MISSING -Another plugin called "script" is a script manager and is used to load/unload -scripts of any language, and install/remove scripts of WeeChat scripts -repository, which are visible at this URL: https://weechat.org/scripts +Trigger is the Swiss Army knife for WeeChat: it can hook many things (signal, +modifier, print, ...), change the content of data, and execute one or more +commands. A condition can be used to prevent the trigger to run in some +circumstances. -Per maggiori informazioni su come scrivere gli script, o le API WeeChat -per gli script, consultare la link:weechat_scripting.it.html[Guida allo Scripting di WeeChat]. +Using triggers require you to know how the signals, modifiers, ... are working. +So you might consider reading the +link:weechat_plugin_api.it.html#hooks[WeeChat plugin API reference / Hooks]. -[[script_commands]] -==== Comandi Script +[[trigger_default]] +=== Default triggers -include::includes/autogen_user_commands.it.adoc[tag=script_commands] +WeeChat creates 5 triggers by default, which can be disabled, updated or +deleted: -[[python_commands]] -==== Comandi Python +* a _beep_ trigger for notifications +* four other triggers to hide passwords on screen -include::includes/autogen_user_commands.it.adoc[tag=python_commands] +List of default triggers: -[[perl_commands]] -==== Comandi Perl +[width="100%",cols="5m,3,22",options="header"] +|=== +| Name | Hook | Description -include::includes/autogen_user_commands.it.adoc[tag=perl_commands] +| beep | print | + Beep on highlight/private message. -[[ruby_commands]] -==== Comandi Ruby +| cmd_pass | modifier | + Hide password in commands: + `pass:[/msg nickserv id\|identify\|set password\|ghost\|release\|regain\|recover]`, + `pass:[/oper]`, + `pass:[/quote pass]`, + `pass:[/secure passphrase\|decrypt\|set]`. -include::includes/autogen_user_commands.it.adoc[tag=ruby_commands] +| cmd_pass_register | modifier | + Hide password in command `pass:[/msg nickserv register]`. -[[lua_commands]] -==== Comandi Lua +| msg_auth | modifier | + Hide password in IRC auth message displayed (message received from server + after the user issued the command). -include::includes/autogen_user_commands.it.adoc[tag=lua_commands] +| server_pass | modifier | + Hide server password in commands `/server` and `/connect`. +|=== -[[tcl_commands]] -==== Comandi Tcl +[[trigger_anatomy]] +=== Anatomy of a trigger -include::includes/autogen_user_commands.it.adoc[tag=tcl_commands] +A trigger has the following options (names are +`trigger.trigger..