curl https://raw.github.com/hexorx/dotfiles/master/get.vimfiles.sh | sh
This clones the repo, downloads all the submodules, and links the vim-related dotfiles into the current user's home directory. Running this command should get you up and running with this vim config without any other work.
Make it your own
If you want to copy this Vim config as a base for your own, you should:
- Fork this repository.
- Change the mention of "coderifous" in the get.vimfiles.sh script to your own github name.
- Customize the vim config to suit you.
This Vim config supports two runtime profiles:
- Normal, with all plugins loaded.
- Minimal, with no plugins loaded. Super fast startup!
To run Vim without loading plugins use the --noplugins option. e.g.
I recommend setting your EDITOR environment variable to use this option:
export EDITOR="vim --noplugin"
This way you'll have a faster startup when other programs (e.g. git) bring up Vim.
This Vim config (loaded from .vimrc) is broken up across several files that are sourced. Each file performs a different kind of customization. For instance one file is responsible for customizing vim settings, while another file is responsible for defining custom key mappings. All plugin-related configuration is stored in it's own file that is loaded conditionally depending on whether the --noplugins flag was used.
vim-bundler for plugin management
This Vim config uses the
vim-bundler ruby gem to manage the
plugins. Each plugin is listed in the
vim_bundles manifest file and is
configured to use the git submodule installation strategy.
vim-bundler relies on pathogen for load path management.
Read more about it in vim-bundler's README.
Take a look at the vim_bundles file to see all of the included plugins.
Here's a few faves:
- NerdTree - The missing file drawer for Vim.
- lusty - super fast file navigation
- fugitive - killer git plugin for vim
- surround - quoting/parenthesizing made simple
- AutoClose - inserts matching bracket, paren, brace or quote
- ack - grep for code
- tComment - comment plugin
Since I write a lot of Ruby, and Ruby on Rails there's a few useful plugins for that as well.
- rails - Ruby on Rails power tools
- ruby - ruby omnicompletion and syntax highlighting
- textobj-rubyblock - custom text object for selecting ruby blocks.
- ruby-refactoring - Refactoring tool for ruby
- coffee-script coffee-script syntax, indenting and compiling
- haml - runtime files for Haml, Sass, and SCSS