---

Ⅰ. 插件描述

A Vim script to return info about the Git branches.

Ⅱ. 基本信息

创建日期：  2008-06-05 使用用户：  31 Github星：  71 插件作者：  Eustaquio Rangel de Oliveira Jr.

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'taq/git-branch-info'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'taq/git-branch-info'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'taq/git-branch-info'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/taq/vim-git-branch-info

Ⅳ. 文档说明

This plugin show branches information on the status line.
To install, just put this file on ~/.vim/plugins and set your status line:

:set statusline=%{GitBranchInfoString}

Of course you can append this configuration to an existing one and make all
the customization you want on the status line, like:

:set statusline=%#ErrorMsg#%{GitBranchInfoString}%#StatusLine#

The command above will show the Git branches info on the same color as the
error messages. You can choose any color scheme you want to. Use

:help highlight-groups

to check for some other options.

There are some customization on the result string based on existing variables
like:

let g:git_branch_status_head_current=1
This will show just the current head branch name

let g:git_branch_status_text="text"
This will show 'text' before the branches. If not set ' Git ' (with a trailing
left space) will be displayed.

let g:git_branch_status_nogit=""
The message when there is no Git repository on the current dir

let g:git_branch_status_around=""
Characters to put around the branch strings. Need to be a pair or characters,
the first will be on the beginning of the branch string and the last on the
end.

let g:git_branch_status_ignore_remotes=1
Ignore the remote branches. If you don't want information about them, this can
make things works faster.

If you want to make your own customizations, you can use the GitBranchInfoTokens()

1. It returns an array with the current branch as the first element and
2. array with the other branches as the second element, like:

:set statusline=%#ErrorMsg#%{GitBranchInfoTokens()[0]}%#StatusLine#

or

:set statusline=%#StatusLineNC# Git %#ErrorMsg# %{GitBranchInfoTokens()[0]} %#StatusLine#

will give you a nice custom formatted string.

This will show you the current branch only. No prefix text, no characters
around it. You can also make another functions to use the returned array.

Get the latest code on http://github.com/taq/vim-git-branch-info