diff options
author | Sébastien Helleu <flashcode@flashtux.org> | 2021-12-05 14:42:58 +0100 |
---|---|---|
committer | Sébastien Helleu <flashcode@flashtux.org> | 2021-12-05 20:59:19 +0100 |
commit | 66384544b551e5bf61de786590a8dfa7efed53d7 (patch) | |
tree | d45ce320a853da909c3172ba6a08ed29ce25e354 /doc/it | |
parent | c88428fb416fa1f0477e4a9f2542d06db239a749 (diff) | |
download | weechat-66384544b551e5bf61de786590a8dfa7efed53d7.zip |
doc: move section "IRC" at top level after "Configuration" (user's guide)
Diffstat (limited to 'doc/it')
-rw-r--r-- | doc/it/weechat_user.it.adoc | 388 |
1 files changed, 194 insertions, 194 deletions
diff --git a/doc/it/weechat_user.it.adoc b/doc/it/weechat_user.it.adoc index cfc6f644a..0c9abe41e 100644 --- a/doc/it/weechat_user.it.adoc +++ b/doc/it/weechat_user.it.adoc @@ -267,7 +267,7 @@ List of commonly used options: Compile <<scripts_plugins,Guile plugin>> (Scheme). | ENABLE_IRC | `ON`, `OFF` | ON | - Compile <<irc_plugin,IRC plugin>>. + Compile <<irc,IRC plugin>>. | ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF | Compile <<scripts_plugins,JavaScript plugin>>. @@ -2994,181 +2994,8 @@ Options: include::includes/autogen_user_options.it.adoc[tag=weechat_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 - -The `/exec` command lets you execute external commands inside WeeChat and -display the output locally, or send it to a buffer. - -[[exec_commands]] -==== Comandi - -include::includes/autogen_user_commands.it.adoc[tag=exec_commands] - -[[exec_options]] -==== Opzioni - -// TRANSLATION MISSING -Sections in file _exec.conf_: - -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| command | /set exec.command.* | Options for commands. -| color | /set exec.color.* | Colors. -|=== - -Options: - -include::includes/autogen_user_options.it.adoc[tag=exec_options] - -[[fifo_plugin]] -=== Fifo - -È 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). - -// TRANSLATION MISSING -The FIFO pipe is located in WeeChat runtime directory and is called -_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). - -La sintassi per i comandi/testo della pipe FIFO è una delle seguenti: - -.... - plugin.buffer *testo o comando qui - *testo o comando qui -.... - -Alcuni esempi: - -// TRANSLATION MISSING -* Change nick on IRC server libera to "newnick": - ----- -$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -// TRANSLATION MISSING -* Send a message on IRC #weechat channel: - ----- -$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -// TRANSLATION MISSING -* Send a message on current buffer: - ----- -$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -* Inviare due comandi per scaricare/caricare gli script Python (è necessario - separarli con "\n"): - ----- -$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 ----- - -[[fifo_commands]] -==== Comandi - -include::includes/autogen_user_commands.it.adoc[tag=fifo_commands] - -[[fifo_options]] -==== Opzioni - -// TRANSLATION MISSING -Sections in file _fifo.conf_: - -// TRANSLATION MISSING -[width="100%",cols="3m,6m,16",options="header"] -|=== -| Section | Control command | Description -| file | /set fifo.file.* | FIFO pipe control. -|=== - -// TRANSLATION MISSING -Options: - -include::includes/autogen_user_options.it.adoc[tag=fifo_options] - -[[irc_plugin]] -=== IRC +[[irc]] +== IRC Il plugin IRC è realizzato per chattare tramite protocollo IRC con altre persone. @@ -3176,7 +3003,7 @@ Il plugin IRC è realizzato per chattare tramite protocollo IRC con altre person trasferimento file (tramite plugin xfer, consultare <<xfer_plugin,plugin Xfer>>). [[irc_command_line_options]] -==== Opzioni a riga di comando +=== Opzioni a riga di comando È possibile fornire un URL per uno o più server IRC, come segue: @@ -3193,10 +3020,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr // TRANSLATION MISSING [[irc_servers]] -==== Servers +=== Servers [[irc_servers_add]] -===== Add a server +==== Add a server By default no servers are defined. You can add as many servers as you want with the <<command_irc_server,/server>> command. @@ -3236,7 +3063,7 @@ to join. In this case, you can set a command delay: `/set irc.server.libera.command_delay 5`. [[irc_servers_options]] -===== Server options +==== Server options Server options are named `irc.server.<server>.<option>` where `<server>` is the internal name of the server and `<option>` the name of an option. + @@ -3308,7 +3135,7 @@ value, which is now `on` instead of the default value `off`: ---- [[irc_ssl_certificates]] -===== Certificati SSL +==== Certificati SSL Al momento della connessione al server IRC con SSL, WeeChat verifica in maniera predefinita che la connessione sia completamente fidata. @@ -3341,7 +3168,7 @@ e potrebbe fallire, anche se funziona senza problemi con versioni precedenti la 0.3.1. [[irc_connect_oftc_with_certificate]] -====== Primo esempio: connessione a otfc e verifica del certificato +===== Primo esempio: connessione a otfc e verifica del certificato * Importare certificati nella shell: @@ -3367,7 +3194,7 @@ E possibile concatenare più certificati nel file CAs.pem. ---- [[irc_connect_oftc_with_certfp]] -====== Secondo esempio: connessione a otfc con CertFP +===== Secondo esempio: connessione a otfc con CertFP * Creare un certificato nella shell: @@ -3394,7 +3221,7 @@ which can also be for example `~/.weechat`. Per maggiori informazioni consultare https://www.oftc.net/NickServ/CertFP [[irc_sasl_authentication]] -===== Autenticazione SASL +==== Autenticazione SASL // TRANSLATION MISSING WeeChat supports SASL authentication, using different mechanisms: @@ -3426,7 +3253,7 @@ Le opzioni nel server sono: // TRANSLATION MISSING [[irc_sasl_ecdsa_nist256p_challenge]] -====== SASL ECDSA-NIST256P-CHALLENGE +===== SASL ECDSA-NIST256P-CHALLENGE You must generate a private key in order to authentify with the ECDSA-NIST256P-CHALLENGE mechanism (no password is required on connection). @@ -3473,7 +3300,7 @@ Reconnect to the server: // TRANSLATION MISSING [[irc_servers_connection]] -===== Connection +==== Connection You can connect to server with the <<command_irc_connect,/connect>> command: @@ -3505,7 +3332,7 @@ server buffers: // TRANSLATION MISSING [[irc_tor_sasl]] -===== Connect with TOR and SASL +==== Connect with TOR and SASL // TRANSLATION MISSING Some servers support connections with TOR (https://www.torproject.org/), @@ -3558,7 +3385,7 @@ And finally, connect to the server: // TRANSLATION MISSING [[irc_channels]] -==== Channels +=== Channels You can join channels with the <<command_irc_join,/join>> command: @@ -3593,7 +3420,7 @@ for example if `#channel1` requires a key but not `#channel2`: For help on the format, see `/help irc.server.libera.autojoin`. [[irc_private_messages]] -==== Private messages +=== Private messages You can send a private message with the <<command_irc_query,/query>> command, which opens a separate buffer: @@ -3615,7 +3442,7 @@ To close the private buffer, you can do this command on the private buffer: ---- [[irc_smart_filter_join_part_quit]] -==== Filtro smart per i messaggi di entrata/uscita/disconnessione +=== Filtro smart per i messaggi di entrata/uscita/disconnessione Un filtro smart è disponibile per filtrare i messaggi di entrata/uscita/disconnessione quando il nick non ha detto nulla durante @@ -3654,7 +3481,7 @@ Se un nick non ha parlato durante gli ultimi 5 minuti, i suoi ingressi e/o uscite/disconnessioni verranno nascosti sul canale. [[irc_ctcp_replies]] -==== Risposte CTCP +=== Risposte CTCP È possibile personalizzare le risposte CTCP, o bloccare alcune richieste CTCP (non rispondere). @@ -3735,7 +3562,7 @@ le risposte CTCP sono: |=== [[irc_target_buffer]] -==== Buffer di destinazione per i messaggi IRC +=== Buffer di destinazione per i messaggi IRC È possibile personalizzare il buffer di destinazione per i messaggi IRC (buffer usato per visualizzare messaggi) con l'opzione `+irc.msgbuffer.*+`. @@ -3876,12 +3703,12 @@ Alcuni esempi: ---- [[irc_commands]] -==== Comandi +=== Comandi include::includes/autogen_user_commands.it.adoc[tag=irc_commands] [[irc_options]] -==== Opzioni +=== Opzioni // TRANSLATION MISSING Sections in file _irc.conf_: @@ -3906,6 +3733,179 @@ Options: include::includes/autogen_user_options.it.adoc[tag=irc_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 + +The `/exec` command lets you execute external commands inside WeeChat and +display the output locally, or send it to a buffer. + +[[exec_commands]] +==== Comandi + +include::includes/autogen_user_commands.it.adoc[tag=exec_commands] + +[[exec_options]] +==== Opzioni + +// TRANSLATION MISSING +Sections in file _exec.conf_: + +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| command | /set exec.command.* | Options for commands. +| color | /set exec.color.* | Colors. +|=== + +Options: + +include::includes/autogen_user_options.it.adoc[tag=exec_options] + +[[fifo_plugin]] +=== Fifo + +È 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). + +// TRANSLATION MISSING +The FIFO pipe is located in WeeChat runtime directory and is called +_weechat_fifo_12345_ by default (where _12345_ is the WeeChat process id). + +La sintassi per i comandi/testo della pipe FIFO è una delle seguenti: + +.... + plugin.buffer *testo o comando qui + *testo o comando qui +.... + +Alcuni esempi: + +// TRANSLATION MISSING +* Change nick on IRC server libera to "newnick": + +---- +$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +// TRANSLATION MISSING +* Send a message on IRC #weechat channel: + +---- +$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +// TRANSLATION MISSING +* Send a message on current buffer: + +---- +$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +* Inviare due comandi per scaricare/caricare gli script Python (è necessario + separarli con "\n"): + +---- +$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 +---- + +[[fifo_commands]] +==== Comandi + +include::includes/autogen_user_commands.it.adoc[tag=fifo_commands] + +[[fifo_options]] +==== Opzioni + +// TRANSLATION MISSING +Sections in file _fifo.conf_: + +// TRANSLATION MISSING +[width="100%",cols="3m,6m,16",options="header"] +|=== +| Section | Control command | Description +| file | /set fifo.file.* | FIFO pipe control. +|=== + +// TRANSLATION MISSING +Options: + +include::includes/autogen_user_options.it.adoc[tag=fifo_options] + [[logger_plugin]] === Logger |