# Guida Rapida a WeeChat

Sébastien Helleu
flashcode@flashtux.org
version 1.9.1

Translators:

- Marco Paolone <marcopaolone@gmail.com>, 2009-2013

## 1. 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

## 2. Aiuto online / opzioni

WeeChat offre aiuto per tutti i comandi, basta digitare:

    /help

Per ricevere aiuto su un comando specifico, digitare:

    /help comando

Per impostare le opzioni, utilizzare:

    /set config.sezione.opzione valore

(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).

WeeChat utilizza subito il nuovo valore (non c’è mai bisogno di riavviare WeeChat dopo aver cambiato la configurazione).

È possibile utilizzare l’opzione `/set` con un nome parziale e il carattere jolly "*" all’inizio o alla fine per visualizzare tutte le opzioni contenenti le lettere. Per esempio:

- visualizza tutte le opzioni (WeeChat e plugin):

    /set

- visualizza le opzioni di WeeChat:

    /set weechat.*

- visualizza le opzioni del plugin IRC:

    /set irc.*

È possibile visualizzare l’aiuto per ogni opzione con `/help`, per esempio:

    /help weechat.look.highlight

Tutte le impostazioni vengono salvato all’uscita di WeeChat (o con il comando `/save` per forzare il salvataggio di una o più opzioni).

Important | It is not recommended to edit configuration files by hand because WeeChat may write them at any time (for example on /quit) and after any change you must run the command /reload (with the risk of losing other changes that were not yet saved with /save). You can use the command /set, which checks the value and applies immediately the changes.

## 3. 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.

## 4. Add an IRC server

You can add an IRC server with `/server` command, for example:

    /server add freenode chat.freenode.net

Come al solito, è disponibile l’aiuto se c’è qualche problema:

    /help server

## 5. 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 freenode con il seguente comando:

    /set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"

Per impostare il nome utente ed il nome reale:

    /set irc.server.freenode.username "Mio nome utente"
    /set irc.server.freenode.realname "Mio nome reale"

Per impostare la connessione automatica al server all’avvio:

    /set irc.server.freenode.autoconnect on

To connect with SSL:

    /set irc.server.freenode.addresses "chat.freenode.net/7000"
    /set irc.server.freenode.ssl on

Se SASL è disponibile sul server, è possibile usarlo per l’autenticazione (l’autenticazione avviene prima dell’ingresso nei canali):

    /set irc.server.freenode.sasl_username "mynick"
    /set irc.server.freenode.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.freenode.command "/msg nickserv identify xxxxxxx"

Note | Many commands in option command can be separated by `;` (semi-colon).

If you want to protect your password in configuration files, you can use secured data.

First setup a passphrase:

    /secure passphrase this is my secret passphrase

Then add a secured data with your freenode password:

    /secure set freenode_password xxxxxxx

Then you can use `${sec.data.freenode_password}` instead of your password in IRC options mentioned above, for example:

    /set irc.server.freenode.sasl_password "${sec.data.freenode_password}"

Per entrare automaticamente in alcuni canali quando ci si connette al server:

    /set irc.server.freenode.autojoin "#canale1,#canale2"

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):

    /set irc.server.freenode.nicks null

Altre opzioni: è possibile impostare altre opzioni con il seguente comando ("xxx" è il nome dell’opzione):

    /set irc.server.freenode.xxx value

## 6. Connessione al server IRC e ingresso automatico nei canali

    /connect freenode

Note | Questo comando può essere usato per creare e connettersi ad un nuovo server senza utilizzare il comando `/server` (è necessario ripetere che è possibile visualizzare l’aiuto per questo comando con `/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 `Ctrl`+`x`.

È possibile disabilitare l’unione automatica dei server dei buffer per avere i buffer dei server indipendenti:

    /set irc.look.server_buffer independent

## 7. Entrare/uscire dai canali IRC

Entra in un canale:

    /join #canale

Esce da un canale (mantenendo il buffer aperto):

    /part [messaggio di uscita]

Close a server, channel or private buffer (`/close` is an alias for `/buffer close`):

    /close

Warning | Closing the server buffer will close all channel/private buffers.

Disconnect from server, on the server buffer:

    /disconnect

## 8. IRC private messages

Open a buffer and send a message to another user (nick foo):

    /query foo this is a message

Close the private buffer:

    /close

## 9. 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

(Qui non si ripeterà che è possibile avere aiuto su questi comandi con /help)

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

To remove the split:

    /window merge

## 10. Associazione tasti

WeeChat usa molti tasti. Essi sono tutti presenti nella documentazione, ma si dovrebbero conoscere almeno quelli vitali:

- `Alt`+`←` / `Alt`+`→` oppure `F5` / `F6`: passa al buffer precedente/successivo

- `F7` / `F8`: passa alla finestra precedente/successiva (quando lo schermo è diviso)

- `F9` / `F10`: scorre la barra del titolo

- `F11` / `F12`: scorre la lista nick

- `Tab`: completa il testo nella barra di input, proprio come nella shell

- `PgUp` / `PgDn`: scorre testo nel buffer corrente

- `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 è `Alt`+`k` per trovare i codici tasti.

Ad esempio, per associare `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-!

## 11. 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).

Many external scripts (from contributors) are available for WeeChat, you can download and install scripts from the repository with the `/script` command, for example:

    /script install iset.pl

See `/help script` for more info.

A list of scripts is available in WeeChat with `/script` or at this URL: https://weechat.org/scripts

## 12. Ulteriore documentazione

È ora possibilie usare WeeChat e leggere FAQ/documentazione per ogni altra domanda: https://weechat.org/doc

Buon WeeChat!