Jakobus Schürz
d2f0657629
and use the same pathes for vim plugin repos on git.schuerz.at as on github.com
162 lines
6.8 KiB
Markdown
162 lines
6.8 KiB
Markdown
## [幫助維護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)
|
||
|
||
|
||
|
||
## 快速開始
|
||
|
||
1. 介紹:
|
||
|
||
安裝需要[Git](http://git-scm.com/),觸發[`git clone`](http://gitref.org/creating/#clone),預設將每一個指定特定格式插件的倉庫複製到`~/.vim/bundle/`.
|
||
搜尋需要Curl支援.
|
||
|
||
Windows使用者請直接訪問[Windows setup]. 如果有任何問題, 請參考 [FAQ].
|
||
檢視 [Tips] 獲取相關高級配置.
|
||
|
||
使用 non-POSIX shells (比如流行的 Fish shell) 需要額外步驟. 請檢視 [FAQ].
|
||
|
||
2. 初始安裝 [Vundle]:
|
||
|
||
`$ git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim`
|
||
|
||
3. 配置插件 :
|
||
|
||
請將以下內容加在 `.vimrc` 頂部方可使用Vundle. 刪掉你不需要的插件, 以下只是示例.
|
||
|
||
```vim
|
||
set nocompatible " 去除VI一致性,必須
|
||
filetype off " 必須
|
||
|
||
" 設定 runtime path 以包含並初始化 Vundle
|
||
set rtp+=~/.vim/bundle/Vundle.vim
|
||
call vundle#begin()
|
||
" 另一種選擇, 指定 Vundle 安裝插件的路徑
|
||
"call vundle#begin('~/some/path/here')
|
||
|
||
" 讓 Vundle 管理自身,必須
|
||
Plugin 'VundleVim/Vundle.vim'
|
||
|
||
" 以下範例用來演示如何安裝不同來源的插件.
|
||
" 請將安裝插件的命令放在vundle#begin和vundle#end之間.
|
||
" Github上的插件
|
||
" 格式為 Plugin '使用者名/插件倉庫名'
|
||
Plugin 'tpope/vim-fugitive'
|
||
" 來自 http://vim-scripts.org/vim/scripts.html 的插件
|
||
" Plugin '插件名稱' 實際上是 Plugin 'vim-scripts/插件倉庫名' 只是此處的用戶名可以省略
|
||
Plugin 'L9'
|
||
" 不由 GitHub 託管的 Git 倉庫 Plugin 'git clone 後面的地址'
|
||
Plugin 'git://git.wincent.com/command-t.git'
|
||
" 本地的 Git 倉庫(例如自己的插件) Plugin 'file:///+本地插件倉庫絕對路徑'
|
||
Plugin 'file:///home/gmarik/path/to/plugin'
|
||
" 插件在倉庫的子目錄中.
|
||
" 指定路徑用以正確設定runtimepath. 以下範例插件在sparkup倉庫的vim目錄下
|
||
Plugin 'rstacruz/sparkup', {'rtp': 'vim/'}
|
||
" 安裝L9，如果已經安裝過這個插件，可利用以下格式避免命名衝突
|
||
Plugin 'ascenator/L9', {'name': 'newL9'}
|
||
|
||
" 你的所有插件需要在下面這行之前
|
||
call vundle#end() " 必須
|
||
filetype plugin indent on " 必須
|
||
" 要禁止插件改變縮排,可以使用下行替代:
|
||
"filetype plugin on
|
||
"
|
||
" 簡要幫助文檔
|
||
" :PluginList - 列出所有已配置的插件
|
||
" :PluginInstall - 安裝插件,追加 `!` 用以更新或使用 :PluginUpdate
|
||
" :PluginSearch foo - 搜尋 foo ; 追加 `!` 清除本地快取
|
||
" :PluginClean - 清除未使用插件,需要確認; 追加 `!` 自動批准移除未使用插件
|
||
"
|
||
" 查閱 :h vundle 獲取更多細節和wiki以及FAQ
|
||
" 將与插件無關的設放在這行之後
|
||
```
|
||
|
||
4. 安裝插件:
|
||
|
||
運行 `vim` 再運行 `:PluginInstall`
|
||
|
||
通過命令列直接安裝 `vim +PluginInstall +qall`
|
||
|
||
## Docs
|
||
|
||
查閱 [`:h vundle`](https://github.com/VundleVim/Vundle.vim/blob/master/doc/vundle.txt) Vimdoc 以獲取更多細節.
|
||
|
||
## 更新日誌
|
||
|
||
查閱 [changelog](https://github.com/VundleVim/Vundle.vim/blob/master/changelog.md).
|
||
|
||
## 在使用此插件的用戶的VIMRC
|
||
|
||
查閱 [Examples](https://github.com/VundleVim/Vundle.vim/wiki/Examples)
|
||
|
||
## 維護者
|
||
|
||
查閱 [Vundle contributors](https://github.com/VundleVim/Vundle.vim/graphs/contributors)
|
||
|
||
*感謝!*
|
||
|
||
## 靈感 & 思路
|
||
|
||
* [pathogen.vim](http://github.com/tpope/vim-pathogen/)
|
||
* [Bundler](https://github.com/bundler/bundler)
|
||
* [Scott Bronson](http://github.com/bronson)
|
||
|
||
## 另外
|
||
|
||
* Vundle 已測試環境為: [Vim] 7.3 on OS X, Linux and Windows
|
||
* Vundle 儘可能遵從 [KISS](http://en.wikipedia.org/wiki/KISS_principle) 原則
|
||
|
||
## TODO:
|
||
[Vundle] 是一個正在進步對項目, 所以很多設計思路和補丁是需要借鑒的.
|
||
|
||
* ✓ 在重新載入或者執行`:PluginInstall`之後激活`.vimrc`中新添加的插件
|
||
* ✓ 使用預覽視窗顯示搜尋結果
|
||
* ✓ Vim documentation
|
||
* ✓ 同時將Vundle 放置在 `bundles/` 中 (將修復 Vundle 幫助)
|
||
* ✓ 測試
|
||
* ✓ 提升錯誤處理能力
|
||
* 支持手動指定版本(待考慮)
|
||
* 版本依賴
|
||
* 搜尋結果中顯示描述
|
||
* 同時支援通過描述搜尋
|
||
* 使其更加穩定!
|
||
|
||
[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
|