Come posso navigare verso gli argomenti nella documentazione di Vim?

Nel sistema di aiuto integrato di Vim, come posso ...

• cercare argomenti su cui voglio aiuto?
• seguire i collegamenti ipertestuali?
• cercare materiale correlato?

Vim viene fornito con una documentazione esauriente e completamente indicizzata che contiene le risposte alla maggior parte delle domande che potresti avere sull'uso di Vim.

Ma la documentazione è enorme e può guardare al neofita come un labirinto impenetrabile. Ecco alcune linee guida per aiutarti a trovare quello che ti serve ...

1. Il :helpcomando è il gateway per la documentazione di Vim. Leggi la prima schermata ora .

   :help
   

   Andiamo meta:

   :help help
   

2. È possibile completare gli argomenti con <Tab>e visualizzare l'elenco dei possibili completamenti con <C-d>.

   :help buf<Tab>
   :help :w<C-d>
   

   A proposito, ecco una spiegazione della notazione chiave:

   :help key-notation
   

3. La maggior parte dei comandi Ex può essere ridotta a pochi caratteri. Questo vale :helpanche per :

   :h
   

4. Il :helpcomando e il suo completamento con tabulazione non fanno distinzione tra maiuscole e minuscole, quindi i due comandi seguenti ti porteranno alla stessa sezione:

   :h BufWritePost
   :h bufwritepost
   

   Si noti che ae Asono entrambi i comandi legittimi in modo caso-insensibilità non si applica.

5. Se hai solo una parola chiave generica da cercare, usa :helpgrepe apri la finestra di correzione rapida:

   :helpgrep quickfix
   :copen
   

6. Usa <C-]>le parole evidenziate per saltare al tag corrispondente, usa <C-t>per tornare indietro.

   Vedi :help tagsdi più.

7. Scorri per vedere se esiste un'opzione o un comando correlati che si adatta meglio alle tue esigenze. È anche un ottimo modo per imparare nuovi trucchi.

8. Utilizzare la sintassi corretta per eseguire ricerche in modo più efficiente:

   :h :command                        " help for ex-command 'command'
   :h 'option'                        " help for option 'option'
   :h function()                      " help for function 'function'
   :h modifier-key                    " help for 'modifier'-'key' in normal mode
   :h mode_modifier-key               " help for 'modifier'-'key' in 'mode'
   :h mode_modifier-key_modifier-key  " help for 'modifier'-'key' 'modifier'-'key' in 'mode'
   

   Esempi:

   :h :sort
   :h 'ai                " only one quote needed
   :h bufnr(             " no need for both parenthesis
   :h v_ctrl-g
   :h i_ctrl-x_ctrl-o
   :h ctrl-w             " no mode required for normal mode
   

9. Anatomia di una :helpsezione:

   :help ballooneval'
   

   

   • Le parole evidenziate in rosso sono i tag associati a quell'opzione.
   • Le parole in verde sono la forma lunga e la forma abbreviata del nome dell'opzione.
   • La prima riga in bianco dice che è un'opzione booleana e che è disattivata per impostazione predefinita, vedi :help options.
   • La seconda riga in bianco dice che l'opzione è globale, vedi :help option-summary.
   • Le linee viola sono autoesplicative.
   • Quindi viene la descrizione dell'opzione.
   • Le parole turchesi sono "tag" che consentono di passare a un'altra parte della documentazione. Non aver paura di seguirli.

10. Usa il tuo cervello, trova schemi logici che ti aiuteranno per ricerche future.

    Una volta trovato il pratico :help list-functions, dove cercare le funzioni relative alle stringhe?

    Una volta trovato :help i_ctrl-x_ctrl-o, come puoi trovare aiuto per la <C-x><C-l>modalità di inserimento?

11. RTFM non è un insulto. Si impara molto di più leggendo la documentazione che facendo domande miope estranei casuali in modo da essere sicuri di almeno tentato di R ead T ha F antastic M anuale prima di chiedere.

-0.1 prendere appunti su vim in un file. Usalo come riferimento e contenitore.

1. modo veloce per trovare vim aiuto di key | :cmd | 'option' | etc

   • :h gio :h g;per gio g;in modalità normale
   • :h ^iper Ctrl- iin modalità normale
   • :h ^w^wper Ctrl- wCtrl- win modalità normale
   • :h ^wfper Ctrl- wfin modalità normale
   • :h i^nper la modalità di inserimento Ctrl-n
   • :h c^r^rper la modalità cmdline Ctrl- r Ctrl-r
   • :h :pu per ex comando :put
   • :h 'cb'per opzione clipboard.
   • :h `>per mark <.
   • :h @:per opzione repeat last ex command by eval register :(stesso meccanismo della macro).

   • digita :h range, in questo momento sei in modalità cmdline, quindi:

     • digitare Ctrl- aper completare tutti i candidati che contengonorange
     • digitare Ctrl- fper visualizzare una piccola finestra di modifica[Command Line]
     • digitare "*ddper tagliarlo negli appunti di sistema.
     • digitare oe Enterper cancellare ed uscire dalla finestra[Command Line]
     • h :range range() <range> [range] :func-range ... è estratto
     • allo stesso modo, h mode-Ex mode-replace mode-cmdline mode-switching ...viene estratto mode-.
     • parola simile che potrebbe essere di interesse: buf win tab lineecc.
     • riepilogo: questo mostra un modo per trovare elementi interessanti dati una parola chiave con l'aiuto di cmdline-completion.

-0.2 definisce una mappatura della chiave buffer-local per invocare l'aiuto di vim della parola sotto il cursore, quando nel file di note di vim precedentemente menzionato.
(e possibilmente con post-elaborazione dopo l'estrazione <cword>, in una funzione vimscript)