161 lines
6.4 KiB
Markdown
161 lines
6.4 KiB
Markdown
|
## [Help Maintain Vundle](https://github.com/VundleVim/Vundle.vim/issues/383)
|
||
|
|
|
||
|
|
## 关于
|
||
|
|
|
||
|
|
[Vundle] 是 _Vim bundle_ 的简称,是一个 [Vim] 插件管理器.
|
||
|
|
|
||
|
|
[Vundle] 允许你做...
|
||
|
|
|
||
|
|
* 同时在`.vimrc`中跟踪和[管理](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L126-L233)插件
|
||
|
|
* [安装](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L234-L254)特定格式的插件(a.k.a. scripts/bundle)
|
||
|
|
* [更新](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L255-L265)特定格式插件
|
||
|
|
* 通过插件名称[搜索](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L266-L295)[Vim scripts](http://vim-scripts.org/vim/scripts.html)中的插件
|
||
|
|
* [清理](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L303-L318)未使用的插件
|
||
|
|
* 可以通过*单一按键*完成以上操作,详见[interactive mode](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L319-L360)
|
||
|
|
|
||
|
|
[Vundle] 自动完成...
|
||
|
|
|
||
|
|
* 管理已安装插件的[runtime path](http://vimdoc.sourceforge.net/htmldoc/options.html#%27runtimepath%27)
|
||
|
|
* 安装和更新后,重新生成[帮助标签](http://vimdoc.sourceforge.net/htmldoc/helphelp.html#:helptags)
|
||
|
|
|
||
|
|
[Vundle] 正在经历一个 [interface change], 请通过以下方式获取最新信息.
|
||
|
|
|
||
|
|
[](https://gitter.im/VundleVim/Vundle.vim) : 讨论和技术支持.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Quick Start
|
||
|
|
|
||
|
|
1. Introduction:
|
||
|
|
|
||
|
|
Installation requires [Git] and triggers [`git clone`] for each configured repository to `~/.vim/bundle/` by default.
|
||
|
|
Curl is required for search.
|
||
|
|
|
||
|
|
If you are using Windows, go directly to [Windows setup]. If you run into any issues, please consult the [FAQ].
|
||
|
|
See [Tips] for some advanced configurations.
|
||
|
|
|
||
|
|
Using non-POSIX shells, such as the popular Fish shell, requires additional setup. Please check the [FAQ].
|
||
|
|
|
||
|
|
2. Set up [Vundle]:
|
||
|
|
|
||
|
|
`$ git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim`
|
||
|
|
|
||
|
|
3. Configure Plugins:
|
||
|
|
|
||
|
|
Put this at the top of your `.vimrc` to use Vundle. Remove plugins you don't need, they are for illustration purposes.
|
||
|
|
|
||
|
|
```vim
|
||
|
|
set nocompatible " be iMproved, required
|
||
|
|
filetype off " required
|
||
|
|
|
||
|
|
" set the runtime path to include Vundle and initialize
|
||
|
|
set rtp+=~/.vim/bundle/Vundle.vim
|
||
|
|
call vundle#begin()
|
||
|
|
" alternatively, pass a path where Vundle should install plugins
|
||
|
|
"call vundle#begin('~/some/path/here')
|
||
|
|
|
||
|
|
" let Vundle manage Vundle, required
|
||
|
|
Plugin 'VundleVim/Vundle.vim'
|
||
|
|
|
||
|
|
" The following are examples of different formats supported.
|
||
|
|
" Keep Plugin commands between vundle#begin/end.
|
||
|
|
" plugin on GitHub repo
|
||
|
|
Plugin 'tpope/vim-fugitive'
|
||
|
|
" plugin from http://vim-scripts.org/vim/scripts.html
|
||
|
|
Plugin 'L9'
|
||
|
|
" Git plugin not hosted on GitHub
|
||
|
|
Plugin 'git://git.wincent.com/command-t.git'
|
||
|
|
" git repos on your local machine (i.e. when working on your own plugin)
|
||
|
|
Plugin 'file:///home/gmarik/path/to/plugin'
|
||
|
|
" The sparkup vim script is in a subdirectory of this repo called vim.
|
||
|
|
" Pass the path to set the runtimepath properly.
|
||
|
|
Plugin 'rstacruz/sparkup', {'rtp': 'vim/'}
|
||
|
|
" Avoid a name conflict with L9
|
||
|
|
Plugin 'user/L9', {'name': 'newL9'}
|
||
|
|
|
||
|
|
" All of your Plugins must be added before the following line
|
||
|
|
call vundle#end() " required
|
||
|
|
filetype plugin indent on " required
|
||
|
|
" To ignore plugin indent changes, instead use:
|
||
|
|
"filetype plugin on
|
||
|
|
"
|
||
|
|
" Brief help
|
||
|
|
" :PluginList - lists configured plugins
|
||
|
|
" :PluginInstall - installs plugins; append `!` to update or just :PluginUpdate
|
||
|
|
" :PluginSearch foo - searches for foo; append `!` to refresh local cache
|
||
|
|
" :PluginClean - confirms removal of unused plugins; append `!` to auto-approve removal
|
||
|
|
"
|
||
|
|
" see :h vundle for more details or wiki for FAQ
|
||
|
|
" Put your non-Plugin stuff after this line
|
||
|
|
```
|
||
|
|
|
||
|
|
4. Install Plugins:
|
||
|
|
|
||
|
|
Launch `vim` and run `:PluginInstall`
|
||
|
|
|
||
|
|
To install from command line: `vim +PluginInstall +qall`
|
||
|
|
|
||
|
|
## Docs
|
||
|
|
|
||
|
|
See the [`:h vundle`](https://github.com/VundleVim/Vundle.vim/blob/master/doc/vundle.txt) Vimdoc for more details.
|
||
|
|
|
||
|
|
## Changelog
|
||
|
|
|
||
|
|
See the [changelog](https://github.com/VundleVim/Vundle.vim/blob/master/changelog.md).
|
||
|
|
|
||
|
|
## People Using Vundle
|
||
|
|
|
||
|
|
see [Examples](https://github.com/VundleVim/Vundle.vim/wiki/Examples)
|
||
|
|
|
||
|
|
## Contributors
|
||
|
|
|
||
|
|
see [Vundle contributors](https://github.com/VundleVim/Vundle.vim/graphs/contributors)
|
||
|
|
|
||
|
|
*Thank you!*
|
||
|
|
|
||
|
|
## Inspiration & Ideas
|
||
|
|
|
||
|
|
* [pathogen.vim](http://github.com/tpope/vim-pathogen/)
|
||
|
|
* [Bundler](https://github.com/bundler/bundler)
|
||
|
|
* [Scott Bronson](http://github.com/bronson)
|
||
|
|
|
||
|
|
## Also
|
||
|
|
|
||
|
|
* Vundle was developed and tested with [Vim] 7.3 on OS X, Linux and Windows
|
||
|
|
* Vundle tries to be as [KISS](http://en.wikipedia.org/wiki/KISS_principle) as possible
|
||
|
|
|
||
|
|
## TODO:
|
||
|
|
[Vundle] is a work in progress, so any ideas and patches are appreciated.
|
||
|
|
|
||
|
|
* ✓ activate newly added bundles on `.vimrc` reload or after `:PluginInstall`
|
||
|
|
* ✓ use preview window for search results
|
||
|
|
* ✓ Vim documentation
|
||
|
|
* ✓ put Vundle in `bundles/` too (will fix Vundle help)
|
||
|
|
* ✓ tests
|
||
|
|
* ✓ improve error handling
|
||
|
|
* allow specifying revision/version?
|
||
|
|
* handle dependencies
|
||
|
|
* show description in search results
|
||
|
|
* search by description as well
|
||
|
|
* make it rock!
|
||
|
|
|
||
|
|
[Vundle]:http://github.com/VundleVim/Vundle.vim
|
||
|
|
[Windows setup]:https://github.com/VundleVim/Vundle.vim/wiki/Vundle-for-Windows
|
||
|
|
[FAQ]:https://github.com/VundleVim/Vundle.vim/wiki
|
||
|
|
[Tips]:https://github.com/VundleVim/Vundle.vim/wiki/Tips-and-Tricks
|
||
|
|
[Vim]:http://www.vim.org
|
||
|
|
[Git]:http://git-scm.com
|
||
|
|
[`git clone`]:http://gitref.org/creating/#clone
|
||
|
|
|
||
|
|
[Vim scripts]:http://vim-scripts.org/vim/scripts.html
|
||
|
|
[help tags]:http://vimdoc.sourceforge.net/htmldoc/helphelp.html#:helptags
|
||
|
|
[runtime path]:http://vimdoc.sourceforge.net/htmldoc/options.html#%27runtimepath%27
|
||
|
|
|
||
|
|
[configure]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L126-L233
|
||
|
|
[install]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L234-L254
|
||
|
|
[update]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L255-L265
|
||
|
|
[search]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L266-L295
|
||
|
|
[clean]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L303-L318
|
||
|
|
[interactive mode]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L319-L360
|
||
|
|
[interface change]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L372-L396
|