jtimberman / dotvim forked from fujin/dotvim

Dotvim

This is the contents of my .vim directory. It includes my vimrc, which you should symlink to ~/.vimrc in order to get the goodness.

It includes several plugins: Git-vim, Gist, NERDtree, FuzzyFinder, FuzzyFinderTextmate, lots of color schemes, updated ruby bindings, and more.

To use, copy this directory to ~/.vim and symlink ~/.vim/vimrc to ~/.vimrc.

Introduction

Fugitive provides:

• Super-duper git functionality.
• github.com/tpope/vim-fugitive

NerdTree provides:

• A TextMate style ‘project drawer’
• A built in filesystem explorer

FuzzyFinder(Textmate) provides:

• A TextMate style ‘cmd-t’ buffer switching interface
• An ‘open buffers’ tab-esque interface

Ack provides:

• Awesome code grepping

Taglist provides:

• Easy source code browsing
• Must have exuberant ctags installed
• Set to auto-populate behind the scenes

Surround provides:

• Setting or replacing text that surrounds lines

NERD_Commenter provides:

• Super smart comment control

Gist provides:

• Integrated gist support

Commands

Git

:GitAdd <file>

git-add <file> or current file if not specified.

:GitCommit <args>

git-commit.

:GitStatus

Show git-status of current file or repository.

:GitLog

Show git-log of current file or repository.

:GitCheckout <args>

git-checkout. Completes git commits.

:GitDiff <args>

git-diff. Completes git commits.

:GitPull <args>

git-pull.

:GitPullRebase

git-pull —rebase.

:GitPush <args>

git-push. Defaults to +git push origin <current-branch>+.

:GitCatFile <args>

git-cat-file.

:Git <args>

Does any git command.

:GitVimDiffMerge

Experimental. Call this command on unmerged file to enter vimdiff mode.

:GitVimDiffMergeDone

Call this command after merging.

Ack

:Ack

Takes options, a pattern, and a directory. Shows results in a quickbuffer.

:AckAdd

Like Ack + grepadd - adds to, rather than replaces, the quickbuffer.

:LAck

Ack + lgrep - opens in location-list

:LAckAdd

Appends to the location list

Tags

:TlistOpen

Opens the tag list window

:TlistToggle

Toggle the tag list window

Surround

Details follow on the exact semantics, but first, consider the following examples. An asterisk (*) is used to denote the cursor position.

  Old text                  Command     New text ~
  "Hello *world!"           ds"         Hello world!
  [123+4*56]/2              cs])        (123+456)/2
  "Look ma, I'm *HTML!"     cs"<q>      <q>Look ma, I'm HTML!</q>
  if *x>3 {                 ysW(        if ( x>3 ) {
  my $str = *whee!;         vlllls'     my $str = 'whee!';

ds

= Delete surrounding - use the character or a ‘t’ for tag (ds", dst)

cs

= Change surrounding - first what to change, then what to change to

ys

= Takes a motion and surrounds it with the second argument, like cs

s

= In visual mode, wraps the text with the character argument

NERD_commenter

,cc

= Comment the current line, or selected text in visual mode

,c

= Toggle the comment

,ci

= Toggles the set of lines individually (like "c ", but assumes each line may have different settings)

,cs

= Comment Sexily - up close to the start of each line

,cA

= Append a comment to the end of the line

,cl

= Comment and align on the left side

,cb

= Comment and align on both sides

,cu

= Uncomment the selected lines

Gist

:Gist

= post the whole text to gist

:’<,’>Gist

= post the selected text to gist

:Gist -p

= post wholet ext to gist with private

:Gist -a

= post the whole text to gist with anonymous

:Gist -e

= Edit the gist

:Gist -e foo.js

= Edit the gist with the name ‘foo.js’

:Gist XXXXX

= Get gist

:Gist -c XXXXX

= Get gist and put to clipboard

:Gist -l

= List my gists

:Gist -la

= List gists from all

Textile

,rp

= :TextilePreview - render textile to a temp file, open in browser

,rt

= :TextileRenderTab - render textile to a new tab

,rf

= :TextileREdnerFile - render to a file

Keymaps

,d

= Toggle NERDtree

,t

= FuzzyFinderTextmate

,b

= FuzzyBufferFinder

,l

= TListToggle

,gd

:GitDiff

,gD

:GitDiff —cached

,gs

:GitStatus

,gl

:GitLog

,ga

:GitAdd

,gA

:GitAdd <cfile>

,gc

:GitCommit

,ws

Remove trailing whitespace

In git-status buffer

<Enter>

:GitAdd <cfile>

Rake

You can use the rake ‘install’ task to install this in your home directory.

Windows

This will also work on Windows. A few notes.

Windows default vimrc location is C:\Users\username_vimrc. User home directory doesn’t have plugins, syntax, etc, use C:\Program Files\Vim\vim72. PowerShell works for sure. cmd.exe might not. May need to start PowerShell/CMD as Administrator to get it to install.

Credits

People who have worked on this Vim configuration are:

Joshua Timberman github.com/jtimberman/dotvim Email: joshua@opscode.com

AJ Christensen github.com/fujin/dotvim Email: aj@opscode.com

Adam Jacob github.com/adamhjk/adam-vim/ Email: adam@opscode.com

Original: Bram Moolenaar <Bram@vim.org> Last change: 2002 Sep 19