vim-bundler¶ ↑
This gem provides a simple way to manage your vim bundles (aka plugins). If you are familiar with ruby gem bundler - you are familar with vim-bundler.
Requirements¶ ↑
git
Quick start¶ ↑
Switch to your vimfiles directory (e.g +~/.vim+) Initialize vim_bundles
config file
vbundle init
Put some lines in your vim_bundles
config file. For example:
bundle 'snipmate', :git => 'git://github.com/msanders/snipmate.vim.git' bundle 'nerdtree', :git => 'git://github.com/scrooloose/nerdtree.git'
Perform install action
vbundle install
All you bundles will appear in bundle
dir.
After that you can clean your vimfiles directory from stale plugins
Using different bundle sources¶ ↑
You can use use git sources as shown above and also it is possible to load scripts from www.vim.org It can be done as following:
bundle 'indexed-search', :vim_script_id => 7062
value of vim_script_id
can be found in download link. You also need to point location if the script originally requires another location than plugin
Also you can link local folders as bundles
bundle 'snipmate', :local => '~/projects/snipmate'
Updating bundles¶ ↑
It is quite easy
vbundle update
Also you can update a specific plugin
vbundle update snipmate
Cleaning bundles¶ ↑
It is also easy enough
vbundle clean
So you can clean a specific plugin
vbundle clean snipmate
As you can see, every command might be proceeded for specific plugin (except init
)
Listing bundles¶ ↑
vbundle list
Managing bundles using git modules¶ ↑
It might be useful to attach plugins as git modules (for example if you keep your vimfiles at github.com), to do so put this line in your vim_bundles
use_git_submodules true
Configuration options¶ ↑
There are some options that you can define in vim_bundles
file
use_git_submodules (default: false) git_bin (default: 'git') vimrc_file (default: 'vimrc') vim_bin_path (default: '/usr/bin/vim') bundles_dir (default: 'bundle')
Example¶ ↑
My vim_bundles
located here github.com/vintikzzz/my-vim-files/blob/master/vim_bundles
Contributing to vim-bundler¶ ↑
-
Check out the latest master to make sure the feature hasn’t been implemented or the bug hasn’t been fixed yet
-
Check out the issue tracker to make sure someone already hasn’t requested it and/or contributed it
-
Fork the project
-
Start a feature/bugfix branch
-
Commit and push until you are happy with your contribution
-
Make sure to add tests for it. This is important so I don’t break it in a future version unintentionally.
-
Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
Copyright¶ ↑
Copyright © 2011 Pavel Tatarsky. See LICENSE.txt for further details.