5a7ff95560
- closes https://github.com/gmarik/vundle/issues/#issue/2 - thanks http://github.com/dag for reporting |
||
---|---|---|
autoload | ||
ftplugin | ||
README.md | ||
test |
About
Vundle is a short cut for Vimbundle and is a small plugin for managing Vim plugins.
Why
Vundle allows to:
- keep track and configure your scripts right in
.vimrc
- install configured scripts (aka bundle)
- manage runtime path of your installed scripts so you don't have to
- search all available vim scripts by name
Vundle takes advantage of vim-scripts.org in order to install/search all available vim scripts
How
-
Setup Vundle:
git clone http://github.com/gmarik/vundle.git ~/.vim/vundle.git
-
Configure bundles:
Append to your
~/.vimrc
:set rtp+=~/.vim/vundle.git/ call vundle#rc() " Bundles: Bundle "L9" Bundle "FuzzyFinder" Bundle "rails.vim" Bundle "ack.vim" Bundle "git://git.wincent.com/command-t.git" " ...
-
Install configured bundles:
Launch
vim
, run:BundleInstall
(noVim
restart required since v0.5)Installing requires Git and triggers Git clone for each configured repo to
~/.vim/bundle/
.
Script installation
BundleInstall
installs script only if it hasn't been already installed.
BundleInstall
is faster than BundleInstall!
(note bang at the end) because latter fetches scripts without any checks.
Use BundleInstall
to install new scripts. Use BundleInstall!
to update scripts.
Searching
:BundleSearch foo
will split new window with results:
Bundle "VimFootnotes"
Bundle "foo.vim"
so you can just copy ones you need to .vimrc
.
:BundleSearch! foo
will refresh scripts list before doing search.
Searching requires curl
Examples
See gmarik's vimrc for working example.
Inspiration and ideas from
TODO:
Vundle is a work in progress so any ideas/patches appreciated
- √ activate newly added bundles on .vimrc reload or after :BundleInstall
- √ use preview window for search results
- improve error handling
- allow specify revision/version?
- search by description aswell
- show descrption in search results
- instead sourcing .vimrc before installation come up with another solution
- documentation
- tests
- make it rock!