| @ -0,0 +1,160 @@ | |||||
| ## [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 | |||||