mirror of
https://github.com/weechat/weechat.git
synced 2026-06-12 14:14:48 +02:00
Sébastien Helleu
410 lines
10 KiB
Plaintext
410 lines
10 KiB
Plaintext
// SPDX-FileCopyrightText: 2003-2026 Sébastien Helleu <flashcode@flashtux.org>
|
||
// SPDX-FileCopyrightText: 2009-2013 Marco Paolone <marcopaolone@gmail.com>
|
||
// SPDX-FileCopyrightText: 2023 Mattia Ronchi <ronchimattia03@gmail.com>
|
||
//
|
||
// SPDX-License-Identifier: GPL-3.0-or-later
|
||
|
||
= Guida Rapida a WeeChat
|
||
:author: Sébastien Helleu
|
||
:email: flashcode@flashtux.org
|
||
:lang: it
|
||
include::includes/attributes-it.adoc[]
|
||
|
||
[[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:
|
||
|
||
[source,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
|
||
----
|
||
|
||
[CAUTION]
|
||
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
|
||
|
||
// TRANSLATION MISSING
|
||
WeeChat usa molti tasti. Essi sono tutti presenti nella documentazione
|
||
(link:weechat_user.it.html#key_bindings[Guida per l'Utente / Key bindings ^↗^^]),
|
||
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!
|