.. This is the THE VIM Cheet Sheet


*********
VIM Guide
*********

*Under construction*

.. comment

    [NORMAL | INSERT | VISUAL]

    VIMRC Auto configs -> see vimrc file


    MODE Changes

    Normal -> Insert

    - i 
    - o, O

    Insert -> Normal

    - ctrl-c (note, when doing multi-line replace, only this will apply it)
    - Escape 


    MOVE

    - 1 char left       Normal, Visual: [`h`, `<-`], INSERT [`<-`], 
    - 1 char right
    - 1 char up
    - 1 char down
    - Begining of Word  Normal, Visual: 
    - Beginning of Line
    - Beginning of File 
    - End of Word
    - End of Line
    - Enf of File
    - 15 Lines up       Normal, Visual: [`ctrl-u`]
    - 15 Lines Down     Normal, Visual: [`ctrl-u`]


    SELECT


    PASTE

    - Paste from visual buffer      Normal, visual [`p`]
    - Paste from sys clipboard      Normal, Visual [`"*p`]


    HISTORY

    - Undo      Normal [`u`]
    - Redo      Normal [`ctrl-r`]



    PLUGINS

        NERDTREE

.. from markdown:

    # Vim Guide

    1. Install vundle:

        TODO

    2. Copy vimrc into ~/.vimrc

    3. Install plugins

    - open terminal `:term`, to open it in bottom: `:below terminal`
    - to set terminal height: `crtl-w 10 _` will set height to 10,
    - to nagivate in terminal use `ctrl-w N` then use regular
    vim motion control, use `a` and `i` to return to normal 
    operation
    - for more info see [here](https://vi.stackexchange.com/questions/514/how-do-i-change-the-current-splits-width-and-height)
    - Maybe map bottom termnial to shortcut to turn it on/off?

    Copying to clipboard:

    - select text in visual mode, copy with `"*yy"`
    - paste from clipboard use `"*p"` in normal mode


    USAGE

    MODES: NORMAL | INSERT | COMMAND | VISUAL

    NORMAL mode -> key combinations execute actions

    COMMAND mode -> pressing `:` in normal mode and typing command in command line

    INSERT mode -> typing text into file

    VISUAL mode -> selection/highlighting mode

    All modes pivot through NORMAL mode, however there are multiple methods to enter VISUAL and INSERT modes from NORMAL mode.

    | COMMAND | 

    - shortcuts in insert or other mode?
    - entry
    - exit
    - nerdtree
    - git integration
    - how to use command line? -> use different tab or window. Do not use with VIM
    - how to use tabs
    - what plug in has good find?
    - plugin for completion
    - plug in for jump to definition/declaration (javascript, c++, python)
    - cmake syntax / reading


    - in git tracked files, highlight line changes
    - name of tabs?

    Commands: [Insert | command]
    - nertree go into folder?
    - open in new tab? [`:tabnew <file>`]
    - move to next tab? [gt] [:tabn, :tabnext]
    - move to prev tab? [gT] [:tabp, :tabprev]
    - move to first tab? [:ta
    - move to last tab?
    - comment in any mode?
    - move to end of word?
    - move to beginning of word?
    - move to end of line
    - move to start of line
    - move up/down page
    - delete word backwards `^w`
    - delete word forwads
    - delete without going into insert?
    - select block with n lines -> visual block select using `crtl v`
    - continuous select -
    - copy selection
    - paste selection
    - undo: [command] `u` -> [insert mode] `^u`
    - shift down half a page: `^d`
    - shift half a page up: `^u`
    - [Normal mode] Insert Line above: `O`, below `o`, can do `#O` or `#o` for # number of lines

    To copy, go into visual mode with 'v' and select lines,

    To copy to clipboard in Host, after VISUAL seleection, use `"*y` to yank.

    to copy selected lines into buffer use `y` and paste with `p`


    NERDtree:
    - shift from NERDTree to file? `^w,l` to move to left view, `^w,h` to move to right, crtl+w,w flip-flop
    - change root to selected folder: `C`
    - how to change root folder in nerdtree view?
    - how to open nerdtree in every tab?
    - Show hidden files: `SHIFT i`
    - to open file in vertical split use `s`
    - to open file in horizontal split use `i`