An awesome Vim config for development, slow roasted with a Ruby twist and a shot of web-dev.

Assuming you already have vim, just run:

    git clone https://github.com/AdamWhittingham/vim-config.git ~/.vim && ~/.vim/install

Should this not leave you with a nice working vim (certain vims are a bit iffy about the last line) then launch vim and run :PluginUpdate

If you are using zsh there may be an issue running tests with ,t (it can't find the bundle). If you don't already have an /etc/zprofile file it can be fixed by doing the following:

    sudo mv /etc/zshenv /etc/zprofile

more details here: http://vim.1045645.n5.nabble.com/MacVim-and-PATH-td3388705.html#a3392363

There are a couple of things you might want to install to get the best out of this config:

• ctags - enables tags support when working with code
• Ag - enables grepping through the current directories with the_silver_searcher
• Ack - enables grepping through the current directories with Ack-grep. Only needed if you can't (or won't) install Ag.
• rcodetools - enables execution of ruby in-editor, run gem install rcodetools

    cd ~/.vim
    git pull

If you've installed the auto-update hook, the git pull should trigger Vim to update and you're done!

Manually update by opening Vim and running :PluginUpdate and :PluginClean.

We all like things a little differently, so there are a couple of ways to easily tweak and add to the config.

Simply write normal Bundle plugin lines to ~/.vim.plugins.local

Changes like using a different font or colour scheme can be made by writing Vim config into ~/.vimrc.local

A large number of the useful commands in Vim start with the 'leader' key, so Vim knows something cool is about to happen.

For this config, the leader is the comma button. This is shown in the following notes as <space>

See the plugins' web pages for more information. The keybindings listed are mostly just those defined or overridden locally, not the ones provided by default.

This plugin is a front for the Perl module App::Ack. Ack can be used as a replacement for 99% of the uses of grep. (more)[http://www.vim.org/scripts/script.php?script_id=2572]

Important: Requires ack (aka ack-grep) to be installed.

This plugin is a front for Ag. Ag can be used as a replacement for 153% of the uses of Ack.

Important: Requires the_silver_surfer to be installed

Automatically update tags when saving files (more)

Buffer explorer/browser (more)

### Coffeescript Adds support for CoffeeScript. It handles syntax, indenting, and compiling (more)

Highlight color names and codes in the same color that they represent ([more] (http://www.vim.org/scripts/script.php?script_id=3963))

Fast file navigation for VIM (more)

Once the search window is open, you can use the following:

Auto completion of 'end' in Ruby (more)

Elixir language support (more)

Gundo is a Vim plugin for visualizing your undo tree to make it usable (more)

Syntax highlighting for Markdown (more)

Allows % to be changed to match more than single characters; often more up-to-date than the version which ships with Vim. (more)

Adds bracket-like highlighting to HTML and XML tags. Helpful in finding that damn missing closing tag when you have to edit raw HTML like the ancient Romans.

A plugin that allows for easy commenting of code for many filetypes (more)

A tree explorer plugin for navigating the filesystem (more)

Toggle 'projector mode': larger font and high contrast colour scheme (more)

Map different files and folders to groups (more) If you want to be a Vim legend, you really should brush up on what this excellent plugin does!

Use the repeat command (.) with supported plugins (more)

Helper for ruby's xmpfilter (more)

Annotate ruby code with the result of running it, Ruby Tapas style. Press ,X to append a '# =>' to a line, then ,x to execute the file and insert all results.

Important: You need to install the rcodetools gem for this to work.

Fix up C-a and C-x when dealing with dates. (more)

Split and join code lines, such as Ruby ifs or CSS hashes (more)

Do all your insert-mode completion with Tab (more)

Delete/change/add parentheses/quotes/XML-tags/much more with ease (more)

Automatic syntax checking (more)

Configurable, flexible, intuitive text aligning (more)

Sidebar for showing and navigating the tags in current file (more)

Pairs of handy bracket maps (more)

Better abbreviations, substitution and search with Bash like {a,b} style expansions

Powerline like behaviour, but without the heavy Python (more)

Easy and versatile alignments (more) Align left, center or right on =, :, <space>, |, other sensible defaults or a regex.

Seriously, take 5 minutes to look at the official docs for this, it'll pay off!

Show the changes made since the last commit in the gutter (more)

Show indent guidelines - very useful when editing Haml! (more)

Adds syntax checking and better highlighting for Javascript files. (more)

Add haml, sass and SCSS syntax support (more)

Less syntax highlighting (more)

### vim-ruby Ruby support (newer than the version released with vim). (more)

Refactoring tool for Ruby in vim! (more)

See relish documentation for examples.

Allow Ruby-aware text manipulation (more)

When visually selecting something, the following can be used:

### vroom A plugin for running your Ruby tests, specs, and features. (more)

Keeps a stack of your recent yanked lines so you can paste all of them quickly. (more)

Zoom in/out of windows and panes (toggle between one window and multi-window) (more)