= Guida Rapida a WeeChat :author: Sébastien Helleu :email: flashcode@flashtux.org :lang: it :toc-title: Indice Traduttori: * Marco Paolone , 2009-2013 * Mattia Ronchi , 2023 [[start]] == Avvio di WeeChat Un emulatore di terminale raccomandato per X (ma non obbligatorio) è rxvt-unicode: ha un buon supporto per UTF-8, e nessun problema con le scorciatoie da tastiera predefinite. Avviare dalla propria shell: ---- $ weechat ---- [[help]] == Aiuto online WeeChat offre aiuto per tutti i comandi, basta digitare: ---- /help ---- Per ricevere aiuto su un comando specifico, digitare: ---- /help comando ---- L'aiuto è anche disponibile per le opzioni: ---- /help config.section.option ---- (dove `config` è il nome della configurazione (`weechat` per il core, oppure un nome plugin), `sezione` la sezione di questa configurazione e `opzione` il nome dell'opzione). [[options]] == Imposta opzioni Per impostare le opzioni, utilizzare: ---- /set config.sezione.opzione valore ---- WeeChat utilizza subito il nuovo valore (non c'è *mai* bisogno di riavviare WeeChat dopo aver cambiato la configurazione). Tutte le impostazioni vengono salvato all'uscita di WeeChat (o con il comando `/save` per forzare il salvataggio di una o più opzioni). [IMPORTANT] *Non è consigliato* modificare i file di configurazione a mano perchè WeeChat potrebbe scrivervi in ogni momento (ad esempio dopo `/quit`) e dopo ogni cambiamento devi eseguire il comando `/reload` (con il rischio di perdere altri cambiamenti non ancora salvati con `/save`). + Puoi usare il comando `/set`, che controlla i valori e applica immediatamente i cambiamenti. Il plugin _fset_ ti permette facilmente di navigare tra le opzioni e cambiarle. Per esempio, per mostrare le opzioni di WeeChat: ---- /fset weechat.* ---- Opzioni IRC: ---- /fset irc.* ---- Il comando `/fset` ha il completamento nei nomi delle opzioni, quindi se ad esempio scrivi `/fset hot` e premi kbd:[Tab], questo viene completato come `/fset hotlist`. Se premi kbd:[Enter], vengono mostrate le opzioni riguardo la hotlist. Per più informazioni sul comando `/fset` e i suoi tasti, vedi `/help fset`. [[core_vs_plugins]] == Core vs plugin Il "core" di WeeChat è utilizzato solo per visualizzare i dati sullo schermo e interagire con l'utente; ciò vuol dire che il core di weechat senza i plugin è inutile (utenti più fedeli: IRC faceva parte del core per le versioni ≤ 0.2.6). Tutti i protocolli di rete come IRC sono forniti in plugin separati. Utilizzando il comando `plugin` per elencare i plugin caricati, è possibile vedere "irc" ed altri plugin nella lista. [[add_irc_server]] == Aggiungi un server IRC Puoi aggiungere un server IRC con il comando `/server`, per esempio: ---- /server add libera irc.libera.chat/6697 -tls ---- In questo comando, `libera` è il nome interno del server usato da WeeChat: sarai in grado di connetterti con `/connect libera` e le opzioni del server sono _irc.server.libera.xxx_. Come al solito, è disponibile l'aiuto se c'è qualche problema: ---- /help server ---- [[irc_server_options]] == Impostare opzioni personalizzate per il server IRC WeeChat usa valori predefiniti per tutti i server, se non si specifica un valore preciso per un'opzione del server. Questi valori predefiniti sono "irc.server_default.*" Per ogni opzione del server, WeeChat usa il proprio valore se definito (non "nullo"). Altrimenti si utilizza il valore predefinito ("irc.server_default.xxx"). Per esempio ci sono dei nick predefiniti (basati sul proprio login un*x), ed è possibile sovrascriverli per il server libera con il seguente comando: ---- /set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5" ---- Per impostare il nome utente ed il nome reale: ---- /set irc.server.libera.username "Mio nome utente" /set irc.server.libera.realname "Mio nome reale" ---- Per impostare la connessione automatica al server all'avvio: ---- /set irc.server.libera.autoconnect on ---- Se SASL è disponibile sul server, è possibile usarlo per l'autenticazione (l'autenticazione avviene prima dell'ingresso nei canali): ---- /set irc.server.libera.sasl_username "mynick" /set irc.server.libera.sasl_password "xxxxxxx" ---- Per eseguire un comando dopo la connessione al server, ad esempio per autenticarsi con nickserv (solo se non viene usato SASL per l'autenticazione): ---- /set irc.server.libera.command "/msg nickserv identify xxxxxxx" ---- [NOTE] Molti comandi nell'opzione _command_ possono essere separati da `;` (punto e virgola). Se vuoi proteggere la tua password nei file di configurazione, puoi usare dati protetti. Per prima cosa imposta una frase segreta (passphrase): ---- /secure passphrase this is my secret passphrase ---- Ora aggiungi il dato protetto con la tua password di libera: ---- /secure set libera_password xxxxxxx ---- Puoi usare `+${sec.data.libera_password}+` al posto della tua password nelle opzioni IRC menzionate sopra, per esempio: ---- /set irc.server.libera.sasl_password "${sec.data.libera_password}" ---- Per entrare automaticamente in alcuni canali quando ci si connette al server: ---- /set irc.server.libera.autojoin "#canale1,#canale2" ---- Il comando `/autojoin` ti permette di configurare l'opzione _autojoin_ facilmente (vedi `/help autojoin`). Puoi anche configurare WeeChat per aggiornare automaticamente l'opzione _autojoin_ quando entri o esci dai canali: ---- /set irc.server_default.autojoin_dynamic on ---- Per eliminare il valore di un'opzione del server, e usare invece il valore predefinito, per esempio per utilizzare i nick predefiniti (irc.server_default.nicks): ---- /unset irc.server.libera.nicks ---- Altre opzioni: è possibile impostare altre opzioni con il seguente comando ("xxx" è il nome dell'opzione): ---- /set irc.server.libera.xxx value ---- [TIP] Puoi completare il nome e il valore dell'opzione con kbd:[Tab] e con kbd:[Shift+Tab] per un completamento parziale (utile per parole lunghe come il nome di un'opzione). [[connect_to_irc_server]] == Connessione al server IRC ---- /connect libera ---- Con questo comando, WeeChat si connette al server libera ed entra automaticamente nei canali configurati nell'opzione "autojoin" del server. [NOTE] Questo comando può essere usato per creare e connettersi ad un nuovo server senza utilizzare il comando `/server` (see `/help connect`). I buffer dei server vengono uniti al buffer _core_ di WeeChat in modo predefinito. Per passare tra buffer _core_ e buffer server, si può digitare kbd:[Ctrl+x]. È possibile disabilitare l'unione automatica dei server dei buffer per avere i buffer dei server indipendenti: ---- /set irc.look.server_buffer independent ---- [[join_part_irc_channels]] == Entrare/uscire dai canali IRC Entra in un canale: ---- /join #canale ---- Esce da un canale (mantenendo il buffer aperto): ---- /part [messaggio di uscita] ---- Chiude un server, un canele o un buffer privato (`/close` è un sinonimo per `/buffer close`): ---- /close ---- [WARNING] Chiudere il buffer del server chiuderà tutti i canali/buffer privati. Disconnette dal server: ---- /disconnect ---- [[irc_private_messages]] == Messaggi privati IRC Apre un buffer e invia un messaggio a un altro utente (nome _foo_): ---- /query foo this is a message ---- Chiude il buffer privato: ---- /close ---- [[buffer_window]] == Gestione buffer/finestra Un buffer è un componente collegato ad un plugin con un numero, una categoria e un nome. Un buffer contiene i dati visualizzati sullo schermo. Una finestra è la vista di un buffer. Il comportamento predefinito prevede solo una finestra che visualizza un buffer. Se lo schermo viene diviso, sarà possibile vedere più finestre con molti buffer allo stesso tempo. I comandi per gestire buffer e finestre: ---- /buffer /window ---- Per esempio, per dividere verticalmente lo schermo in una finestra piccola (1/3 della larghezza) ed una grande (2/3), utilizzare il comando: ---- /window splitv 33 ---- Per rimuovere la divisione: ---- /window merge ---- [[key_bindings]] == Associazione tasti WeeChat usa molti tasti. Essi sono tutti presenti nella documentazione, ma si dovrebbero conoscere almeno quelli vitali: - kbd:[Alt+←] / kbd:[Alt+→] oppure kbd:[F5] / kbd:[F6]: passa al buffer precedente/successivo - kbd:[F1] / kbd:[F2]: barra di scorrimento della lista dei buffer("buflist") - kbd:[F7] / kbd:[F8]: passa alla finestra precedente/successiva (quando lo schermo è diviso) - kbd:[F9] / kbd:[F10]: scorre la barra del titolo - kbd:[F11] / kbd:[F12]: scorre la lista nick - kbd:[Tab]: completa il testo nella barra di input, proprio come nella shell - kbd:[PgUp] / kbd:[PgDn]: scorre testo nel buffer corrente - kbd:[Alt+a]: passa al buffer con attività (nella hotlist) A seconda della propria tastiera e/o le proprie necessità, è possibile associare nuovamente qualsiasi tasto ad un comando tramite `/key`. Un tasto utile è kbd:[Alt+k] per trovare i codici tasti. Ad esempio, per associare kbd:[Alt+!] al comando `/buffer close`: ---- /key bind (digitare alt-k) (digitare alt-!) /buffer close ---- Si otterrà una riga di comando simile a: ---- /key bind meta-! /buffer close ---- Per eliminare il tasto: ---- /key unbind meta-! ---- [[plugins_scripts]] == Plugin/script Su alcune distribuzioni come Debian, i plugin sono disponibili tramite un pacchetto separato (come weechat-plugins). I plugin vengono caricati automaticamente quando trovati (per favore consultare la documentazione per caricare/scaricare plugin o script). Sono disponibili molti script esterni (da contributori) per WeeChat, puoi scaricare e installare script dal repository con il comando `/script`, per esempio: ---- /script install go.py ---- Vedi `/help script` per più informazioni. Una lista degli script è disponibile su WeeChat tramite `/script` o su https://weechat.org/scripts/[questa pagina ^↗^^]. [[more_doc]] == Ulteriore documentazione Ora sei in grado di usare WeeChat e leggere https://weechat.org/doc/[FAQ/documentazione ^↗^^] per qualsiasi altra domanda. Buon WeeChat!