Git Support

Ⅰ. 插件描述

Inspect the state of a repository and execute Git commands without leaving Vim.

Ⅱ. 基本信息

创建日期：  2013-03-30
使用用户：  4
Github星：  6
插件作者：  Wolfgang Mehner

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加: 
Plugin 'wolfgangmehner/git-support'
… 然后在Vim中运行以下命令: 
:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加: 
NeoBundle 'wolfgangmehner/git-support'
… 然后在Vim中运行以下命令: 
:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加: 
Plug 'wolfgangmehner/git-support'
… 然后在Vim中运行以下命令: 
:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令: 
cd ~/.vim/bundle
git clone https://github.com/wolfgangmehner/git-support

Ⅳ. 文档说明

Preface

This repository is mainly for the use with plug-in managers.

Have a look at the Screenshot Page.

The development happens in WolfgangMehner/vim-plugins.

Preview Version

This is a preview version!

Notable new feature:

  • Fully enabled for Neovim.
  • Run Git in a terminal window directly inside the editor.

The terminal window relies on the new +terminal feature, which becomes
available with a patch level of approx. 8.0.1000.

Please read the release notes below.

README for git-support.vim (Version 0.9.4) / April 23 2019

  • INSTALLATION
  • RELEASE NOTES
  • FILES
  • CREDITS

Integration of Git for Vim/gVim. The plug-in at hand allows to use Git from
within Vim, eliminating the need for context switches. The output of commands
like "git status" is written into buffers, and the commit can be manipulated
from right there. Further commands allow to quickly add the file in the
current buffer or show its diff.
Please read the documentation.

This plug-in can be used with Vim version 7.3+ and Neovim 0.2.1+.

INSTALLATION

(1) LINUX

The subdirectories in the zip archive git-support.zip mirror the directory
structure which is needed below the local installation directory

  $HOME/.vim/

(find the value of $HOME with :echo $HOME from inside Vim).

(1.1) Copy the zip archive git-support.zip to $HOME/.vim and run

  unzip git-support.zip

(1.2) Loading of plug-in files must be enabled. If not use

  :filetype plugin on

This is the minimal content of the file $HOME/.vimrc. Create one if there
is none or use the file in $HOME/.vim/git-support/rc as a starting point.

(1.3) Make the plug-in help accessible by typing the following command on the
Vim command line:

  :helptags $HOME/.vim/doc/

(1.4) To get a syntax highlighting closer to the one Git uses, take a look at
the suggestions in git-support/rc/additions.vimrc, which offers example
settings for bright and dark backgrounds.

(1.5) Consider additional settings in the file $HOME/.vimrc. The files
customization.vimrc and customization.gvimrc are replacements or
extensions for your .vimrc and .gvimrc. You may want to use parts of

  1. The files are documented.

(2) WINDOWS

The subdirectories in the zip archive git-support.zip mirror the directory
structure which is needed below the local installation directory

  $HOME/vimfiles/

(find the value of $HOME with :echo $HOME from inside Vim).

(2.1) Copy the zip archive git-support.zip to $HOME/vimfiles and run

  unzip git-support.zip

(2.2) Loading of plug-in files must be enabled. If not use

  :filetype plugin on

This is the minimal content of the file $HOME/_vimrc. Create one if there
is none or use the file in $HOME/vimfiles/git-support/rc as a starting point.

(2.3) Make the plug-in help accessible by typing the following command on the
Vim command line:

  :helptags $HOME\vimfiles\doc\

(2.4) Set the correct executable. This is not necessary if git is already on
your path. See :help g:Git_Executable.

(2.5) To get a syntax highlighting closer to the one Git uses, take a look at
the suggestions in git-support\rc\additions.vimrc, which offers example
settings for bright and dark backgrounds.

(2.6) Consider additional settings in the file $HOME/_vimrc. The files
customization.vimrc and customization.gvimrc are replacements or
extensions for your _vimrc and _gvimrc. You may want to use parts of

  1. The files are documented.

(3) ADDITIONAL REMARKS

There are a lot of features and options which can be used and influenced:

  • the Git executable
  • removing the Git menu
  • the syntax highlighting
  • the behavior of various commands

Please read the documentation:

  :help gitsupport

Any problems? See the TROUBLESHOOTING section at the end of the help file
doc/gitsupport.txt.

RELEASE NOTES

RELEASE NOTES FOR VERSION 0.9.4

  • Add command :GitTerm to execute Git in a terminal window (requires +terminal).
  • Improve :GitGrep (in case +conceal is available).
  • Improve :GitLog to support ranges.
  • Add a map to the buffer: status
  • Adapt for running under Neovim more smoothly.
  • Minor changes.

RELEASE NOTES FOR OLDER VERSIONS

-> see file git-support/doc/ChangeLog

KNOWN ISSUES

  • Windows: When entered on the Vim command line, commands containing filenames
    as parameters cause errors such as "... file not found ...".

    • This may happen if filenames contain special characters such as spaces. The
      Vim command line escapes those differently then Windows expects then to be

    escaped.

    • However, a filename containing spaces can always be escape using quotes:

      :GitAdd "help 1.txt"

    • If you already are in the corresponding buffer, simply use:

      :GitAdd

FILES

README.md
                    This file.

doc/gitsupport.txt
                    The help file for Git Support.

plugin/git-support.vim
                    The Git plug-in for Vim/gVim.

syntax/gitsbranch.vim
syntax/gitscommit.vim
syntax/gitsdiff.vim
syntax/gitslog.vim
syntax/gitssshort.vim
syntax/gitsstatus.vim
                    The syntax files used by Git Support. gitssshort.vim
                    is used for the output of "git status --short".
                    gitscommit.vim is used for commit messages.

The following files and extensions are for convenience only.
git-support.vim will work without them.
The settings are explained in the files themselves.

git-support/doc/ChangeLog
                    Complete change log.

git-support/rc/additions.gvimrc
                    Additional settings for use in .gvimrc:
                      hot keys, mouse settings, fonts, ...

git-support/rc/additions.vimrc
                    Example settings for use in .vimrc:
                      setup of the plug-in, syntax highlighting

git-support/rc/customization.gvimrc
                    Suggestion for the configuration file .gvimrc:
                      hot keys, mouse settings, fonts, ...

git-support/rc/customization.vimrc
                    Suggestion for the configuration file .vimrc:
                      hot keys, tabstop, use of dictionaries,
                      the setup of the plug-in, ...

CREDITS

For a complete list of people who made contributions to this plug-in,
please be so kind as to take a look at the credits:

  :help gitsupport-credits

添加新评论