m-vim_plugins/vim-gitgutter
1
0
Fork 0
mirror of https://github.com/airblade/vim-gitgutter.git synced 2025-11-08 11:33:48 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity

Add instructions on how to customize colours in preview window

Browse Source
This commit is contained in:
naohiro ono
2021-08-06 22:12:11 +09:00
committed by Andy Stewart
parent 4adaa7adaa
commit 549fb96d58
2 changed files with 52 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
README.mkd
View File

@@ -283,6 +283,9 @@ You can customise:
* How to handle non-gitgutter signs * How to handle non-gitgutter signs
* The signs' colours and symbols * The signs' colours and symbols
* Line highlights * Line highlights
* Line number highlights (only in Neovim 0.3.2 or higher)
* The diff syntax colours used in the preview window
* The intra-line diff highlights used in the preview window
* Whether the diff is relative to the index (default) or working tree. * Whether the diff is relative to the index (default) or working tree.
* The base of the diff * The base of the diff
* Extra arguments for `git` when running `git diff` * Extra arguments for `git` when running `git diff`
@@ -395,6 +398,35 @@ highlight link GitGutterChangeLineNr Underlined
``` ```
#### The diff syntax colours used in the preview window
To change the diff syntax colours used in the preview window, set up the `diff*` highlight groups in your colorscheme or `~/.vimrc`:
```viml
diffAdded " if not set: use GitGutterAdd's foreground colour
diffChanged " if not set: use GitGutterChange's foreground colour
diffRemoved " if not set: use GitGutterDelete's foreground colour
```
Note the `diff*` highlight groups are used in any buffer whose `'syntax'` is `diff`.
#### The intra-line diff highlights used in the preview window
To change the intra-line diff highlights used in the preview window, set up the following highlight groups in your colorscheme or `~/.vimrc`:
```viml
GitGutterAddIntraLine " default: gui=reverse cterm=reverse
GitGutterDeleteIntraLine " default: gui=reverse cterm=reverse
```
For example, to use `DiffAdd` for intra-line added regions:
```viml
highlight link GitGutterAddIntraLine DiffAdd
```
#### Whether the diff is relative to the index or working tree #### Whether the diff is relative to the index or working tree
By default diffs are relative to the index. How you can make them relative to the working tree: By default diffs are relative to the index. How you can make them relative to the working tree:

20
doc/gitgutter.txt
View File

@@ -608,6 +608,26 @@ For example, to use |hl-Underlined| instead of |hl-CursorLineNr|:
> >
highlight link GitGutterChangeLineNr Underlined highlight link GitGutterChangeLineNr Underlined
< <
To change the diff syntax colours used in the preview window, set up the diff*
highlight groups in your colorscheme or |vimrc|:
>
diffAdded " if not set: use GitGutterAdd's foreground colour
diffChanged " if not set: use GitGutterChange's foreground colour
diffRemoved " if not set: use GitGutterDelete's foreground colour
<
Note the diff* highlight groups are used in any buffer whose 'syntax' is
"diff".
To change the intra-line diff highlights used in the preview window, set up
the following highlight groups in your colorscheme or |vimrc|:
>
GitGutterAddIntraLine " default: gui=reverse cterm=reverse
GitGutterDeleteIntraLine " default: gui=reverse cterm=reverse
<
For example, to use |hl-DiffAdd| for intra-line added regions:
>
highlight link GitGutterAddIntraLine DiffAdd
<
=============================================================================== ===============================================================================