vim configuration

Thanks to:

• Mislav Marohnić,
• Drew Neil,
• Tim Pope,

My configuration uses Pathogen and git submodules.

Installation:

Prerequisites: ruby, git.

1. Move your existing configuration somewhere else:
   mv ~/.vim* ~/.gvim* my_backup
2. Clone this repo into ".vim":
   git clone git@github.com:vladan-m/vimfiles.git ~/.vim
3. Go into ".vim" and run "rake":
   cd ~/.vim && rake

This will install "/.vimrc" and "/.gvimrc" symlinks that point to files inside the ".vim" directory.

Features:

vimrc

• 2 spaces, no tabs

• incremental, case-insensitive search

• vertical split goes right, horizontal split goes below

• cursor keys for movement are disabled!

• <leader> is re-mapped from \ into ,

• ,h - remove highlighting after search

• <Space> - toggle current fold

• <C-j/k/h/l> - switch between splits (no need to prepend <C-w>)

• Q - format lines

• :KillWhitespace - strip trailing whitespace

File switching (Command-T)

• ,, alternates between two most recent buffers
• ,f - jump to file:
  • ,F - search in directory of current buffer
  • ,b - search buffer list
  • ,gl - search in lib/
  • ,gt - search tags
  • <C-s>,<C-CR> - open the selected file in a new split window
  • <C-v> - open the selected file in a new vertical split window
  • <C-t> - open the selected file in a new tab
  • <C-j> - select next file in the file listing
  • <C-k> - select previous file in the file listing
  • <C-f> - flush file cache

Ack

• ,a - open a new tab and search for something
• ,A - immediately search for the word under the cursor in a new tab

In the quickfix window:

• o - open file
• go - preview file, i.e. keep focus in quickfix window
• t (T) - open in a new tab (silently)
• h (H) - open in horizontal split (silently)
• v (gv) - open in vertical split (silently)

In the normal buffer:

• j/k - jump to the next/previous match
• :ccl - close the quickfix window
• <CR> - show results of previous/next search

Surround

• cs"' - change string from double to single quotes
• ds( - delete surrounding parentheses
• ysiW] - surround current WORD with square brackets
• ysst - surround current line in a HTML tag
• ysip<c-t> - nest current paragraph in a HTML tag

Visual mode: S. Insert mode: <c-s>.

Surround + rails.vim:

• - → <% -%>
• = → <%= %>
• # → <%# %>
• e - nest block and append end keyword
• E - like e, but prompt for text to prepend before block

Commentary

• gc{motion} - comment/uncomment lines that {motion} moves over
• gcc - comment/uncomment [count] lines
• {Visual}gc - comment/uncomment the highlighted lines
• gcu - uncomment the current and adjacent commented lines

ruby.vim

Motions:

• ]m / [m - next / previous method
• ]M / [M - end of method definition
• ]] / [[ - next / previous class/module
• ][ / [] - end of class/module

Text objects:

• am - a method
• im - inner method
• aM - a class
• iM - inner class

matchit.vim

% alternates between matching HTML tags, class/control flow statements and matching end in Ruby, and more. Also works in visual mode.

Fugitive

• :Gcommit

• :Gstatus

  • jump between lines that represent files with <c-n>, <c-p>
  • - - add/reset file (also in visual mode)
  • <Enter> - open current file in the window below
  • o/S - :Gsplit/:Gvsplit
  • p - add/reset current file with --patch
  • D - :Gdiff
  • c[v]c - :Gcommit [--verbose]
  • ca/cA - --append / reuse message

• :[range]Gbrowse! - - copy GitHub URL for code that's currently selected

• :[range]Gblame

  • q/gq - close blame and return to blamed window / work tree version
  • <CR> - q, then open commit
  • o/O - open commit in horizontal split / new tab
  • - - reblame at commit
  • P - reblame at parent commit

• :Gedit feature:% - version of the current file in the "feature" branch

• :Gwrite - add %

• :Gread - checkout % (also the bailout command after browsing git objects)

• :Gremove - rm %

• :Gmove <dest> - mv % <dest>

• :Glog - load past versions of current file into the quickfix list

• :Glog -- - load all commits into the quickfix list

• :Glog -- % - load only commits that touch the current file

• :Glog --grep={text} -- - only commits that have "text" in the message

• :Glog -S{text} -- - only commits that have "text" in the diff

• :Ggrep {pattern} [branch]

In git objects:

• <Enter> - jump to revision under cursor
• o/S/O - jump to revision in a new split / vertical split / tab

In vimdiff view:

• [c/]c - previous/next changeset
• :dp/:do - :diffput/:diffget - stage/checkout hunk
• :Gwrite/:Gread - stage/checkout file
• :do //2/:do //3 - resolve conflict using the version from target/merge branch
• :diffu[pdate] - refresh diff highlighting
• :on[ly],<C-w>o - close windows other than the current one