Wiki Ubuntu-it

Indice
Partecipa
FAQ
Wiki Blog
------------------
Ubuntu-it.org
Forum
Chiedi
Chat
Cerca
Planet
  • Pagina non alterabile
  • Informazioni
  • Allegati
  • Differenze per "Ufficio/EditorDiTesto/Helix"
Differenze tra le versioni 53 e 93 (in 40 versioni)
Versione 53 del 18/12/2015 10.55.42
Dimensione: 13925
Commento:
Versione 93 del 23/07/2025 09.53.10
Dimensione: 14906
Autore: jeremie2
Commento:
Le cancellazioni sono segnalate in questo modo. Le aggiunte sono segnalate in questo modo.
Linea 1: Linea 1:
## page was renamed from vipri-alessandro/FAQs ## page was renamed from jeremie2/Prove3
Linea 3: Linea 3:
#LANGUAGE it
<<Include(GruppoDocumentazione/Header)>>
#language it
Linea 6: Linea 5:
<<Indice>>

= FAQ =

Le '''FAQ''' (frequently asked questions) sono risposte alle domande che più frequentemente vengono poste da chi si affaccia per la prima volta alla [[Documentazione/Indice|documentazione wiki]].<<BR>>
Se vuoi sapere come funziona la documentazione della comunità italiana di Ubuntu e vuoi contribuire, in questa pagina potrai approfondire vari aspetti.

