2010-10-17 19:18:08 -04:00
|
|
|
## About
|
|
|
|
|
|
2010-11-02 23:20:01 -04:00
|
|
|
[Vundle] is a short cut for **V**imb**undle** and is a small plugin for managing [Vim] plugins.
|
2010-10-17 20:00:48 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
## Why
|
|
|
|
|
[Vundle] can:
|
2010-11-02 23:20:01 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
- automatically install vim script (aka bundle)
|
|
|
|
|
- manage runtime path of your installed scripts so you don't have to
|
|
|
|
|
- disable/enable bundles by commenting/uncommenting configured Bundle(requires reload)
|
|
|
|
|
- NEW: search [all available vim scripts] by name
|
2010-10-17 19:18:08 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
[Vundle] takes advantage of [vim-scripts.org](http://vim-scripts.org)
|
|
|
|
|
in order to install/search [all available vim scripts]
|
2010-10-17 19:18:08 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
## How
|
2010-10-17 19:18:08 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
1. Setup [Vundle]:
|
2010-10-17 19:18:08 -04:00
|
|
|
|
2010-11-02 23:55:47 -04:00
|
|
|
git clone http://github.com/gmarik/vundle.git ~/.vim/vundle.git
|
2010-10-17 20:46:30 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
2. Configure bundles:
|
2010-10-19 00:15:44 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
Add to your <code>~/.vimrc</code>:
|
2010-10-19 00:26:53 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
set rtp+=~/.vim/vundle.git/
|
|
|
|
|
call vundle#rc()
|
2010-10-19 00:15:44 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
" My bundles
|
|
|
|
|
Bundle "L9"
|
|
|
|
|
Bundle "FuzzyFinder"
|
|
|
|
|
Bundle "rails.vim"
|
|
|
|
|
Bundle "ack.vim"
|
|
|
|
|
Bundle "git://git.wincent.com/command-t.git"
|
|
|
|
|
" check http://vim-scripts.org for more
|
2010-10-17 19:18:08 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
3. Install configured bundles:
|
2010-10-17 19:18:08 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
Launch <code>vim</code> and run <code>:BundleInstall</code>.
|
2010-10-17 20:00:48 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
Or from command line:
|
|
|
|
|
|
|
|
|
|
$ vim -e -c 'BundleInstall' -c 'q'
|
|
|
|
|
|
|
|
|
|
triggers [Git clone](http://gitref.org/creating/#clone) for each configured repo to <code>~/.vim/bundle/</code>.
|
|
|
|
|
|
|
|
|
|
See [gmarik's vimrc](https://github.com/gmarik/vimfiles/blob/1f4f26d42f54443f1158e0009746a56b9a28b053/vimrc#L136) for working example.
|
|
|
|
|
|
|
|
|
|
## Searching
|
|
|
|
|
|
2010-11-02 23:24:55 -04:00
|
|
|
:BundleSearch foo
|
2010-11-02 23:11:20 -04:00
|
|
|
|
|
|
|
|
Will split new window with results:
|
|
|
|
|
|
2010-11-02 23:24:55 -04:00
|
|
|
Bundle "VimFootnotes"
|
|
|
|
|
Bundle "foo.vim"
|
2010-11-02 23:11:20 -04:00
|
|
|
|
2010-11-03 00:51:55 -04:00
|
|
|
So you can just copy one you need to you <code>.vimrc</code>.
|
|
|
|
|
|
|
|
|
|
Searching requires [<code>curl</code>](http://curl.haxx.se/)
|
2010-10-17 20:00:48 -04:00
|
|
|
|
2010-10-30 22:02:36 -04:00
|
|
|
## Inspiration and ideas from
|
2010-10-17 20:00:48 -04:00
|
|
|
|
2010-10-30 22:02:36 -04:00
|
|
|
* [pathogen]
|
|
|
|
|
* [bundler]
|
|
|
|
|
* [Scott Bronson](http://github.com/bronson)
|
2010-10-17 19:18:08 -04:00
|
|
|
|
|
|
|
|
## TODO:
|
2010-11-02 23:11:20 -04:00
|
|
|
[Vundle] is a work in progress so any ideas/patches appreciated
|
2010-10-17 19:18:08 -04:00
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
* tests
|
|
|
|
|
* allow specify revision/version?
|
|
|
|
|
* activate newly added bundles on .vimrc reload
|
|
|
|
|
* search by description aswell
|
|
|
|
|
* show descrption in search results
|
|
|
|
|
* use location list/quick fix list for search results
|
|
|
|
|
* make it rock!
|
2010-10-17 20:18:58 -04:00
|
|
|
|
|
|
|
|
[Vundle]:http://github.com/gmarik/vundle
|
|
|
|
|
[Pathogen]:http://github.com/tpope/vim-pathogen/
|
|
|
|
|
[Bundler]:http://github.com/wycats/bundler/
|
|
|
|
|
[Vim]:http://vim.org
|
|
|
|
|
[Git]:http://git-scm.com
|
2010-11-02 23:11:20 -04:00
|
|
|
[all available vim scripts]:http://vim-scripts.org/scripts.html
|
