|
| 1 | +## [帮助维护Vundle](https://github.com/VundleVim/Vundle.vim/issues/383) |
| 2 | + |
| 3 | +## 关于 |
| 4 | + |
| 5 | +[Vundle] 是 _Vim bundle_ 的简称,是一个 [Vim] 插件管理器. |
| 6 | + |
| 7 | +[Vundle] 允许你做... |
| 8 | + |
| 9 | +* 同时在`.vimrc`中跟踪和[管理](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L126-L233)插件 |
| 10 | +* [安装](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L234-L254)特定格式的插件(a.k.a. scripts/bundle) |
| 11 | +* [更新](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L255-L265)特定格式插件 |
| 12 | +* 通过插件名称[搜索](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L266-L295)[Vim scripts](http://vim-scripts.org/vim/scripts.html)中的插件 |
| 13 | +* [清理](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L303-L318)未使用的插件 |
| 14 | +* 可以通过*单一按键*完成以上操作,详见[interactive mode](https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L319-L360) |
| 15 | + |
| 16 | +[Vundle] 自动完成... |
| 17 | + |
| 18 | +* 管理已安装插件的[runtime path](http://vimdoc.sourceforge.net/htmldoc/options.html#%27runtimepath%27) |
| 19 | +* 安装和更新后,重新生成[帮助标签](http://vimdoc.sourceforge.net/htmldoc/helphelp.html#:helptags) |
| 20 | + |
| 21 | +[Vundle] 正在经历一个 [interface change], 请通过以下方式获取最新信息. |
| 22 | + |
| 23 | +讨论和技术支持:[](https://gitter.im/VundleVim/Vundle.vim) |
| 24 | + |
| 25 | + |
| 26 | + |
| 27 | +## 快速开始 |
| 28 | + |
| 29 | +1. 介绍: |
| 30 | + |
| 31 | + 安装需要[Git](http://git-scm.com/),触发[`git clone`](http://gitref.org/creating/#clone),默认将每一个指定特定格式插件的仓库复制到`~/.vim/bundle/`. |
| 32 | + 搜索需要Curl支持. |
| 33 | + |
| 34 | + Windows用户请直接访问[Windows setup]. 如果有任何问题, 请参考 [FAQ]. |
| 35 | + 查看 [Tips] 获取相关高级配置. |
| 36 | + |
| 37 | + 使用 non-POSIX shells, 比如比较流行对 Fish shell, 需要额外对步骤. 请查看 [FAQ]. |
| 38 | + |
| 39 | +2. 初始安装 [Vundle]: |
| 40 | + |
| 41 | + `$ git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim` |
| 42 | + |
| 43 | +3. 配置插件 : |
| 44 | + |
| 45 | + 请将以下加在 `.vimrc` 方可使用Vundle. 删掉你不需要的插件, 这些只是用做示例. |
| 46 | + |
| 47 | + ```vim |
| 48 | + set nocompatible " 去除VI一致性,必须 |
| 49 | + filetype off " 必须 |
| 50 | +
|
| 51 | + " 设置包括vundle和初始化相关的runtime path |
| 52 | + set rtp+=~/.vim/bundle/Vundle.vim |
| 53 | + call vundle#begin() |
| 54 | + " 另一种选择, 指定一个vundle安装插件的路径 |
| 55 | + "call vundle#begin('~/some/path/here') |
| 56 | +
|
| 57 | + " 让vundle管理插件版本,必须 |
| 58 | + Plugin 'VundleVim/Vundle.vim' |
| 59 | +
|
| 60 | + " 以下范例用来支持不同格式的插件安装. |
| 61 | + " 请将安装插的命令放在vundle#begin和vundle#end之间. |
| 62 | + " Github上的插件 |
| 63 | + " 格式为 Plugin '用户名/插件仓库名' |
| 64 | + Plugin 'tpope/vim-fugitive' |
| 65 | + " 来自 http://vim-scripts.org/vim/scripts.html 的插件 |
| 66 | + " Plugin '插件名称' 实际上是 Plugin 'vim-scripts/插件仓库名' 只是此处的用户名可以省略 |
| 67 | + Plugin 'L9' |
| 68 | + " 由Git支持但不再github上的插件仓库 Plugin 'git clone 后面的地址' |
| 69 | + Plugin 'git://git.wincent.com/command-t.git' |
| 70 | + " 本地的Git仓库(例如自己的插件) Plugin 'file:///+本地插件仓库绝对路径' |
| 71 | + Plugin 'file:///home/gmarik/path/to/plugin' |
| 72 | + " 插件在仓库的子目录中. |
| 73 | + " 正确指定路径用以设置runtimepath. 以下范例插件在sparkup/vim目录下 |
| 74 | + Plugin 'rstacruz/sparkup', {'rtp': 'vim/'} |
| 75 | + " 避免插件名冲突,例如L9已存在,则可以指定 |
| 76 | + Plugin 'user/L9', {'name': 'newL9'} |
| 77 | +
|
| 78 | + " 你的所有插件需要在下面这行之前 |
| 79 | + call vundle#end() " 必须 |
| 80 | + filetype plugin indent on " 必须 加载vim自带和插件相应的语法和文件类型相关脚本 |
| 81 | + " 忽视插件改变缩进,可以使用以下替代: |
| 82 | + "filetype plugin on |
| 83 | + " |
| 84 | + " 简要帮助文档 |
| 85 | + " :PluginList - 列出所有已配置的插件 |
| 86 | + " :PluginInstall - 安装插件,追加 `!` 用以更新或使用 :PluginUpdate |
| 87 | + " :PluginSearch foo - 搜索 foo ; 追加 `!` 清除本地缓存 |
| 88 | + " :PluginClean - 清除未使用插件,需要确认; 追加 `!` 自动批准移除未使用插件 |
| 89 | + " |
| 90 | + " 查阅 :h vundle 获取更多细节和wiki以及FAQ |
| 91 | + " 将你自己对非插件片段放在这行之后 |
| 92 | + ``` |
| 93 | + |
| 94 | +4. 安装插件: |
| 95 | + |
| 96 | + 运行 `vim` 再运行 `:PluginInstall` |
| 97 | + |
| 98 | + 通过命令行直接安装 `vim +PluginInstall +qall` |
| 99 | + |
| 100 | +## Docs |
| 101 | + |
| 102 | +查阅 [`:h vundle`](https://github.com/VundleVim/Vundle.vim/blob/master/doc/vundle.txt) Vimdoc 以获取更多细节. |
| 103 | + |
| 104 | +## 更新日志 |
| 105 | + |
| 106 | +查阅 [changelog](https://github.com/VundleVim/Vundle.vim/blob/master/changelog.md). |
| 107 | + |
| 108 | +## 在使用此插件的用户的VIMRC |
| 109 | + |
| 110 | +查阅 [Examples](https://github.com/VundleVim/Vundle.vim/wiki/Examples) |
| 111 | + |
| 112 | +## 维护者 |
| 113 | + |
| 114 | +查阅 [Vundle contributors](https://github.com/VundleVim/Vundle.vim/graphs/contributors) |
| 115 | + |
| 116 | +*感谢!* |
| 117 | + |
| 118 | +## 灵感 & 思路 |
| 119 | + |
| 120 | +* [pathogen.vim](http://github.com/tpope/vim-pathogen/) |
| 121 | +* [Bundler](https://github.com/bundler/bundler) |
| 122 | +* [Scott Bronson](http://github.com/bronson) |
| 123 | + |
| 124 | +## 另外 |
| 125 | + |
| 126 | +* Vundle 已测试环境为: [Vim] 7.3 on OS X, Linux and Windows |
| 127 | +* Vundle 尝试尽可能保持至简模式 [KISS](http://en.wikipedia.org/wiki/KISS_principle) |
| 128 | + |
| 129 | +## TODO: |
| 130 | +[Vundle] 是一个正在进步对项目, 所以很多设计思路和补丁是需要借鉴的. |
| 131 | + |
| 132 | +* ✓ 在重新载入或者执行`:PluginInstall`之后激活`.vimrc`中新添加的插件 |
| 133 | +* ✓ 使用预览窗口显示搜索结果 |
| 134 | +* ✓ Vim documentation |
| 135 | +* ✓ 同时将Vundle 放置在 `bundles/` 中 (将修复 Vundle 帮助) |
| 136 | +* ✓ 测试 |
| 137 | +* ✓ 提升错误处理能力 |
| 138 | +* 支持手动指定版本(待考虑) |
| 139 | +* 版本依赖 |
| 140 | +* 搜索结果中显示描述 |
| 141 | +* 同时支持通过描述搜索 |
| 142 | +* 使其更加稳定! |
| 143 | + |
| 144 | +[Vundle]:http://github.com/VundleVim/Vundle.vim |
| 145 | +[Windows setup]:https://github.com/VundleVim/Vundle.vim/wiki/Vundle-for-Windows |
| 146 | +[FAQ]:https://github.com/VundleVim/Vundle.vim/wiki |
| 147 | +[Tips]:https://github.com/VundleVim/Vundle.vim/wiki/Tips-and-Tricks |
| 148 | +[Vim]:http://www.vim.org |
| 149 | +[Git]:http://git-scm.com |
| 150 | +[`git clone`]:http://gitref.org/creating/#clone |
| 151 | + |
| 152 | +[Vim scripts]:http://vim-scripts.org/vim/scripts.html |
| 153 | +[help tags]:http://vimdoc.sourceforge.net/htmldoc/helphelp.html#:helptags |
| 154 | +[runtime path]:http://vimdoc.sourceforge.net/htmldoc/options.html#%27runtimepath%27 |
| 155 | + |
| 156 | +[configure]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L126-L233 |
| 157 | +[install]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L234-L254 |
| 158 | +[update]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L255-L265 |
| 159 | +[search]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L266-L295 |
| 160 | +[clean]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L303-L318 |
| 161 | +[interactive mode]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L319-L360 |
| 162 | +[interface change]:https://github.com/VundleVim/Vundle.vim/blob/v0.10.2/doc/vundle.txt#L372-L396 |
0 commit comments