Passa al contenuto

Modalità VI

Introduzione

Vim Logo

La modalità VI di Kate è un progetto per portare nell'editor di testo Kate e nelle estensioni degli altri programmi di KDE che condividono lo stesso componente una modalità di modifica simile a quella di Vim. È stata iniziata come progetto di Google Summer of Code nel 2008, quando sono state scritte tutte le funzionalità di base. Ho continuato a mantenere e a sviluppare ulteriormente questo codice, e il numero delle funzionalità mancanti rispetto a Vim è leggermente diminuito: la maggior parte degli utenti di Vim è già produttiva nella modalità VI di Kate. Un elenco che cosa manca si trova alla fine della pagina.

Questa pagina dà una panoramica aggiornata su questo lavoro.

Per abilitare la modalità di modifica VI, vai in
Impostazioni → Configura Kate… → Modifica → Modalità di inserimento VI.
Può essere attivata e disattivata anche con l'impostazione «Modalità di inserimento VI» nel menu «Modifica» (la scorciatoia predefinita è Meta+Ctrl+V; in genere Meta è il tasto Windows).

Obiettivi

L'obiettivo della modalità Vi non è quello di essere un sostituto completo di Vim e di supportare tutte le sue funzionalità. Il suo scopo è rendere disponibile la modifica del testo "alla Vim", e le abitudini ad essa legate, ai programmi che usano al loro interno l'editor di testo Kate come editor. Tra questi ci sono

  1. L'editor di testo Kate
  2. KWrite - l'editor di testo semplice di KDE
  3. KDevelop - un IDE avanzato per molti linguaggi di programmazione
  4. Kile - un editor LaTeX

La modalità Vi punta ad integrarsi bene con i programmi, e devia dal comportamento di Vim quando ciò ha senso. Per esempio, :w aprirà una finestra di salvataggio nella modalità Vi di Kate.

Incompatibilità con Vim

Ci sono solo solo poche funzionalità della modalità Vi di Kate che sono incompatibili con Vim (non contando quelle mancanti). Sono elencate sotto, con le rispettive motivazioni.

  1. Kate: U e Ctrl+r sono rifai
    Vim: Ctrl+r è il normale rifai, mentre U viene usato per annullare tutte le modifiche recenti a una riga
    La ragione per cui nella modalità di inserimento Vi di Kate U si comporta come rifai, è che la scorciatoia ctrl+r viene presa dalla funzione sostituisci di Kate (cerca e sostituisci). Per impostazione predefinita la modalità di inserimento VI non sostituisce le scorciatoie di Kate (ma questo può essere configurato in Impostazioni → Configura Kate... → Modifica → Modalità di inserimento Vi), quindi anche un'azione di rifai deve essere disponibile alla pressione di un tasto "normale". Inoltre il comportamento del comando U di Vim non si associa bene al sistema annulla interno di Kate, perciò non sarebbe comunque banale supportarlo.
  2. Kate: :print shows the "print" dialogue
    Vim: :print prints the lines of the given range like its grandfather ed Commands like :print are available not only in the VI mode but for users using “regular” Kate, too – I have therefore chosen to let the :print command open the print dialogue – following the principle of least surprise instead of mimicking Vim's behaviour.
  3. Kate: Y yanks to end of line.
    Vim: Y yanks whole line, just like yy. VI's behaviour for the Y command is in practice a bug; For both change and delete commands, cc/dd will do its action on the current line and C/D will work from the cursor column to the end of the line. However, both yy and Y yanks the current line.In Kate's VI Mode Y will yank to the end of the line. This is described as "more logical" in the Vim documentation.
  4. Kate: :map alters the selected lines of the document using the provided JavaScript expression.
    Vim: :map adds the provided mapping to Normal and Visual modes. The "map" command was already reserved by Kate; in 4.12+, you can use a combination of :nmap and :vmap to replace it.

Comandi supportati

Comandi supportati nelle modalità normale e visuale

