|
|
|
@ -1,49 +1,57 @@ |
|
|
|
## About |
|
|
|
|
|
|
|
[Vundle] is a short cut for **V**imb**undle** and is a [Vim] plugin manager. |
|
|
|
[Vundle] is short for **V**imb**undle** and is a [Vim] plugin manager. |
|
|
|
|
|
|
|
## Quick start |
|
|
|
|
|
|
|
1. Setup [Vundle]: |
|
|
|
|
|
|
|
git clone http://github.com/gmarik/vundle.git ~/.vim/bundle/vundle |
|
|
|
|
|
|
|
``` |
|
|
|
$ git clone http://github.com/gmarik/vundle.git ~/.vim/bundle/vundle |
|
|
|
``` |
|
|
|
|
|
|
|
2. Configure bundles: |
|
|
|
|
|
|
|
Sample `.vimrc`: |
|
|
|
Sample `.vimrc`: |
|
|
|
|
|
|
|
```vim |
|
|
|
set nocompatible " be iMproved |
|
|
|
filetype off " required! |
|
|
|
|
|
|
|
set nocompatible " be iMproved |
|
|
|
filetype off " required! |
|
|
|
set rtp+=~/.vim/bundle/vundle/ |
|
|
|
call vundle#rc() |
|
|
|
|
|
|
|
set rtp+=~/.vim/bundle/vundle/ |
|
|
|
call vundle#rc() |
|
|
|
" let Vundle manage Vundle |
|
|
|
Bundle 'gmarik/vundle' |
|
|
|
|
|
|
|
" let Vundle manage Vundle |
|
|
|
Bundle 'gmarik/vundle' |
|
|
|
" My Bundles here: |
|
|
|
" |
|
|
|
" original repos on github |
|
|
|
Bundle 'tpope/vim-fugitive' |
|
|
|
Bundle 'lokaltog/vim-easymotion' |
|
|
|
Bundle 'rstacruz/sparkup', {'rtp': 'vim/'} |
|
|
|
" vim-scripts repos |
|
|
|
Bundle 'L9' |
|
|
|
Bundle 'FuzzyFinder' |
|
|
|
Bundle 'rails.vim' |
|
|
|
" non github repos |
|
|
|
Bundle 'git://git.wincent.com/command-t.git' |
|
|
|
" ... |
|
|
|
|
|
|
|
" My Bundles here: |
|
|
|
" |
|
|
|
" original repos on github |
|
|
|
Bundle 'tpope/vim-fugitive' |
|
|
|
Bundle 'lokaltog/vim-easymotion' |
|
|
|
Bundle 'rstacruz/sparkup', {'rtp': 'vim/'} |
|
|
|
" vim-scripts repos |
|
|
|
Bundle 'L9' |
|
|
|
Bundle 'FuzzyFinder' |
|
|
|
Bundle 'rails.vim' |
|
|
|
" non github repos |
|
|
|
Bundle 'git://git.wincent.com/command-t.git' |
|
|
|
" ... |
|
|
|
filetype plugin indent on " required! |
|
|
|
" or |
|
|
|
" filetype plugin on " to not use the indentation settings set by plugins |
|
|
|
``` |
|
|
|
|
|
|
|
filetype plugin indent on " required! |
|
|
|
|
|
|
|
3. Install configured bundles: |
|
|
|
|
|
|
|
Launch `vim`, run `:BundleInstall`. |
|
|
|
Launch `vim`, run `:BundleInstall`. |
|
|
|
|
|
|
|
*Windows users* see [Vundle for Windows](https://github.com/gmarik/vundle/wiki/Vundle-for-Windows) |
|
|
|
*Windows users* see [Vundle for Windows](https://github.com/gmarik/vundle/wiki/Vundle-for-Windows) |
|
|
|
|
|
|
|
Installing requires [Git] and triggers [Git clone](http://gitref.org/creating/#clone) for each configured repo to `~/.vim/bundle/`. |
|
|
|
Installing requires [Git] and triggers [Git clone](http://gitref.org/creating/#clone) for each configured repo to `~/.vim/bundle/`. |
|
|
|
|
|
|
|
## Why Vundle |
|
|
|
|
|
|
|
@ -69,17 +77,26 @@ see [`:h vundle`](vundle/blob/master/doc/vundle.txt#L1) vimdoc for more details. |
|
|
|
|
|
|
|
See [gmarik's vimrc](https://github.com/gmarik/vimfiles/blob/1f4f26d42f54443f1158e0009746a56b9a28b053/vimrc#L136) for working example. |
|
|
|
|
|
|
|
If you have an interesting example, feel free to send a pull request with link to your config. Thx! |
|
|
|
|
|
|
|
## FAQ |
|
|
|
|
|
|
|
- **Q** Why am I asked for username/pass? |
|
|
|
|
|
|
|
**A** This is the case of invalid name used with `Bundle`, which leads to attempt to clone nonexisting repo: |
|
|
|
**A** This is the case of invalid name used with `Bundle`, which leads to attempt to clone nonexistent repo: |
|
|
|
|
|
|
|
``` |
|
|
|
git clone http://github.com/gmarik/non_existin_repo |
|
|
|
Cloning into non_existin_repo... |
|
|
|
Username: |
|
|
|
Password: |
|
|
|
fatal: Authentication failed |
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
- **Q** My configuration is bundle dependant, so when I try to install plugins for the first time I get errors. How do I fix that? |
|
|
|
|
|
|
|
git clone http://github.com/gmarik/non_existin_repo |
|
|
|
Cloning into non_existin_repo... |
|
|
|
Username: |
|
|
|
Password: |
|
|
|
fatal: Authentication failed |
|
|
|
**A** [Fix your Chicken or Egg dilemma](http://gmarik.info/blog/2011/05/17/chicken-or-egg-dilemma) |
|
|
|
|
|
|
|
## Contributors |
|
|
|
|
|
|
|
@ -114,8 +131,8 @@ see [`:h vundle`](vundle/blob/master/doc/vundle.txt#L1) vimdoc for more details. |
|
|
|
* improve error handling |
|
|
|
* handle dependencies |
|
|
|
* allow specify revision/version? |
|
|
|
* search by description aswell |
|
|
|
* show descrption in search results |
|
|
|
* search by description as well |
|
|
|
* show description in search results |
|
|
|
* instead sourcing .vimrc before installation come up with another solution |
|
|
|
* make it rock! |
|
|
|
|
|
|
|
@ -126,8 +143,8 @@ see [`:h vundle`](vundle/blob/master/doc/vundle.txt#L1) vimdoc for more details. |
|
|
|
[Git]:http://git-scm.com |
|
|
|
[all available vim scripts]:http://vim-scripts.org/vim/scripts.html |
|
|
|
|
|
|
|
[install]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L98-112 |
|
|
|
[update]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L114-119 |
|
|
|
[search]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L121-143 |
|
|
|
[clean]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L145-157 |
|
|
|
[interactive mode]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L160-193 |
|
|
|
[install]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L110-124 |
|
|
|
[update]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L126-131 |
|
|
|
[search]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L133-155 |
|
|
|
[clean]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L157-169 |
|
|
|
[interactive mode]:https://github.com/gmarik/vundle/blob/master/doc/vundle.txt#L172-205 |