2010-10-17 19:18:08 -04:00
|
|
|
## About
|
|
|
|
|
|
2011-02-10 23:23:51 -05:00
|
|
|
[Vundle] is a short cut for **V**imb**undle** and is a [Vim] plugin manager.
|
2010-10-17 20:00:48 -04:00
|
|
|
|
2011-02-18 22:35:58 -05:00
|
|
|
## Quick start
|
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
|
|
|
|
2011-03-11 10:50:50 -05:00
|
|
|
Put into your `~/.vimrc`:
|
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-12-09 00:12:58 -05:00
|
|
|
" Bundles:
|
2010-11-02 23:11:20 -04:00
|
|
|
Bundle "L9"
|
|
|
|
|
Bundle "FuzzyFinder"
|
|
|
|
|
Bundle "rails.vim"
|
|
|
|
|
Bundle "ack.vim"
|
|
|
|
|
Bundle "git://git.wincent.com/command-t.git"
|
2010-12-09 00:12:58 -05:00
|
|
|
" ...
|
2010-10-17 19:18:08 -04:00
|
|
|
|
2011-03-19 19:22:56 -04:00
|
|
|
" NOTE: if some plugins fail to work, put the config *between* lines:
|
|
|
|
|
" filetype off
|
|
|
|
|
" "Bundles here
|
2011-03-11 10:50:50 -05:00
|
|
|
" filetype plugin indent on
|
|
|
|
|
|
2010-11-02 23:11:20 -04:00
|
|
|
3. Install configured bundles:
|
2010-10-17 19:18:08 -04:00
|
|
|
|
2011-02-10 23:23:51 -05:00
|
|
|
Launch `vim`, run `:BundleInstall` (**no `Vim` restart required** since v0.5)
|
2010-10-17 20:00:48 -04:00
|
|
|
|
2011-02-10 23:23:51 -05:00
|
|
|
Installing requires [Git] and triggers [Git clone](http://gitref.org/creating/#clone) for each configured repo to `~/.vim/bundle/`.
|
2010-11-02 23:11:20 -04:00
|
|
|
|
2011-02-18 22:35:58 -05:00
|
|
|
## Why Vundle
|
2010-12-09 00:12:58 -05:00
|
|
|
|
2011-02-18 22:35:58 -05:00
|
|
|
[Vundle] allows to:
|
2010-11-23 17:31:59 -05:00
|
|
|
|
2011-02-18 22:35:58 -05:00
|
|
|
- keep track and configure your scripts right in `.vimrc`
|
2011-03-19 20:24:26 -04:00
|
|
|
- [install] configured scripts (aka bundle)
|
|
|
|
|
- [update] configured scripts
|
|
|
|
|
- [search] [all available vim scripts] by name
|
|
|
|
|
- [clean] unused scripts up
|
2011-03-19 21:46:35 -04:00
|
|
|
- run above actions in a *single keypress* with [interactive mode]
|
2010-11-03 00:51:55 -04:00
|
|
|
|
2011-03-19 21:12:26 -04:00
|
|
|
Also [Vundle]:
|
2010-11-26 13:37:16 -05:00
|
|
|
|
2011-02-18 22:35:58 -05:00
|
|
|
- manages runtime path of your installed scripts
|
|
|
|
|
- regenerates helptag atomatically
|
2010-11-23 17:31:59 -05:00
|
|
|
|
2011-02-18 22:35:58 -05:00
|
|
|
## Docs
|
2011-01-20 15:59:49 -05:00
|
|
|
|
2011-03-19 21:04:39 -04:00
|
|
|
see [`:h vundle`](vundle/blob/master/doc/vundle.txt#L1) vimdoc for more details.
|
2011-01-20 15:59:49 -05:00
|
|
|
|
2010-11-29 17:45:48 -05:00
|
|
|
## Examples
|
2010-11-23 17:31:59 -05:00
|
|
|
|
|
|
|
|
See [gmarik's vimrc](https://github.com/gmarik/vimfiles/blob/1f4f26d42f54443f1158e0009746a56b9a28b053/vimrc#L136) for working example.
|
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
|
|
|
|
2011-02-10 22:49:50 -05:00
|
|
|
## Also
|
|
|
|
|
|
2011-02-11 00:21:09 -05:00
|
|
|
* Vundle was developed and tested in [Vim] 7.3 on `OSX` and `Linux`
|
2011-02-10 23:23:51 -05:00
|
|
|
* Vundle wasn't tested on windows(so if you care i'm waiting for your pull request)
|
2011-02-10 22:49:50 -05:00
|
|
|
* Vundle tries to be as [KISS](http://en.wikipedia.org/wiki/KISS_principle) as possible
|
|
|
|
|
|
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-12-09 00:12:58 -05:00
|
|
|
* √ activate newly added bundles on .vimrc reload or after :BundleInstall
|
|
|
|
|
* √ use preview window for search results
|
2011-02-18 22:35:58 -05:00
|
|
|
* √ vim documentation
|
2010-11-26 13:37:16 -05:00
|
|
|
* improve error handling
|
2010-11-02 23:11:20 -04:00
|
|
|
* allow specify revision/version?
|
|
|
|
|
* search by description aswell
|
|
|
|
|
* show descrption in search results
|
2010-12-09 00:12:58 -05:00
|
|
|
* instead sourcing .vimrc before installation come up with another solution
|
2010-11-23 17:31:59 -05:00
|
|
|
* tests
|
2010-11-02 23:11:20 -04:00
|
|
|
* 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-27 17:03:37 -05:00
|
|
|
[all available vim scripts]:http://vim-scripts.org/vim/scripts.html
|
2011-03-19 20:24:26 -04:00
|
|
|
|
2011-03-19 21:58:06 -04:00
|
|
|
[install]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L96-110
|
|
|
|
|
[update]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L112-117
|
|
|
|
|
[search]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L119-137
|
|
|
|
|
[clean]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L139-150
|
|
|
|
|
[interactive mode]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L152-175
|
