https://github.com/iamcco/git-p.nvim
Git plus for (neo)vim
https://github.com/iamcco/git-p.nvim
Last synced: 6 months ago
JSON representation
Git plus for (neo)vim
- Host: GitHub
- URL: https://github.com/iamcco/git-p.nvim
- Owner: iamcco
- Archived: true
- Created: 2019-02-25T06:51:26.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2021-06-08T23:15:39.000Z (over 4 years ago)
- Last Synced: 2024-08-07T18:33:30.840Z (over 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 114 KB
- Stars: 38
- Watchers: 3
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# git-p.nvim
> it support neovim with floating window feature
Git plus for (neo)vim
- diff sign fast async update
- use virtual text to display line blame
- show change with float window
[](https://asciinema.org/a/bjwwsMAMXT35v4l5wu7o2X9a6)
## Install
with vim-plug:
```vim
Plug 'iamcco/sran.nvim', { 'do': { -> sran#util#install() } }
Plug 'iamcco/git-p.nvim'
```
## Usage & Config
```vim
" enable virtual text to display blame and neovim support this
" default is: 1
let g:gitp_blame_virtual_text = 1
" use custom highlight for blame virtual text
" change GitPBlameLineHi to your highlight group
highlight link GitPBlameLine GitPBlameLineHi
" format blame virtual text
" hash: commit hash
" account: commit account name
" date: YYYY-MM-DD
" time: HH:mm:ss
" ago: xxx ago
" zone: +xxxx
" commit: commit message
" lineNum: line number
let g:gitp_blame_format = ' %{account} * %{ago}'
" NOTE: use %{hash:8} or %{hash:0:8} to use the first 8 characters
" statusline integrated: b:gitp_blame, b:gitp_diff_state
"
" blame info:
" b:gitp_blame = {
" hash: string
" account: string
" date: string
" time: string
" ago: string
" zone: string
" lineNum: string
" lineString: string
" commit: string
" rawString: string
" }
"
" diff lines stat:
" b:gitp_diff_state = { delete: number, add: number, modify: number }
"
" will trigger GitPDiffAndBlameUpdate event after these variables updated
" use custom highlight for diff sign
" change the GitPAddHi GitPModifyHi GitPDeleteHi to your highlight group
highlight link GitPAdd GitPAddHi
highlight link GitPModify GitPModifyHi
highlight link GitPDeleteTop GitPDeleteHi
highlight link GitPDeleteBottom GitPDeleteHi
highlight link GitPDeleteTopAndBottom GitPDeleteHi
" use custom diff sign
let g:gitp_add_sign = '■'
let g:gitp_modify_sign = '▣'
let g:gitp_delete_top_sign = '▤'
let g:gitp_delete_bottom_sign = '▤'
let g:gitp_delete_top_and_bottom_sign = '▤'
" let your sign column background same as line number column
" highlight! link SignColumn LineNr
" use d to display change
nmap d (git-p-diff-preview)
" show blame line manually if `let g:gitp_blame_virtual_text = 0`
nmap s (git-p-show-blame)
" NOTE: if have diff preview window, it will focus to the diff preview window
" if current window is diff preview window, it will close diff preview window
" or use `q` to quit diff preview window
" use custom highlight for float diff preview window
" change Pmenu to your highlight group
highlight link GitPDiffFloat Pmenu
```
## FAQ
A. Why my diff sign update slow
B. set updatetime to a small number like: `set updatetime=300`
A. I want to see coc's sign if the line have both sign.
B. set `"diagnostic.signOffset": 9999999` in coc-settings.json to let coc's sign get higher priority.
## TODO
- [ ] will use new sign api when it port to neovim. [8668](https://github.com/neovim/neovim/issues/8668)
### Buy Me A Coffee ☕️