||<tablestyle="text-align: justify; width:63%;" style="border:none;" 5%><<Immagine(Icone/Grandi/info.png,,center)>> ||<style="padding:0.5em; border:none;">Per ulteriori dubbi/domande il [[GruppoDocumentazione|Gruppo Documentazione]] è contattabile su: [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]], [[http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/gruppo-doc|Mailing List|mailing list]] e canale IRC [[http://chat.ubuntu-it.org/#ubuntu-it-doc|#ubuntu-it-doc]].||

= Cos'è il wiki di Ubuntu-it? =
Il wiki è una piattaforma aperta di condivisione e collaborazione, utilizzata sia dai [[http://www.ubuntu-it.org/comunita/struttura|gruppi di lavoro]] di Ubuntu-it per coordinare i lavori, sia per la pubblicazione della [[Documentazione/Indice|documentazione wiki]] riguardante il sistema operativo Ubuntu.

= Cos'è la documentazione wiki? =
La [[Documentazione/Indice|documentazione wiki]] è la documentazione scritta da chi utilizza il sistema operativo Ubuntu. Qualsiasi utente può partecipare alla stesura delle guide.<<BR>>Sai cosa occorre per configurare un programma? Sai come installare determinati driver di una periferica hardware o altro ancora? Se vuoi condividere sul wiki le soluzioni che hai trovato, sei il benvenuto!

= Che differenza c'è fra la documentazione wiki e i Manuali di Utilizzo? =
Mentre la [[Documentazione/Indice|documentazione wiki]] è modificabile appunto attraverso il wiki da utenti qualsiasi, i [[http://help.ubuntu-it.org|Manuali di Utilizzo]] seguono un iter di sviluppo completamente differente essendo infatti la traduzione della documentazione allegata al sistema operativo. Per poter partecipare alla traduzione dei manuali occorre rivolgersi al [[GruppoTraduzione|Gruppo Traduzione]].

= È necessario far parte del Gruppo Doc per editare il wiki? =
'''Assolutamente no'''. Chiunque può correggere le guide wiki o crearne di nuove.<<BR>>Il Gruppo Doc si occupa di mantenere ordinata la documentazione wiki, sia curando l'impostazione dei documenti scritti dagli utenti, sia avendo cura che la pagina sia pubblicata nella sezione appropriata del sito.

= Devo già saper editare alla perfezione pagine wiki per scrivere guide? =
'''Assolutamente no'''.
Non occorre essere scrittori, riportare i passaggi in modo schematico è più che sufficiente. Chi utilizza il wiki per la prima volta in [[Wiki10Passi|questa pagina]] può vedere come trasformare le parole in titoli di paragrafi, in testo in grassetto, in link, ecc..<<BR>>In realtà le guide seguono alcune [[GuidaWiki/Standard|impostazioni]] e se ti va di seguirle non può che farci piacere. Ma se ritieni che siano complicate, scrivi nel modo in cui ti riesce meglio, al resto ci pensa il Gruppo Doc durante la revisione ;)

= Perché dovrei scrivere guide sul wiki piuttosto che su un blog/sito personale? =
 * Partecipando a un progetto di [[http://it.wikipedia.org/wiki/Scrittura_collaborativa|scrittura collaborativa]], anche se un giorno non potrai più occuparti di un argomento, altre persone potranno subentrare per aggiornare i contenuti.
 * Partecipando con più persone è possibile avere più punti di vista attraverso i quali diventa più semplice far emergere errori/inesattezze e quindi intervenire per migliorare le pagine.
 * Radunare le guide sul sito ufficiale di un sistema operativo, rende meno dispersiva la ricerca delle soluzioni ai problemi.

= Come si crea un account sul wiki? Come si accede? =
È necessario avere un account per modificare le pagine del wiki. Per crearlo, consulta la pagina [[GuidaWiki/IscriversiAlWiki|Iscriversi al wiki]].

= Come è organizzata la documentazione wiki? =
La documentazione wiki è suddivisa in [[Documentazione/Indice#Aree_tematiche|Aree tematiche]], per aiutare chiunque voglia consultarla a trovare velocemente gli argomenti di interesse.

È compito del '''[[GruppoDocumentazione|Gruppo Doc]]''' mantenere ordinate e facilmente consultabili le guide scritte dalla comunità, revisionare e adattare agli [[GuidaWiki/Standard|standard]] le guide create o aggiornate dagli utenti. Inoltre i membri del '''Gruppo Doc''' sono [[#contatti|contattabili]] per consigli, chiarimenti, aiuti nella editazione delle pagine e altre domande.

Compito degli '''utenti''' è di mantenere la documentazione aggiornata e rinnovata: ogni aiuto è il benvenuto!!

= Come si può collaborare per migliorare la documentazione? =
Sei libero di verificare le guide esistenti, di correggerle e aggiornarle, di scriverne di nuove.<<BR>>
Ecco una serie di consigli:
 * '''Verifica di una guida''': se hai consultato un procedimento che funziona, ma la versione di Ubuntu (o derivata) su cui hai effettuato le modifiche non è indicata alla voce '''Guida verificata con Ubuntu: 15.04, 14.04 ...''' posta sotto l'Indice della guida wiki, puoi inserire tu stesso la verifica alla guida. Per farlo, accedi al wiki e modifica la pagina interessata inserendo alla voce:{{{
<<Informazioni(forum="..."; rilasci="15.04 14.04";)>>}}} la tua versione di Ubuntu.
 * '''Errori banali''': se trovi nomi sbagliati, errori ortografici, collegamenti errati, ecc.. correggili pure!
 * '''Grosse modifiche/Nuove pagine''': se vuoi apportare delle modifiche importanti ad una guida wiki o vuoi crearne una nuova, metti al corrente il '''[[GruppoDocumentazione|Gruppo Doc]]''' nel [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]] e saremo felici di consigliarti e aiutarti.

= Posso creare nuove pagine quando mi pare e piace? =
Per la [[Documentazione/Indice|documentazione wiki]] è molto importante che non si creino pagine doppione, che i contenuti non si replichino su pagine differenti e che i contenuti rimangano su temi [[#off-topic|attinenti]]. Pertanto mentre le modifiche banali (correzioni di nomi/parole sbagliate, link rotti, ecc..) possono essere immediatamente corrette, per la creazione di nuove guide o la profonda revisione di quelle già esistenti occorre avvisare il Gruppo Doc nella apposita sezione del [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]].<<BR>>In questo modo è possibile monitorare i lavori, accertarsi che i nuovi argomenti non siano in realtà già presenti e che non esulino dagli obiettivi del wiki.

<<Anchor(off-topic)>>
= Quali argomenti non sono adatti al wiki? =
Di norma viene accettato tutto quello che può servire a risolvere problemi di configurazione software/hardware e in generale scavalcare le difficoltà che possono verificarsi nell'utilizzo di Ubuntu. Potrebbero invece essere scartati:
 * '''argomenti troppo generici''': argomenti generalisti di stampo enciclopedico (ad es. approfondimenti su linguaggi di programmazione, su protocolli di rete, ecc..). In questi casi potrebbe essere più indicato rivolgersi a uno strumento come [[https://it.wikipedia.org/wiki/Pagina_principale|Wikipedia]]. Si tratta di valutare di volta in volta.
 * '''Argomenti troppo banali''': ad esempio limitarsi a segnalare l'installazione di un pacchetto software già disponibile in Ubuntu, senza ulteriori indicazioni.

= Posso tradurre guide straniere? =
Occorre precisare che quello che interessa nelle pagine della documentazione sono i contenuti, ossia i passaggi utili a risolvere una problematica. Pertanto non interessa una traduzione "impeccabile" nella forma come avviene ad esempio per la traduzione dei software o della documentazione allegata ai software. La cosa importante è schematizzare i passaggi delle procedure da utilizzare, lo stile verrà comunque riadattato a quello in [[GuidaWiki/Standard|uso sul wiki]] in fase di revisione.

= Non riesco ad accedere al wiki o a modificare delle guide, come risolvo? =
Consulta la pagina [[GuidaWiki/IscriversiAlWiki/RisoluzioneProblemi|Risoluzione problemi]].<<BR>>
Se hai altri problemi e non riesci a risolvere, puoi [[#contatti|contattare]] il '''Gruppo Doc'''.

= Cos'è una pagina personale? =
È una pagina in cui parli di te e ti presenti al resto della comunità, sei libero di scrivere quello che vuoi ;) <<BR>>
La pagina personale è utile per fare pratica con il wiki, per elencare le guide che ti interessano, per indicare i tuoi contributi o come vuoi iniziare a contribuire...

Spesso la pagina personale viene utilizzata anche come ''Indice personale'', per raggruppare le tue pagine di prova. Ad esempio è possibile creare la pagina di prova '''MarioRossi/Prova1''', che è una sotto-pagina della pagina personale '''!MarioRossi'''.

Consulta [[PaginaPersonale|questa pagina wiki]] per sapere come creare la tua pagina personale.

= Come si scrive una guida? Come si scrive in grassetto? Come si inseriscono titoli dei paragrafi e elenchi? =
Non esiste un unico metodo per scrivere una guida wiki. Puoi avvalerti di un [[DocumentazioneModello|modello]] o copiare una guida esistente da incollare e modificare in una nuova pagina.

Per imparare a formattare correttamente una pagina wiki, dai un'occhiata alla [[Wiki10Passi|Guida in 10 passi più uno]] ;)

= Come si allega un'immagine? =
Non è generalmente necessario caricare immagini in una guida, sia per evitare di appesantire troppo il wiki, sia perché nella maggior parte dei casi le procedure indicate dalle guide non richiedono immagini esplicative. Pertanto, se non è strettamente necessario, si evita di caricare immagini sul wiki che col tempo andrebbero aggiornate o rimosse.

Se comunque desideri inserire un'immagine che ritieni utile in una guida wiki, visualizza la guida in questione e seleziona la voce '''Allegati''' nella barra grigia superiore del wiki.<<BR>>
Una volta caricata l'immagine, puoi usare:{{{
<<Immagine(./nomeimmagine.png,)>>
}}}oppure:{{{
{{nomeimmagine.png}}
}}}per visualizzare l'immagine nella guida.

Ricordati di utilizzare solo immagini non coperte da copyright e in formato `.png`.

= Come si corregge una guida esistente? =
Se desideri aggiornare o correggere una guida già presente nel wiki, puoi farlo tramite una '''Pagina di prova'''. Procedi in questo modo:
 0. accedi al wiki e visualizza la pagina che vuoi aggiornare;
 0. nella barra grigia superiore del wiki seleziona la voce '''''Altre azioni → Mostra il testo grezzo''''', quindi copia tutto il suo contenuto;
 0. crea una '''Pagina di prova''' e incolla al suo interno il testo precedentemente copiato, quindi salva.

Ora sei libero di apportare nella '''Pagina di prova''' tutte le modifiche che vuoi. Appena terminata, informa il '''Gruppo Doc''' sul [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]] in modo che la pagina venga [[GruppoDocumentazione/PagineDaFare|revisionata]] e nel caso [[GuidaWiki/Standard|riadattata]] dallo staff.

= Cos'è una pagina di prova e come si crea? =
Una pagina di prova è in pagina non indicizzata (non è raggiungibile dall'[[Documentazione/Indice|Indice]] della documentazione wiki) che puoi liberamente creare e modificare a tuo piacimento.<<BR>>
Per maggiori informazioni puoi consultare [[GuidaWiki/CreazioneNuovePagine#Pagine_Prova|questa pagina]].

= Come si crea una nuova guida? =
Le nuove guide possono essere create da subito col [[GuidaWiki/CreazioneNuovePagine#Nuovi_Documenti|nome]] dell'argomento trattato.<<BR>>
Una volta fatto, puoi utilizzare il '''Nuovo documento''' per scrivere la tua guida. Appena terminata, informa il '''Gruppo Doc''' sul [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]] in modo che la pagina venga [[GruppoDocumentazione/PagineDaFare|revisionata]] e nel caso [[GuidaWiki/Standard|riadattata]] dallo staff.

= Si può collaborare con più persone nella creazione o modifica delle guide? =
Certamente! Poiché tutti possono editare il wiki, è anche possibile che più persone collaborino alla creazione o alla modifica di una guida. L'unico limite consiste nel non poter scrivere la stessa pagina contemporaneamente.

= Come si cancella una pagina o un allegato? =
È possibile fare delle richieste specifiche al '''Gruppo Doc''', come l'eliminazione di pagine di prova personali, immagini o altro, tramite la pagina [[ToDoWiki]].<<BR>>
In alternativa puoi [[#contatti|contattare]] direttamente i membri dello staff.

= Posso entrare a far parte del Gruppo Doc? =
È possibile entrare a far parte del [[GruppoDocumentazione|Gruppo Documentazione]] solo dopo che ci si è cimentati con la stesura di qualche pagina. È importante dimostrare di avere un minimo di dimestichezza con gli strumenti del wiki, una certa cura nella scrittura delle pagine e una certa presenza nella sezione del [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]]. Si può avere una panoramica delle attività leggendo il [[GruppoDocumentazione/VademecumEditori|vademecum degli editori]].<<BR>>Più in generale nella pagina [[GruppoDocumentazione/Organizzazione|Organizzazione]] sono riportate notizie utili per entrare a far parte del gruppo.

<<Anchor(contatti)>>
= Come si contatta il Gruppo Doc? =
Il [[GruppoDocumentazione|Gruppo Documentazione]] è contattabile su: [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]], [[http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/gruppo-doc|Mailing List|mailing list]] e canale IRC [[http://chat.ubuntu-it.org/#ubuntu-it-doc|#ubuntu-it-doc]].

Per la creazione o modifica delle guide wiki, il "luogo" in cui preferiamo consultarci è il forum, dove per ogni guida esiste una discussione specifica.
<<Indice(depth=1)>>
<<Informazioni(forum="https://forum.ubuntu-it.org/viewtopic.php?f=46&t=657114"; rilasci="24.04")>>

= Introduzione =

'''Helix''' è un editor di testo [[#mod|modale]] utilizzabile nel [[AmministrazioneSistema/Terminale|terminale]] simile a '''Vim''' ma con la differenza di avere fin da subito a disposizione buone impostazioni di default e funzionalità varie in modo che l'editor risulti immediatamente utilizzabile riducendo al minimo eventuali personalizzazioni.

Nonostante '''Helix''' possa semplificare la vita rispetto a editor come '''Vim''', '''!NeoVim''', '''Emacs''', ecc.. essendo un software evoluto per l'editazione di testi, richiede comunque un certo impegno per impararne l'utilizzo.<<BR>>
In questa guida vengono giusto introdotte alcune nozioni. Per approfondimenti si rimanda all'ottima [[https://docs.helix-editor.com/|documentazione]] ufficiale ed è inoltre consigliabile l'avvio di '''Helix''' in modalità [[https://docs.helix-editor.com/usage.html|tutor]], una guida interattiva particolarmente utile per chi stia utilizzando per la prima volta un editor modale.

{{{#!wiki tip
Per l'installazione dei ''Language Server Protocol'' ('''LSP''') consultare la [[Ufficio/EditorDiTesto/Helix/Lsp|seguente pagina]].
}}}

= Installazione =

Installare il pacchetto [[AmministrazioneSistema/InstallareProgrammi/PacchettiSnap|snap]] digitando nel [[AmministrazioneSistema/Terminale|terminale]]:{{{
sudo snap install helix --classic
}}}

== Da pacchetto .deb ==

In alternativa '''Helix''' può essere installato in formato `.deb` da un [[Repository|repository]] esterno.

 0. Aggiungere la nuova sorgente software digitando nel [[AmministrazioneSistema/Terminale|terminale]]:{{{
sudo add-apt-repository ppa:maveonair/helix-editor
}}}
 0. Installare '''Helix''' digitando:{{{
sudo apt install helix
}}}

= Avvio e apertura file =

Comandi di avvio da '''terminale''':

||<:> '''Comando''' ||<:> '''Descrizione''' ||
|| `hx` || Apre l'editor. ||
|| `helix` || Versione estesa del comando precedente. ||
|| `hx percorso/file` || Apre direttaemtne un file all'interno di Helix.||

<<Anchor(file)>>
In alternativa oltre al comando [[#open|:open]] sono disponibili diverse modalità di ricerca, selezione e apertura file in stile ''file manager'' premendo la combinazione dei tasti '''spazio''' (''barra spaziatrice'') e una specifica lettera.
 * '''File picker''', per visionare e aprire file in modo pratico:
  * '''spazio + f''': apre il file picker.
  * '''spazio + F''': apre il file picker nella directory corrente.
 * '''File explorer''', cioè un file manager per navigare le directory e visualizzare e aprire file:
  * '''spazio + e''': apre il file explorer.
  * '''spazio + E''': apre il file explorer nella directory corrente.
 * '''Buffer picker''', elenco dei file aperti nell'attuale sessione;
  * '''spazio + b''': apre il '''buffer picker'''.

{{{#!wiki tip
Se il terminale è aperto a schermo intero, sulla destra sarà visibile un'anteprima del file selezionato.
}}}

= Chiusura =

Questi i comandi da '''editor''' di chiusura da digitare in modalità '''normale''':

||<:> '''Comando''' ||<:> '''Descrizione''' ||
|| `:q` || Chiude la sessione di Helix. ||
|| `:q!` || Chiude la sessione senza salvare eventuali modifiche.||
|| `:wq` || Salva le modifiche e chiude la sessione. ||

<<Anchor(mod)>>
= Modalità =

Trattandosi di un editor modale, per ogni tipologia di azione è prevista una modalità che deve essere attivata. All'apertura di un file '''Helix''' sarà in modalità '''normale''', cioè una modalità che permette di muoversi attraverso il testo e applicare modifiche come spostare o copia/incollare il testo stesso. Per poter inserire caratteri sarà necessario passare alla modalità '''inserimento''' tramite il tasto '''i'''.
Con il tasto '''Esc''' si ritornerà sempre alla modalità '''normale'''.

Niente esclude che a proprio piacimento l'utente possa impostare scorciatoie da tastiera che permettano di sfruttare azioni non previste nella modalità originaria. Ad esempio è possibile attivare [[#config|scorciatoie da tastiera]] che permettano in modalità '''inserimento''' di spostarsi velocemente fra le righe del testo.

{{{#!wiki note
Da notare che mouse e touchpad continueranno a funzionare come di consueto e potranno essere utilizzati per selezionare del testo e incollarlo tramite clic centrale o tap a tre dita.
}}}

Segue un elenco con alcune modalità:

||<:> '''Modalità''' ||<:> '''Tasti''' ||<:> '''Descrizione''' ||
|| '''Normale''' ||<:> '''Esc''' || Modalità predefinita nella quale è possibile scorrere, selezionare, copiare, incollare testo e altro. Si ritorna ad essa premendo Esc. ||
|| '''Inserimento''' ||<:> '''i''' || Inserimento. ||
|| ||<:> '''c''' || Inserimento cancellando il testo selezionato. ||
|| ||<:> '''o''' || Inserimento a capo. ||
|| ||<:> '''I''' || Inserimento a inizio riga. ||
|| ||<:> '''A''' || Inserimento a fine riga. ||
|| '''Selezione''' ||<:> '''v''' || I tasti per muoversi attraverso il testo faranno si che il testo venga selezionato.||
|| '''Ricerca''' ||<:> '''s''' || Da attivare dopo aver selezionato del testo. Permette la ricerca di parole/caratteri all'interno del testo selezionato.||

= Prompt dei comandi =

Premendo in modalità '''normale''' il tasto relativo ai due punti ''':''' si aprirà in basso il prompt dei comandi e poco più sopra un lungo elenco di comandi disponibili. Tramite il tasto '''tab''' è possibile scorrere e selezionare la funzionalità desiderata. Per non dover premere il tasto '''tab''' infinite volte, sarà sufficiente digitare le prime lettere di un comando per attivare l'auto completamento.<<BR>>
L'elenco dei comandi eseguiti in precedenza sarà consultabile premendo il tasto '''freccia su ↑'''.

Segue un breve elenco dei principali comandi.

<<Anchor(open)>>
||<:> '''Comando''' ||<:> '''In breve''' ||<:> '''Dscrizione''' ||
|| `:quit` || `:q` || Chiudi Elix. ||
|| `:open` || `:o` || Apri file. ||
|| `:new` || `:n` || Apri un nuovo file.||
|| `:buffer-next` || `:bn` || Passa al successivo file aperto.||
|| `:buffer-close` || `:bc` || Chiudi il file corrente. ||
|| `:buffer-close-others`|| `:bco` || Chiudi gli altri file. ||
|| `:buffer-close-all` || `:bca` || Chiudi tutti i file. ||
|| `:theme` || || Seleziona tema. ||
|| `:config-open` || || Apri il `config.toml` ||
|| `:config-reload`|| || Ricarica la configurazione.||
|| `:run-shell-command` || `:sh` || Esegui comandi da shell (potrebbe non funzionare per tutti i comandi) ||
|| `:lsp-stop` || || Ferma il ''language server protocol'' ||
|| `:lsp-restart`|| || Riavvia il ''language server protocol''||

= Temi =

È possibile testare una vasta gamma di temi presenti di default in '''Helix'''.

 0. In modalità '''normale''' premere ''':theme''' e quindi premere '''spazio''' per aprire la lista dei temi.
 0. Scorrere i temi tramite tasto '''tab'''. Immediatamente verranno applicati.
 0. Premere '''invio''' per utilizzare il tema selezionato.

Per rendere un tema predefinito:
 0. se assente creare il file `~/.config/helix/config.toml`.
 0. Supponendo di voler utilizzare il tema `catppuccin_frappe`, nel file dovrà essere inserita la stringa:{{{
theme = "catppuccin_frappe"
}}}
 0. Salvare e chiudere il file di configurazione.

= Muoversi attraverso il testo =

Sebbene in modalità '''normale''' sia possibile spostarsi fra i caratteri con i tasti '''freccia''', il modo principale è attraverso i tasti '''h''', '''j''', '''k''', '''l''', non a caso la posizione base delle dita della mano destra nell'utilizzo corretto della tastiera.

||<:> '''Tasto''' ||<:> '''Equivalente''' ||<:> '''Sposta il cursore''' ||
||<:> '''h''' ||<:> '''←''' || a sinistra||
||<:> '''j''' ||<:> '''↓''' || giù ||
||<:> '''k''' ||<:> '''↑''' || su ||
||<:> '''l''' ||<:> '''→''' || a destra ||

È possibile velocizzare gli spostamenti saltando di parola in parola selezionandole:

||<:> '''Tasto''' ||<:> '''Caratteri selezionati''' ||
||<:> '''w''' || In avanti fino alla prossima parola esclusa. ||
||<:> '''e''' || Avanti fino all'ultimo carattere della parola corrente.||
||<:> '''b''' || Indietro fino all'inizio della parola. ||

Attraverso la funzione '''Goto''' il cursore può eseguire i seguenti spostamenti:

||<:> '''Tasti''' ||<:> '''Spostamento cursore''' ||
||<:> '''g s''' || Primo carattere riga corrente.||
||<:> '''g h''' || Inizio riga. ||
||<:> '''g l''' || Fine riga. ||
||<:> '''g 8 g''' || Riga numero 8. (Sostituire numero riga a proprio piacimento) ||
||<:> '''g g''' || Inizio file ||
||<:> '''g e''' || Fine file ||

<<Anchor(copia_incolla)>>
= Copia/incolla =

{{{#!wiki important
Nel caso non dovesse funzionare il copia/incolla da finestre esterne, assicurarsi di aver installato il pacchetto [[apt://wl-clipboard|wl-clipboard]].
}}}

Ricordando che '''Helix''' è comunque in grado di incollare del testo selezionato tramite clic centrale del mouse o tap a tre dita sul touchpad, viene qui mostrata una lista di comandi per il copia/incolla in modalità '''normale''':

||<:> '''Tasti''' ||<:> '''Spostamento cursore''' ||
||<:> '''y''' || Copia testo selezionato da incollare sul medesimo file. ||
||<:> '''spazio y''' || Copia testo da incollare su altro file. ||
||<:> '''p''' || Incolla dopo il cursore il testo copiato sul medesimo file. ||
||<:> '''shift p''' || Incolla prima del cursore il testo copiato sul medesimo file. ||
||<:> '''spazio p''' || Incolla dopo il cursore il testo copiato da altro file. ||
||<:> '''spazio shift p''' || Incolla prima del cursore il testo copiato da altro file.||

= Annullare/ripetere azione =

In modalità '''normale''':

|| '''u''' || annulla azione ||
|| '''shift u''' || ripete azione ||

= Selezione multi linea =

 0. È possibile procedere in due modi:
  * In modalità '''normale''' ripetendo la combinazione '''shift c''' il cursore verrà moltiplicato su una linea verticale.
  * Dopo aver selezionato del testo, passando alla modalità di ricerca (tasto '''s''') è possibile digitare la parola da ricercare e quindi premere '''invio'''.

{{{#!wiki tip
Per selezionare tutto il testo in modalità '''normale''' digitare il tasto percentuale '''%'''.
}}}

= Elenchi scorciatoie =

Come si può intuire una delle maggiori difficoltà nell'utilizzo di un editor di testo di questo genere sta nel memorizzare una lunga lista di scorciatoie da tastiera. Tuttavia '''Helix''' mette a disposizione per molte delle sue funzionalità una comoda finestra con relativo elenco di scorciatoie ogni volta che in modalità '''normale''' la funzionalità viene richiamata attraverso relativo tasto di attivazione.

<<Anchor(file_picker)>>
== Space - tasto: spazio ==

Premendo il tasto '''[spazio]''' (''barra spaziatrice'') in basso a destra si aprirà una finestra con una lista di funzionalità attivabili premendo un determinato tasto. Per citarne alcune:
 * '''w''' invoca la lista comandi per suddividere verticalmente od orizzontalmente una finestra;
 * I tasti '''y''' e '''p''' offrono le [[#copia_incolla|già citate]] funzionalità di copia/incolla;
 * I tasti '''e''', '''f''' e '''b''' offrono le [[#file|già citate]] funzionalità di ricerca, selezione e apertura file in stile file manager.
 * Il comando '''k''' richiama la documentazione ufficiale inerente al linguaggio in utilizzo.

== Match - tasto: m ==

Funzionalità utile a gestire parentesi e virgolette per:
 * inserire parentesi intorno al testo selezionato, ad esempio: '''m s ('''
 * selezionare il testo interno alle parentesi: '''m i m'''
 * sostituire parentesi intorno a un testo, ad es. [] con {}: '''m r [ {'''
 * far saltare il cursore fra la parentesi di apertura e di chiusura: '''m m'''
A proposito di parentesi, pur non essendo parte della funzione '''match''', merita una menzione il comando '''alt o'''. Ogni volta che viene premuto espande la selezione del testo fino alle virgolette o parentesi più esterne.

<<Anchor(config)>>
= File di configurazione =

Per adattare '''Helix''' alle proprie esigenze è possibile creare ed editare il file `~/.config/helix/config.toml`. Ciò può essere fatto direttamente da '''Helix''' tramite i seguenti comandi.

 * ''':config-open''': apre il file di configurazione per apportare eventuali modifiche.
 * ''':config-reload''': una volta salvate le modifiche permette di caricare le nuove impostazioni senza dover riavviare '''Helix'''.

{{{#!wiki tip
Il capitolo [[https://docs.helix-editor.com/keymap.html|Keymap]] della documentazione ufficiale mostra i comandi associati alle scorciatoie da tastiera, molto utile per poter associare un comando a una scorciatoia da tastiera che faccia al proprio caso. Il capitolo [[https://docs.helix-editor.com/configuration.html|Configuration]] entra maggiormente nel dettaglio.
}}}

Le righe che iniziano col carattere '''#''' sono commenti.

{{{
# Tema
theme = "catppuccin_frappe"

[editor]
# Sezione generica

# Salvataggio automatico quando la finestra dell'editor perde il focus
auto-save = true
# Visualizza il testo a capo quando la finestra è stretta
soft-wrap.enable = true

[keys.normal]
# Sezione dedicata alla modalità "normale"

# Opzione alternativa di salvataggio file talvolta più comodo di :w
C-q = ":write"

# Bloccare e riattivare il language server protocol
A-s = ":lsp-stop"
A-g = ":lsp-restart"

[keys.insert]
# Sezione dedicata alla modalità "inserisci"

# Muoversi di parola in parola a destra e sinistra tramite i tasti freccia
"C-right" = "move_next_word_start"
"C-left" = "move_prev_word_start"

# Replicare la funzione goto per portare il cursore a inizio linea,
# sul primo carattere di linea e a fine linea
"C-a" = "goto_line_start"
"C-s" = "goto_first_nonwhitespace"
"C-l" = "goto_line_end"

# Salvataggio file
C-q = ":write"
}}}

= LSP =

Per l'installazione dei ''Language Server Protocol'' ('''LSP''') consultare la [[Ufficio/EditorDiTesto/Helix/Lsp|seguente pagina]].

= Ulteriori risorse =

 * [[https://helix-editor.com/|Sito ufficiale]]
 * [[https://docs.helix-editor.com/|Documentazione ufficiale]]
Linea 128: Linea 277:
CategoryComunitaDocumentazione CategoryProgrammazione CategoryProduttivita


Guida verificata con Ubuntu: 24.04

Problemi in questa pagina? Segnalali in questa discussione

Introduzione

Helix è un editor di testo modale utilizzabile nel terminale simile a Vim ma con la differenza di avere fin da subito a disposizione buone impostazioni di default e funzionalità varie in modo che l'editor risulti immediatamente utilizzabile riducendo al minimo eventuali personalizzazioni.

Nonostante Helix possa semplificare la vita rispetto a editor come Vim, NeoVim, Emacs, ecc.. essendo un software evoluto per l'editazione di testi, richiede comunque un certo impegno per impararne l'utilizzo.
In questa guida vengono giusto introdotte alcune nozioni. Per approfondimenti si rimanda all'ottima documentazione ufficiale ed è inoltre consigliabile l'avvio di Helix in modalità tutor, una guida interattiva particolarmente utile per chi stia utilizzando per la prima volta un editor modale.

Per l'installazione dei Language Server Protocol (LSP) consultare la seguente pagina.

Installazione

Installare il pacchetto snap digitando nel terminale:

sudo snap install helix --classic

Da pacchetto .deb

In alternativa Helix può essere installato in formato .deb da un repository esterno.

  1. Aggiungere la nuova sorgente software digitando nel terminale:

    sudo add-apt-repository ppa:maveonair/helix-editor
  2. Installare Helix digitando:

    sudo apt install helix

Avvio e apertura file

Comandi di avvio da terminale:

Comando

Descrizione

hx

Apre l'editor.

helix

Versione estesa del comando precedente.

hx percorso/file

Apre direttaemtne un file all'interno di Helix.

In alternativa oltre al comando :open sono disponibili diverse modalità di ricerca, selezione e apertura file in stile file manager premendo la combinazione dei tasti spazio (barra spaziatrice) e una specifica lettera.

  • File picker, per visionare e aprire file in modo pratico:

    • spazio + f: apre il file picker.

    • spazio + F: apre il file picker nella directory corrente.

  • File explorer, cioè un file manager per navigare le directory e visualizzare e aprire file:

    • spazio + e: apre il file explorer.

    • spazio + E: apre il file explorer nella directory corrente.

  • Buffer picker, elenco dei file aperti nell'attuale sessione;

    • spazio + b: apre il buffer picker.

Se il terminale è aperto a schermo intero, sulla destra sarà visibile un'anteprima del file selezionato.

Chiusura

Questi i comandi da editor di chiusura da digitare in modalità normale:

Comando

Descrizione

:q

Chiude la sessione di Helix.

:q!

Chiude la sessione senza salvare eventuali modifiche.

:wq

Salva le modifiche e chiude la sessione.

Modalità

Trattandosi di un editor modale, per ogni tipologia di azione è prevista una modalità che deve essere attivata. All'apertura di un file Helix sarà in modalità normale, cioè una modalità che permette di muoversi attraverso il testo e applicare modifiche come spostare o copia/incollare il testo stesso. Per poter inserire caratteri sarà necessario passare alla modalità inserimento tramite il tasto i. Con il tasto Esc si ritornerà sempre alla modalità normale.

Niente esclude che a proprio piacimento l'utente possa impostare scorciatoie da tastiera che permettano di sfruttare azioni non previste nella modalità originaria. Ad esempio è possibile attivare scorciatoie da tastiera che permettano in modalità inserimento di spostarsi velocemente fra le righe del testo.

Da notare che mouse e touchpad continueranno a funzionare come di consueto e potranno essere utilizzati per selezionare del testo e incollarlo tramite clic centrale o tap a tre dita.

Segue un elenco con alcune modalità:

Modalità

Tasti

Descrizione

Normale

Esc

Modalità predefinita nella quale è possibile scorrere, selezionare, copiare, incollare testo e altro. Si ritorna ad essa premendo Esc.

Inserimento

i

Inserimento.

c

Inserimento cancellando il testo selezionato.

o

Inserimento a capo.

I

Inserimento a inizio riga.

A

Inserimento a fine riga.

Selezione

v

I tasti per muoversi attraverso il testo faranno si che il testo venga selezionato.

Ricerca

s

Da attivare dopo aver selezionato del testo. Permette la ricerca di parole/caratteri all'interno del testo selezionato.

Prompt dei comandi

Premendo in modalità normale il tasto relativo ai due punti : si aprirà in basso il prompt dei comandi e poco più sopra un lungo elenco di comandi disponibili. Tramite il tasto tab è possibile scorrere e selezionare la funzionalità desiderata. Per non dover premere il tasto tab infinite volte, sarà sufficiente digitare le prime lettere di un comando per attivare l'auto completamento.
L'elenco dei comandi eseguiti in precedenza sarà consultabile premendo il tasto freccia su ↑.

Segue un breve elenco dei principali comandi.

Comando

In breve

Dscrizione

:quit

:q

Chiudi Elix.

:open

:o

Apri file.

:new

:n

Apri un nuovo file.

:buffer-next

:bn

Passa al successivo file aperto.

:buffer-close

:bc

Chiudi il file corrente.

:buffer-close-others

:bco

Chiudi gli altri file.

:buffer-close-all

:bca

Chiudi tutti i file.

:theme

Seleziona tema.

:config-open

Apri il config.toml

:config-reload

Ricarica la configurazione.

:run-shell-command

:sh

Esegui comandi da shell (potrebbe non funzionare per tutti i comandi)

:lsp-stop

Ferma il language server protocol

:lsp-restart

Riavvia il language server protocol

Temi

È possibile testare una vasta gamma di temi presenti di default in Helix.

  1. In modalità normale premere :theme e quindi premere spazio per aprire la lista dei temi.

  2. Scorrere i temi tramite tasto tab. Immediatamente verranno applicati.

  3. Premere invio per utilizzare il tema selezionato.

Per rendere un tema predefinito:

  1. se assente creare il file ~/.config/helix/config.toml.

  2. Supponendo di voler utilizzare il tema catppuccin_frappe, nel file dovrà essere inserita la stringa:

    theme = "catppuccin_frappe"
  3. Salvare e chiudere il file di configurazione.

Muoversi attraverso il testo

Sebbene in modalità normale sia possibile spostarsi fra i caratteri con i tasti freccia, il modo principale è attraverso i tasti h, j, k, l, non a caso la posizione base delle dita della mano destra nell'utilizzo corretto della tastiera.

Tasto

Equivalente

Sposta il cursore

h

a sinistra

j

giù

k

su

l

a destra

È possibile velocizzare gli spostamenti saltando di parola in parola selezionandole:

Tasto

Caratteri selezionati

w

In avanti fino alla prossima parola esclusa.

e

Avanti fino all'ultimo carattere della parola corrente.

b

Indietro fino all'inizio della parola.

Attraverso la funzione Goto il cursore può eseguire i seguenti spostamenti:

Tasti

Spostamento cursore

g s

Primo carattere riga corrente.

g h

Inizio riga.

g l

Fine riga.

g 8 g

Riga numero 8. (Sostituire numero riga a proprio piacimento)

g g

Inizio file

g e

Fine file

Copia/incolla

Nel caso non dovesse funzionare il copia/incolla da finestre esterne, assicurarsi di aver installato il pacchetto wl-clipboard.

Ricordando che Helix è comunque in grado di incollare del testo selezionato tramite clic centrale del mouse o tap a tre dita sul touchpad, viene qui mostrata una lista di comandi per il copia/incolla in modalità normale:

Tasti

Spostamento cursore

y

Copia testo selezionato da incollare sul medesimo file.

spazio y

Copia testo da incollare su altro file.

p

Incolla dopo il cursore il testo copiato sul medesimo file.

shift p

Incolla prima del cursore il testo copiato sul medesimo file.

spazio p

Incolla dopo il cursore il testo copiato da altro file.

spazio shift p

Incolla prima del cursore il testo copiato da altro file.

Annullare/ripetere azione

In modalità normale:

u

annulla azione

shift u

ripete azione

Selezione multi linea

  1. È possibile procedere in due modi:
    • In modalità normale ripetendo la combinazione shift c il cursore verrà moltiplicato su una linea verticale.

    • Dopo aver selezionato del testo, passando alla modalità di ricerca (tasto s) è possibile digitare la parola da ricercare e quindi premere invio.

Per selezionare tutto il testo in modalità normale digitare il tasto percentuale %.

Elenchi scorciatoie

Come si può intuire una delle maggiori difficoltà nell'utilizzo di un editor di testo di questo genere sta nel memorizzare una lunga lista di scorciatoie da tastiera. Tuttavia Helix mette a disposizione per molte delle sue funzionalità una comoda finestra con relativo elenco di scorciatoie ogni volta che in modalità normale la funzionalità viene richiamata attraverso relativo tasto di attivazione.

Space - tasto: spazio

Premendo il tasto [spazio] (barra spaziatrice) in basso a destra si aprirà una finestra con una lista di funzionalità attivabili premendo un determinato tasto. Per citarne alcune:

  • w invoca la lista comandi per suddividere verticalmente od orizzontalmente una finestra;

  • I tasti y e p offrono le già citate funzionalità di copia/incolla;

  • I tasti e, f e b offrono le già citate funzionalità di ricerca, selezione e apertura file in stile file manager.

  • Il comando k richiama la documentazione ufficiale inerente al linguaggio in utilizzo.

Match - tasto: m

Funzionalità utile a gestire parentesi e virgolette per:

  • inserire parentesi intorno al testo selezionato, ad esempio: m s (

  • selezionare il testo interno alle parentesi: m i m

  • sostituire parentesi intorno a un testo, ad es. [] con {}: m r [ {

  • far saltare il cursore fra la parentesi di apertura e di chiusura: m m

A proposito di parentesi, pur non essendo parte della funzione match, merita una menzione il comando alt o. Ogni volta che viene premuto espande la selezione del testo fino alle virgolette o parentesi più esterne.

File di configurazione

Per adattare Helix alle proprie esigenze è possibile creare ed editare il file ~/.config/helix/config.toml. Ciò può essere fatto direttamente da Helix tramite i seguenti comandi.

  • :config-open: apre il file di configurazione per apportare eventuali modifiche.

  • :config-reload: una volta salvate le modifiche permette di caricare le nuove impostazioni senza dover riavviare Helix.

Il capitolo Keymap della documentazione ufficiale mostra i comandi associati alle scorciatoie da tastiera, molto utile per poter associare un comando a una scorciatoia da tastiera che faccia al proprio caso. Il capitolo Configuration entra maggiormente nel dettaglio.

Le righe che iniziano col carattere # sono commenti.

# Tema
theme = "catppuccin_frappe"

[editor]
# Sezione generica

# Salvataggio automatico quando la finestra dell'editor perde il focus  
auto-save = true
# Visualizza il testo a capo quando la finestra è stretta
soft-wrap.enable = true

[keys.normal]
# Sezione dedicata alla modalità "normale"

# Opzione alternativa di salvataggio file talvolta più comodo di :w
C-q = ":write"

# Bloccare e riattivare il language server protocol
A-s = ":lsp-stop"
A-g = ":lsp-restart"

[keys.insert]
# Sezione dedicata alla modalità "inserisci"

# Muoversi di parola in parola a destra e sinistra tramite i tasti freccia
"C-right" = "move_next_word_start"
"C-left" = "move_prev_word_start"

# Replicare la funzione goto per portare il cursore a inizio linea,
# sul primo carattere di linea e a fine linea
"C-a" = "goto_line_start"
"C-s" = "goto_first_nonwhitespace"
"C-l" = "goto_line_end"

# Salvataggio file
C-q = ":write"

LSP

Per l'installazione dei Language Server Protocol (LSP) consultare la seguente pagina.

Ulteriori risorse


CategoryProgrammazione CategoryProduttivita