dotvim: A Vim Script repository from nickmerwin

Nick Merwin's flavor of dotvim love

This is a complete Vim configuration that I'm using everywhere

Plugins that are available form a git repository were added with Braid for easy upgrading.

Some help tips are provided for some of the plugins. please check out the plugin's docs for more info.

Installation

From your homedirectory (on Linux/Mac OSX):

git clone git://github.com/astrails/dotvim.git
ln -sfn dotvim .vim
ln -sfn dotvim/vimrc .vimrc

Note: if you alrady have ~/.vim ~/.vimrc REMOVE THEM (you might want to backup them ifirst :)

General configuration

, is used as mapleader

,e mapped to :e **/. essentially you do ,efoo<tab> to get a list of all files starting with foo
,s - toggle invisible characters display
Ctrl-E - switch between 2 last buffers (its just a :b#<cr> :)
Ctrl-N to cancel current search highlighing
jj mapped to Escape

Check out the 'vimrc' file for more...

"Interesting" Plugins:

nerdtree (github)

hax0r vim script to give you a tree explorer
- Ctrl-P - open directory browser
- ,p - to find and highlight the currently open file in the tree
nerdcommenter (github)

Vim plugin for intensely orgasmic commenting
- ,/ - toggle comment
- ,cc - add commenting
- ,cu - Uncomment
- check docs for more
fuzzyfinder 3.5 (vim.org)

buffer/file/command/tag/etc explorer with fuzzy matching
- ,f - FufFile - fuzzy find file
autocomplpop 2.14.1 (vim.org)

Automatically opens popup menu for completions

Shouldn't require config.
taglist (vim.org)

Source code browser (supports C/C++, java, perl, python, tcl, sql, php, etc)
- ,t - toggle tags window
minibufexpl 6.3.2 (vim.org)

Elegant buffer explorer - takes very little screen space
- ,b to open buffer list window.
- Enter in the list window to open the buffer
yankring 100 (vim.org)

Maintains a history of previous yanks, changes and deletes
- ,y to show the yankring
- ,[/,] - to cycle the just-pasted text though the yankring.
- :h yankring.txt and :h yankring-tutorial for more
fugitive (github)

A Git wrapper so awesome, it should be illegal
- :Gstatus
  
  Bring up the output of git-status in the preview window. Press - to stage or unstage the file on the cursor line. Press p to do so on a per hunk basis (--patch). Press C to invoke |:Gcommit|.
- :Gcommit [args]
  
  A wrapper around git-commit.
- :Ggrep [args]
  
  |:grep| with git-grep as 'grepprg'.
- :Gblame
  
  Run git-blame on the file and open the results in a scroll bound vertical split. Press enter on a line to reblame the file as it was in that commit.
Much more in the plugin's doc
rails (vim.org) (github)

Ruby on Rails: easy file navigation, enhanced syntax highlighting, and more
- :AV - open "alternate" file in a new vertical split
- :AS - open "alternate" file in a new horizontal split
- :RV - open "related" file in a new vertical split
- :RS - open "related" file in a new horizontal split
- :Rextract - extract partial (select text for extraction first)
- :Rinvert - takes a self.up migration and writes a self.down.
- gf - remapped to take context into account. recognizes models associations, partials etc.
- :h rails for more info ;)
syntastic (github)

syntax checking plugin

it will display the number of syntax errors in the current file in the vim's status line.

use :Errors to display a window detailing the errors
snipmate (vim.org) (github)

TextMate-style snippets for Vim

write a snipped text and press TAB to expand it.

To see the list of available snippets type Ctrl-R <Tab> in the insert mode
space (github)

Smart Space key for Vim

press SPACE to repeat last motion command
surround (vim.org) (github)

Delete/change/add parentheses/quotes/XML-tags/much more with ease
- dsX - delete surround X
- csXY - change surround X with Y
- s/S in visual mode - wrap selection
- ysMovementX - surround movement with X
You should REALLY read the docs if you want to use this one
conque (vim.org)

Conque is a Vim plugin allowing users to execute and interact with programs, typically a shell such as bash, inside a buffer window.

This one is much better then vimsh that I was using before

,sh - start a vimsh window ,r - opens vim prompt for command to run
drillctg 1.1.3 (vim.org)

Allows fast drill-down search across the pathnames in your ctags file

:Drill to open drill window
vividchalk (vim.org) (github)

A colorscheme strangely reminiscent of Vibrant Ink for a certain OS X editor

"Support" and minor plugins

pathogen 1.2 (vim.org) (github)

Allows to separate each plugin into its own subdirectory. ~/.vim/bundles directory is used as the common root for all the plugins.

Already configured
misc-lang-settings

ts/sw/et settings for various filetypes
endwise (vim.org) (github)

Wisely add "end" in ruby, endfunction/endif/more in vim script, etc
delimitMate (vim.org) (github)

auto-completion for quotes, parens, brackets, etc. in insert mode.
kwdbi 1.1 (vim.org)

Keep Window on Buffer Delete - Improved
pastie (vim.org) (github)

integration with http://pastie.org
repeat (vim.org) (github)

Use the repeat command "." with supported plugins
showmarks 2.2 (vim.org)

Visually shows the location of marks.
unimpaired (github)

pairs of assorted bracket maps

Syntax plugins

tmux

tmux syntax suupport (extracted from tmux-1.1)
rcov

rcov support (extracted from rcov-0.8.1.2.0 ruby gem)
puppet (vim.org)

Syntax Highlighting for Puppet
json 0.4 (vim.org)

synntax highlighting file for JSON
cucumber (github)

syntax, indent, etc. for Cucumber
haml (vim.org) (github)

HAML syntax etc.
markdown (github)

syntax for Markdown

Misc

The following is a list of commands and key bindings that I personally find interesting stored for easy refreshing my memory of them. there is no much 'system' to it, just randomly chosen bits of vim goodness.

ga print ascii value of character under the cursor
g# like "#", but without using "<" and ">"
g< display previous command output
z<CR> redraw, cursor line to top of window
z- redraw, cursor line at bottom of window
CTRL-W x exchange current window with n-th window (or next if no count given)
gv reselect last selection