TastoDescrizione
aEntra nella modalità di inserimento e aggiungi
AEntra nella modalità di inserimento e aggiungi a fine riga
iEntra nella modalità di inserimento
IInserisci prima del primo carattere non vuoto sulla riga
vEntra in modalità visuale
VEnter Visual Line Mode
<c-v>Enter Visual Block Mode
gvRiseleziona Visuale
oApri nuova riga sotto
OApri nuova riga sopra
JUnisci righe
cModifica
CChange to EOL
ccModifica riga
sSostituisci carattere
SSostituisci riga
ddElimina riga
dElimina
DCancella fino a fine riga
xElimina carattere
XElimina carattere all'indietro
guMetti in minuscolo
guuMetti riga in minuscolo
gUMetti in maiuscolo
gUUMetti riga in maiuscolo
yCopia
yyCopia riga
YCopia fino a fine riga
pIncolla
PIncolla prima
r.Sostituisci carattere
REntra in modalità di sostituzione
:Passa alla riga di comando
/Cerca
uAnnulla
<c-r>Rifai
URifai
m.Imposta contrassegno
>>Fai rientrare la riga
<<Riduci il rientro della riga
>Fai rientrare le righe
<Riduci il rientro delle righe
<c-f>Scorri una pagina in giù
<pag giù>Scorri una pagina in giù
<c-b>Scorri una pagina in su
<pag su>Scorri una pagina in su
<c-u>Scorri mezza pagina in su
<c-d>Scorri una pagina in su
zzCentra la vista sul cursore
gaStampa codice carattere
.Ripeti l'ultima modifica
==Allinea riga
=Allinea righe
~Cambia maiuscole/minuscole
<c-a>Aggiungi a numero
<c-x>Sottrai da numero
<c-o>Vai al salto precedente
<c-i>Vai al salto successivo
<c-w>hPassa alla vista sinistra
<c-w><c-h>Passa alla vista sinistra
<c-w><left>Passa alla vista sinistra
<c-w>jPassa alla vista sotto
<c-w><c-j>Passa alla vista sotto
<c-w><down>Passa alla vista sotto
<c-w>kPassa alla vista sopra
<c-w><c-k>Passa alla vista sopra
<c-w><up>Passa alla vista sopra
<c-w>lPassa alla vista a destra
<c-w><c-l>Passa alla vista a destra
<c-w><destra>Passa alla vista a destra
<c-w>wPassa alla vista successiva
<c-w><c-w>Passa alla vista successiva
<c-w>sDividi orizzontalmente
<c-w>SDividi orizzontalmente
<c-w><c-s>Dividi orizzontalmente
<c-w>vDividi verticalmente
<c-w><c-v>Dividi verticalmente
gtPassa alla scheda successiva
gTPassa alla scheda precedente
gqqFormatta riga
gqFormatta righe
q. / qInizia / termina la registrazione di macro usando il registratore di macro con nome.

Movimenti supportati

