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 2 e 83 (in 81 versioni)
Versione 2 del 23/11/2012 18.37.59
Dimensione: 2748
Autore: jeremie2
Commento:
Versione 83 del 22/11/2024 23.09.58
Dimensione: 10277
Autore: jeremie2
Commento:
Le cancellazioni sono segnalate in questo modo. Le aggiunte sono segnalate in questo modo.
Linea 1: Linea 1:
#acl GruppoAdmin:admin,read,write,revert GruppoEditori:read,write,revert Known:read
#format wiki
#LANGUAGE it
#format wiki
#language it
<<BR>>
<<Indice(depth=1)>>
Linea 5: Linea 6:
||<tablestyle="font-size: 0.9em; text-align: center; border: none; width: 100%; background-color: #f7f7f7; font-weight: bold; table-layout: fixed;"> [[http://wiki.ubuntu-it.org/GruppoDocumentazione| {{http://wiki.ubuntu-it.org/GruppoDocumentazione/Header2?action=AttachFile&do=get&target=02.png}}]]<<BR>> [[http://wiki.ubuntu-it.org/GruppoDocumentazione/Benvenuto|Benvenuto]] || [[http://wiki.ubuntu-it.org/GruppoDocumentazione| {{http://wiki.ubuntu-it.org/GruppoDocumentazione/Header2?action=AttachFile&do=get&target=01.png}}]]<<BR>> [[http://wiki.ubuntu-it.org/GruppoDocumentazione|Gruppo Documentazione]] || [[http://wiki.ubuntu-it.org/GuidaWiki| {{http://wiki.ubuntu-it.org/GruppoDocumentazione/Header2?action=AttachFile&do=get&target=04.png}}]]<<BR>> [[http://wiki.ubuntu-it.org/GuidaWiki|Guida Wiki]] ||
||||||<style="font-size: 0.90em; border: 2px; background-color: #cccccc;"> !WiKi||
= Introduzione =
Linea 8: Linea 8:
##<<Include(GruppoDocumentazione/Header2)>> '''Helix''' è un editor di testo modale utilizzabile nel [[AmministrazioneSistema/Terminale|terminale]] simile a '''Vim''' ma con la caratteristica particolare di ridurre al minimo eventuali configurazioni per avere un editor da subito pronto all'utilizzo con ottime funzionalità a portata di mano.
Linea 10: Linea 10:
<<Include(GruppoDocumentazione/Header3)>> Nonostante '''Helix''' possa semplificare la vita rispetto a editor come '''Vim''', '''!NeoVim''', '''Emacs''', ecc.. essendo un software evoluto per l'editazione di testi in ambito di programmazione/amministrazione di sistema, richiede comunque un certo impegno per impararne l'utilizzo.<<BR>>
In questa guida vengono introdotti alcuni elementi base, per maggiori approfondimenti il sito ufficiale ospita un'ottima [[https://docs.helix-editor.com/|documentazione]] ed è inoltre consigliabile l'avvio di '''Helix''' in modalità [[https://docs.helix-editor.com/usage.html|tutor]], una guida interattiva passo passo particolarmente utile per chi stia utilizzando per la prima volta un editor modale.
Linea 12: Linea 13:
<<BR>>
<<Indice(depth=2 align=right)>>
= Installazione =
Linea 15: Linea 15:
= Guida wiki = Installare il pacchetto [[AmministrazioneSistema/InstallareProgrammi/PacchettiSnap|snap]] digitando nel [[AmministrazioneSistema/Terminale|terminale]]:{{{
sudo snap install helix --classic
}}}
Linea 17: Linea 19:
In questa pagina sono elencati numerosi link a guide con informazioni utili per l'editazione delle pagine e operazioni di vario genere. = Avvio e chiusura =
Linea 19: Linea 21:
= Per gli utenti = Questi i comandi basilari per l'avvio di '''Helix''' da '''terminale''':
Linea 21: Linea 23:
Se non hai esperienza la [[Wiki10Passi|Guida al wiki in 10 passi più uno]] mostra come si ottengono: grassetti, corsivi, link, titoli, ecc.. ||<:> '''Comando''' ||<:> '''Descrizione''' ||
|| `hx` || Apre l'editor. ||
|| `helix` || Versione estesa del comando precedente. ||
|| `hx percorso/file` || Apre direttaemtne un file all'interno di Helix.||
Linea 23: Linea 28:
Per l'editazione della pagina è in primo luogo importante concentrarsi sulla correttezza dei contenuti tecnici. È poi cura dello [[GruppoDocumentazione|staff]] durante la revisione correggere l'impostazione e i formati... ovviamente sarà apprezzata ogni tua attenzione al formato della pagina! {{{#!wiki tip
In alternativa per l'apertura dei file è possibile sfruttare il '''file picker''' o il comando ''':open'''.
}}}
Linea 25: Linea 32:
Il [[GuidaWiki/GlossarioRapido|Glossario rapido]] mostra una breve lista delle frasi di maggiore uso e formato dei nomi. Tuttavia ricordati che per scrivere la propria guida la cosa più semplice è prendere spunto dalle pagine esistenti. A tal proposito dal menù a tendina '''Altre azioni''', presente in ogni pagina dopo il login, è possibile selezionare la voce '''Mostra il testo grezzo''' per visualizzeranno i formati utilizzati. Questi i comandi da '''editor''' di chiusura da digitare in modalità '''normale''':
Linea 27: Linea 34:
= In caso di dubbi = ||<:> '''Comando''' ||<:> '''Descrizione''' ||
|| `:q` || Chiude la sessione di Helix. ||
|| `:q!` || Chiude la sessione senza salvare eventuali modifiche.||
|| `:wq` || Salva le modifiche e chiude la sessione. ||
Linea 29: Linea 39:
I link in cima a questa pagina sono a portata di mano per risolvere buona parte delle problematiche relative all'editing delle pagine wiki. Tuttavia in caso di ulteriori dubbi '''non esitare''' a chiedere aiuto nei canali di supporto: [[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://webchat.freenode.net/?channels=ubuntu-it-doc|#ubuntu-it-doc]]. = 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.

{{{#!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.||

= Prompt dei comandi =

Come probabilmente già notato per i comandi di salvataggio e chiusura, il prompt dei comandi si aprirà in basso premendo il tasto dei due punti ''':''' e al contempo si aprirà un vasto elenco di comandi disponibili. Tramite il tasto '''tab''' è possibile scorrere e selezionare la funzionalità desiderata. 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''||

= Impostare tema =

È possibile testare una vasta gamma di temi automaticamente disponibili per '''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 uno dei temi.

Per rendere un tema predefinito:
 0. 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. ||

Per velocizzare gli spostamenti e saltare 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 =

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

{{{#!wiki note
In alternativa da mouse e touchpad è possibile incollare il testo selezionato tramite clic centrale o tap a tre dita.
}}}

= Annullare/ripetere azione =

In modalità '''normale''':

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

= 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 ==

In basso a destra si aprirà una finestra con svariate funzionalità. Per citarne alcune:
 * '''f''' e '''F''' aprono il '''file picker''', comodo e pratico per aprire file;
 * '''b''' per invocare il '''buffer picker''' ossia tutti i file aperti nell'attuale sessione;
 {{{#!wiki tip
Sia per il '''file''' che per il '''buffer picker''', se il terminale è aperto a schermo intero, oltre all'elenco dei file sarà visibile anche un'anteprima del file selezionato.
}}}
 * '''w''' invoca la lista comandi per suddividere verticalmente od orizzontalmente una una finestra;
 * Vengono elencati i [[#copia_incolla|già citati]] comandi '''y''' e '''p''' per il copia/incolla;
 * Il comando '''k''' per richiamare 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.


= Ulteriori risorse =

Linea 32: Linea 177:
CategoryComunitaDocumentazione CategoryHomepage


Introduzione

Helix è un editor di testo modale utilizzabile nel terminale simile a Vim ma con la caratteristica particolare di ridurre al minimo eventuali configurazioni per avere un editor da subito pronto all'utilizzo con ottime funzionalità a portata di mano.

Nonostante Helix possa semplificare la vita rispetto a editor come Vim, NeoVim, Emacs, ecc.. essendo un software evoluto per l'editazione di testi in ambito di programmazione/amministrazione di sistema, richiede comunque un certo impegno per impararne l'utilizzo.
In questa guida vengono introdotti alcuni elementi base, per maggiori approfondimenti il sito ufficiale ospita un'ottima documentazione ed è inoltre consigliabile l'avvio di Helix in modalità tutor, una guida interattiva passo passo particolarmente utile per chi stia utilizzando per la prima volta un editor modale.

Installazione

Installare il pacchetto snap digitando nel terminale:

sudo snap install helix --classic

Avvio e chiusura

Questi i comandi basilari per l'avvio di Helix 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 per l'apertura dei file è possibile sfruttare il file picker o il comando :open.

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.

Prompt dei comandi

Come probabilmente già notato per i comandi di salvataggio e chiusura, il prompt dei comandi si aprirà in basso premendo il tasto dei due punti : e al contempo si aprirà un vasto elenco di comandi disponibili. Tramite il tasto tab è possibile scorrere e selezionare la funzionalità desiderata. 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

Impostare tema

È possibile testare una vasta gamma di temi automaticamente disponibili per 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 uno dei temi.

Per rendere un tema predefinito:

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

Per velocizzare gli spostamenti e saltare 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

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.

In alternativa da mouse e touchpad è possibile incollare il testo selezionato tramite clic centrale o tap a tre dita.

Annullare/ripetere azione

In modalità normale:

u

annulla azione

shift u

ripete azione

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

In basso a destra si aprirà una finestra con svariate funzionalità. Per citarne alcune:

  • f e F aprono il file picker, comodo e pratico per aprire file;

  • b per invocare il buffer picker ossia tutti i file aperti nell'attuale sessione;

    Sia per il file che per il buffer picker, se il terminale è aperto a schermo intero, oltre all'elenco dei file sarà visibile anche un'anteprima del file selezionato.

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

  • Vengono elencati i già citati comandi y e p per il copia/incolla;

  • Il comando k per richiamare 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.

Ulteriori risorse


CategoryHomepage