This repo is our baseline ~/.vim/ directory. It uses git submodules and the (Vim 8+) native "pack" system to manage plugins. Many of the configurations used in here are inspired by Janus.

Installation

$ git clone --recursive https://github.com/werebus/vimfiles.git ~/.vim

Features

Oh so many plugins, here's a quick, and not quite complete, list.

Note: below, when we refer to "<Leader>", we're referring to the vim special key. By default, that's a comma, but you can remap it to some other key in plugin/00-leader.vim

• Vim-ack

  Used to search through a project directory. You can you can use :Ack, or, for your convenience, it's mapped to <Leader>f. This plugin requires the ack program. Install it with homebrew, apt-get, or whatever.

• Buffergator

  Mapped to <Leader>b, this plugin gives you a list on the left of all of your currently open buffers

• ctrl-P

  Fuzzy find in project, buffers, or most-used files. Press <c-p> to get started.

• Fugitive

  Awesome git integration.

• [Flog][flog]

  Git log browser, mapped to <Leader>g.

• Gundo

  Mapped to <Leader>u, this plugin will show you a nifty graphical representation of your undo tree.

• Indent-object

• NERDcommenter

  Tons of comment commands mapped to <Leader>c<something> (also in the plugin -> comment menu)

• NERDTree

  Mapped to <Leader>n, and also set to auto-appear when you call vim or mvim on a directory, this is a nice project tree type display

• Sessionman

  Allows the saving and restoring of sessions. It adds the options to the "File" menu, but there are also normal-mode commands.

• Supertab tab-completion (:h supertab)

• Surround

  This plugin contains all sorts of commands for wrapping chunks of text in parentheses, etc.

• Syntastic syntax checker

• Tabular

  This plugin is for making your text line up. Maybe type :Tab and see what happens.

• Ultisnips and a collection of snippets

• Zoomwin

  Mapped to <Leader><Leader>, zooms into the current window, making it full-screen.

Customization

"Local" Files

You can use a ~/.vimrc.local or ~/.gvimrc.local file to add customizations that are specific to a particular machine.

Credits

The majority of the credit here goes to Janus. The initial inspiration was the old Rakefile-style Janus, but the git submodule technique is borrowed from the new Janus.

Scrooloose's vimfiles repo also provided some hints on useful plugins.

Steve Francia's Vim distribution also provided some nice tips for the /.vimrc file.