Modalità VI

Introduzione

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.

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 and Ctrl+r is redo
   Vim: Ctrl+r is normal redo, U is used to undo all latest changes on one line
   The reason for having U act as redo in Kate's VI mode is that the shortcut ctrl+r by default is taken by Kate's replace function (search and replace). By default, the VI mode won't override Kate's shortcuts (this can be configured in Settings → Configure Kate… → Editing → Vi Input Mode), therefore a redo-action needs to be available as a “regular” key press, too. Besides, the behaviour of the U command in Vim doesn't map well to Kate's internal undo system, so it would be non-trivial to support anyway.
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

Movimenti supportati

Oggetti di testo supportati

Comandi supportati nella modalità di inserimento

The Comma Text Object

This is something that I have been missing in Vim. The comma text object makes it easy to modify parameter lists in C-like languages and other comma separated lists. It is basically the area between two commas or between a comma and a bracket. In the line shown in the illustration to the right, the three ranges this text object can span are highlighted in red.

Comma text object ranges. If the cursor is over, say, “arg2”, pressing c i , (“change inner comma”) would delete “double arg2” and place the cursor between the two commas in insert mode. A very convenient way to change a function's parameters.

Emulated Vim Command Bar

Kate 4.11 introduced a hidden config option that make /, ? and : bring up a new search/ command in place of the usual Kate Find / Replace / Command-line bar. The bar is intended to replicate many of the features of Vim's command bar, and also to fix many of the issues with Kate Vim mode's interaction with Kate's Find/Replace bar (interactive replace not working; incremental search not positioning the cursor correctly; not usable in mappings/macros; etc).

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

The "context-specific completion" is decided as follows:

• In a search bar (/ or ?), auto-complete from search history (which includes searches initiated via *; and #; searches done in sed-replace expressions; etc.)
• In an empty command bar (:), auto-complete from command history (NB: auto-completion of command names is invoked automatically when you begin typing).
• In a command-bar containing a sed-replace expression (e.g. :s/find/replace/gc), if the cursor is positioned over "find", auto-complete from the "search" history; if over the "replace", auto-complete from the history of "replace" terms.

When executing a sed-replace expression in the command bar with the "c" flag (e.g. s/find/replace/gc), a Vim-style interactive search/replace expression will be initiated.

Some example usages of the emulated command bar, with GIF animations, are given in this blog. In 4.11, the emulated command bar can be enabled by setting the hidden config option "Vi Input Mode Emulate Command Bar" to true in your 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

• Visual block mode – especially the ability to prepend/append text to the visual block selection.
• Having ex commands available in other programs than the Kate application.
• The search code needs improvement and the * and # commands should just be regular searches.

If you miss other features or want to help on the ones mentioned above, feel free to contact me or send patches! :-)

Elenco modifiche

• 16/05/2010:
  Versione iniziale. Ha raccolto le informazioni dalle voci del blog e dai file di R delle informazioni correnti.
• 17/05/2010:
  aggiunti Ctrl+A e Ctrl+X (incrementa o decrementa i numeri sotto il cursore).
• 30/08/2010:
  ho spostato la pagina su kate-editor.org.
• 2010-09-10:
  Fixed the text on the comma text object and made some formatting fixes
• 2021-02-03:
  Converted key-binding tables to markdown for hugo.