dotfiles/dot_vim/bundle/Vundle.vim/README_ZH_TW.md

幫助維護Vundle

關於

Vundle 是 Vim bundle 的簡稱,是一個 Vim 插件管理器.

Vundle 允許你做...

• 同時在.vimrc中跟蹤和管理插件
• 安裝特定格式的插件(a.k.a. scripts/bundle)
• 更新特定格式插件
• 通過插件名稱搜尋Vim scripts中的插件
• 清理未使用的插件
• 可以通過單一按鍵完成以上操作,詳見interactive mode

Vundle 自動完成...

• 管理已安裝插件的runtime path
• 安裝和更新後,重新生成幫助標籤

Vundle 正在經歷一個 interface change, 請通過以下方式獲取最新資訊.

討論和技術支援:

快速開始

1. 介紹:

   安裝需要Git,觸發git 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. 刪掉你不需要的插件, 以下只是示例.

   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 Vimdoc 以獲取更多細節.

更新日誌

查閱 changelog.

在使用此插件的用戶的VIMRC

查閱 Examples

維護者

查閱 Vundle contributors

感謝!

靈感 & 思路

• pathogen.vim
• Bundler
• Scott Bronson

另外

• Vundle 已測試環境為: Vim 7.3 on OS X, Linux and Windows
• Vundle 儘可能遵從 KISS 原則

TODO:

Vundle 是一個正在進步對項目, 所以很多設計思路和補丁是需要借鑒的.

• ✓ 在重新載入或者執行:PluginInstall之後激活.vimrc中新添加的插件
• ✓ 使用預覽視窗顯示搜尋結果
• ✓ Vim documentation
• ✓ 同時將Vundle 放置在 bundles/ 中 (將修復 Vundle 幫助)
• ✓ 測試
• ✓ 提升錯誤處理能力
• 支持手動指定版本(待考慮)
• 版本依賴
• 搜尋結果中顯示描述
• 同時支援通過描述搜尋
• 使其更加穩定!