TastoDescrizione
hSinistra
<sinistra>Sinistra
<backspace>Sinistra
jGiù
<giù>Giù
<invio>Giù fino al primo non vuoto
kSu
<su>Su
Su fino al primo non vuoto
lDestra
<destra>Destra
<spazio>Destra
$A fine riga
<fine>A fine riga
Alla colonna 0
<home>Alla colonna 0
^Al primo carattere della riga
f.Trova carattere
F.Trova carattere all'indietro
t.Al carattere
T.Al carattere all'indietro
;Ripeti l'ultimo comando t. o f.
,Ripeti l'ultimo comando t. o f.
nTrova successivo
NTrova precedente
ggAlla prima riga
GAll'ultima riga
wParola in avanti
WPAROLA in avanti
bParola indietro
BPAROLA indietro
eAlla fine della parola
EAlla fine della PAROLA
geAlla fine delle parola precedente
gEAlla fine delle PAROLA precedente
%Al carattere corrispondente
`[a-zA-Z><]Al contrassegno
'[a-zA-Z><]To mark line
[[To previous brace block start
]]To next brace block start
[]To previous brace block end
][To next brace block end
*L'occorrenza successiva della parola sotto il cursore
#L'occorrenza precedente della parola sotto il cursore
HAlla prima riga della finestra
MAlla riga in mezzo alla finestra
LAll'ultima riga della finestra
gjAlla riga visuale successiva
gkAlla riga visuale precedente

Oggetti di testo supportati

TastoDescrizione
iwParola interna
awUna parola
iWPAROLA interna
aWUna PAROLA
i"Virgolette doppie interne
a"Una virgoletta interna doppia
i’Virgoletta singola interna
a’Una virgoletta interna singola
i`Virgoletta posteriore interna
a`Una virgoletta posteriore
ibParentesi interna
i)Parentesi interna
i(Parentesi interna
abUna parentesi
a)Una parentesi
a(Una parentesi
iBParentesi graffa interna
o}Parentesi graffa interna
i{Parentesi graffa interna
aBUna parentesi graffa
a}Una parentesi graffa
a{Una parentesi graffa
i<Segno di disuguaglianza interno
i>Segno di disuguaglianza interno
a<Un segno di disuguaglianza
a>Un segno di disuguaglianza
i[Parentesi quadra interna
I]Parentesi quadra interna
a[Una parentesi quadra
a]Una parentesi quadra
i,Virgola interna
a,Una virgola

Comandi supportati nella modalità di inserimento

TastoDescrizione
<c-d>Riduci rientro
<c-t>Rientra
<c-e>Inserisci da sotto
<c-y>Inserisci da sopra
<c-w>Elimina la parola
<c-r>.Inserisci il contenuto del registro
<c-o>Passa alla modalità normale per un comando
<c-a>Incrementa il numero sotto il cursore
<c-x>Decrementa il numero sotto il cursore

L'oggetto di testo tra virgole

Questo è un aspetto che mi mancava in Vim. L'oggetto di testo virgola rende semplice la modifica di elenchi di parametri nei linguaggi simili al C e in altri elenchi separati da virgole. È sostanzialmente l'area tra due virgole, o tra una virgola e una parentesi. Nella riga mostrata nell'illustrazione a destra, i tre intervalli che questo oggetto di testo può coprire sono evidenziati in rosso.

comma to

Intervalli degli oggetti di testo tra virgole. Se il cursore è, per esempio, sopra «arg2», premendo c i, «modifica virgola interna», eliminerebbe «doppio arg2» e posizionerebbe il cursore tra le due virgole in modalità di inserimento: un modo molto comodo per modificare i parametri di una funzione.

Barra dei comandi di Vim emulata

Kate 4.11 ha introdotto un'opzione di configurazione nascosta che fa sì che /, ? and : facciano comparire un nuovo comando di ricerca al posto della consueta barra di ricerca e sostituzione o riga di comando di Kate. La barra ha lo scopo di replicare molte delle caratteristiche della barra dei comandi di Vim, e anche di risolvere molti dei problemi di interazione tra la modalità Vim di Kate e la sua barra Trova/Sostituisci (la sostituzione interattiva non funziona, la ricerca incrementale non posiziona correttamente il cursore, inoltre non è utilizzabile nelle mappature, nelle macro, ecc.).

Le seguenti scorciatoie sono fornite dalla barra dei comandi emulati; come per Vim possono essere riassociate con cmap, cnoremap, ecc:

TastoDescrizione
<c-r>.inserisci i contenuti del registro.
<c-r><c-w>Inserire la parola sotto il cursore (nel documento).
<c-p>Invoca il completamento specifico per il contesto (vedi sotto)
sposta indietro o in alto nell'elenco di completamento.
<c-p>Spostati in avanti / indietro nell'elenco di completamento.
<c-space>Estensione Vim di Kate.
Completa automaticamente parola del documento.
<c-d>Estensione Vim di Kate.
In un'espressione di sostituzione sed, (ad esempio s/find/replace/[g][c][i]),
cancella il termine «find» e ci posiziona il cursore.
<c-f>Estensione Vim di Kate.
In un'espressione di sostituzione sed, (ad esempio s/find/replace/[g][c][i]),
cancella il termine «replace» e ci posiziona il cursore.
<c-g>.Kate Vim Extension.
As with ., insert the content of the named register,
but escape it in such a way that when used with a search,
we search for the literal content of the register;
not the content of the register interpreted as a regex.

Il «completamento specifico del contesto» viene deciso come segue:

  • Nella barra di ricerca (/ o ?), il completamento automatico dalla cronologia delle ricerche (che include le ricerche iniziate con *; e #, quelle fatte nelle espressioni di sostituzione sed, eccetera)
  • In una barra di ricerca vuota (:), il completamento automatico dalla cronologia dei comandi (NB: il completamento automatico dei nomi dei comandi viene invocato automaticamente quando inizi a digitare).
  • In una barra dei comandi contenente un'espressione di sostituzione sed, ad esempio :s/find/replace/gc, se il cursore si trova su «find» il completamento automatico avverrà dalla cronologia delle «ricerche», mentre se è sopra «replace», da quella delle «sostituzioni».

Quando si esegue un'espressione di sostituzione sed nella barra dei comandi col contrassegno «c», ad esempio `s/find/replace/gc, inizierà un'espressione di ricerca/sostituzione interattiva in stile Vim.

Alcuni esempi sull'utilizzo della barra dei comandi emulata, con animazioni GIF, sono riportati in questo blog. Nella 4.11 puoi abilitare la barra dei comandi emulata impostando a true l'opzione di configurazione nascosta «Vi Input Mode Emulate Command Bar», che si trova in katerc/kwriterc/kdeveloprc.

Funzionalità mancanti

Come già menzionato, l'obiettivo della modalità Vi di Kate non è supportare il 100% delle funzionalità di Vim, tuttavia ci sono delle funzionalità che sono purtroppo mancanti

  • Modalità blocco visivo: in particolare la possibilità di aggiungere il testo prima o dopo la selezione del blocco visivo.
  • Having ex commands available in other programs than the Kate application.
  • Il codice di ricerca deve essere migliorato, inoltre i comandi * e # dovrebbero essere delle normali ricerche.

Se ti mancano altre funzionalità, o se vuoi contribuire a quelle menzionate sopra, sentiti libero di contattarmi o di inviare patch! :-)

Elenco delle modifiche

  • 16/05/2010:
    Versione iniziale. Ho raccolto le informazioni dalle voci del blog e dai file README per creare un'unica fonte di informazioni aggiornate.
  • 17/05/2010:
    Sono stati aggiunti Ctrl+A e Ctrl+X (incrementa o decrementa i numeri sotto il cursore).
  • 30/08/2010:
    La pagina è stata spostata su kate-editor.org.
  • 10/09/2010:
    Corretto il testo dell'oggetto di testo virgola e apportate alcune correzioni alla formattazione.
  • 03/02/2021:
    Conversione delle tabelle di associazione dei tasti al markdown per hugo.