# plugins

* [highly recommended](#highly-recommended)
  * [LunarWatcher/auto-pairs](#lunarwatcherauto-pairs)
  * [junegunn/fzf.vim](#junegunnfzfvim)
  * [luochen1990/rainbow](#luochen1990rainbow)
  * [Yggdroot/indentLine](#yggdrootindentline)
  * [vim-airline/vim-airline](#vim-airlinevim-airline)
* [programming](#programming)
  * [vim-syntastic/syntastic](#vim-syntasticsyntastic)
  * [coc.nvim](#cocnvim)
    * [coc-snippets](#coc-snippets)
    * [coc-word](#coc-word)
    * [extensions management](#extensions-management)
  * [nvim-treesitter/nvim-treesitter](#nvim-treesitternvim-treesitter)
  * [github/copilot.vim](#githubcopilotvim)
    * [CopilotChat.nvim](#copilotchatnvim)
    * [troubleshooting](#troubleshooting)
  * [tomtom/tcomment\_vim](#tomtomtcomment_vim)
  * [dense-analysis/ale](#dense-analysisale)
* [color and theme](#color-and-theme)
  * [scrooloose/nerdtree](#scrooloosenerdtree)
  * [ryanoasis/vim-devicons](#ryanoasisvim-devicons)
  * [RRethy/vim-hexokinase](#rrethyvim-hexokinase)
* [utils](#utils)
  * [vim-scripts/AuthorInfoDetect](#vim-scriptsauthorinfodetect)
  * [simnalamburt/vim-mundo](#simnalamburtvim-mundo)
  * [yegappan/mru](#yegappanmru)
  * [amitds1997/remote-nvim.nvim](#amitds1997remote-nvimnvim)
* [markdown](#markdown)
  * [preservim/vim-markdown](#preservimvim-markdown)
  * [dhruvasagar/vim-table-mode](#dhruvasagarvim-table-mode)
  * [godlygeek/tabular](#godlygeektabular)
* [git](#git)
  * [airblade/vim-gitgutter](#airbladevim-gitgutter)
  * [tpope/vim-fugitive](#tpopevim-fugitive)
  * [APZelos/blamer.nvim](#apzelosblamernvim)
  * [zivyangll/git-blame.vim](#zivyangllgit-blamevim)
* [troubleshooting](#troubleshooting-1)
  * [airline](#airline)

{% hint style="info" %}

> references:
>
> * [\* vimcolorschemes](https://vimcolorschemes.com/)
> * [Spelling And Grammar With Vim](https://www.vimfromscratch.com/articles/spell-and-grammar-vim)
> * [iMarslo: deprecated plugins](https://github.com/marslo/ibook/blob/marslo/docs/vim/plugins/deprecated.html)
> * [codicocodes/dotfyle](https://github.com/codicocodes/dotfyle) | [Trending Neovim Plugins](https://dotfyle.com/neovim/plugins/trending)
> * dotfiles/vimrc
>   * [\* amix/vimrc](https://github.com/amix/vimrc)
>   * [vim-devicon author: ryanoasis/dotfiles](https://github.com/ryanoasis/dotfiles/tree/master)
>     {% endhint %}

## highly recommended

> \[!NOTE|label:references:]
>
> * [Vim Plugin Audit](https://tuckerchapman.com/2020/05/18/vim-plugin-audit/)

### [LunarWatcher/auto-pairs](https://github.com/LunarWatcher/auto-pairs/tree/master)

```vim
" LunarWatcher/auto-pairs
let g:AutoPairs                             = autopairs#AutoPairsDefine({ '<': '>' })
let g:AutoPairsMapBS                        = 1
let g:AutoPairsFlyMode                      = 0
let g:AutoPairsCompleteOnlyOnSpace          = 1
let g:AutoPairsNoJump                       = 0
let g:AutoPairsSpaceCompletionRegex         = '\w'
" to avoid impact with ctrl-p ( :Files )
let g:AutoPairsShortcutToggleMultilineClose = 0
let g:AutoPairsShortcutBackInsert           = '<M-b>'
let g:AutoPairsPrefix                       = '<M-j>'
let g:AutoPairsShortcutJump                 = '<M-n>'
let g:AutoPairsShortcutToggle               = '<M-j>'

augroup DevOps
  autocmd FileType markdown,html let g:AutoPairsCompleteOnlyOnSpace = 0
  autocmd FileType markdown,html let b:AutoPairs = autopairs#AutoPairsDefine({
        \ '<div>':'</div>', '<font>':'</font>', '<a>':'</a>', '<p>':'</p>',
        \ '<table>':'</table>', '<tbody>':'</tbody>',
        \ '<thread>':'</thread>', '<th>':'</th>', '<td>':'</td>'
        \ })
augroup END
```

[![vim auto-pairs](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-3c6399e13d9b1763031b85d0210078cdd9f3de33%2Fvim-auto-pairs.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-auto-pairs.gif)

### [junegunn/fzf.vim](https://github.com/junegunn/fzf.vim)

```vim
set runtimepath+=/usr/local/opt/fzf                                         " $ brew install fzf
Plug '/usr/local/opt/fzf'
Plug 'junegunn/fzf.vim'

" junegunn/fzf.vim
nnoremap <silent> <leader>ff :Files<CR>
nnoremap <silent> <leader>gf :GFiles<CR>
nnoremap <silent> <leader>ag :Ag<CR>
nnoremap <silent> <leader>l  :Buffers<CR>
nnoremap <silent> <Leader>H  :Helptags<CR>
nnoremap <silent> <Leader>g  :Commits<CR>
nnoremap <silent> <Leader>hh :History:<CR>
inoremap <expr> <c-x><c-k> fzf#vim#complete('cat /usr/share/dict/words')
inoremap <expr> <c-x><c-l> fzf#vim#complete(fzf#wrap({
  \ 'prefix': '^.*$',
  \ 'source': 'rg -n ^ --color always',
  \ 'options': '--ansi --delimiter : --nth 3..',
  \ 'reducer': { lines -> join(split(lines[0], ':\zs')[2:], '') }
\ }))
let g:fzf_vim                     = {}
let g:fzf_vim.preview_window      = [ 'right,50%', 'ctrl-\' ]
let g:fzf_vim.tags_command        = 'ctags -R'
let g:fzf_vim.commits_log_options = '--graph --color=always --format="%C(auto)%h%d %s %C(black)%C(bold)%cr"'
let $FZF_DEFAULT_COMMAND          = 'ag --hidden --ignore .git -l -g ""'
command! -bang -nargs=? -complete=dir Files
    \ call fzf#vim#files(<q-args>, {'options': ['--layout=reverse', '--info=inline', '--preview', 'bat --color=always {}']}, <bang>0)
command! -bang -complete=dir -nargs=? LS
    \ call fzf#run(fzf#wrap('ls', {'source': 'ls', 'dir': <q-args>}, <bang>0))
let g:fzf_layout                  = { 'window': { 'width': 0.9, 'height': 0.6, 'relative': v:true } }
let g:fzf_history_dir             = '~/.vim/cache/fzf-history'
let g:fzf_action                  = {
  \ 'ctrl-t': 'tab split',
  \ 'ctrl-x': 'split',
  \ 'ctrl-v': 'vsplit'
\ }
let g:fzf_colors                  = {
  \ 'fg':         ['fg', 'Normal'                               ] ,
  \ 'bg':         ['bg', 'Normal'                               ] ,
  \ 'preview-bg': ['bg', 'NormalFloat'                          ] ,
  \ 'hl':         ['fg', 'Comment'                              ] ,
  \ 'fg+':        ['fg', 'CursorLine', 'CursorColumn', 'Normal' ] ,
  \ 'bg+':        ['bg', 'CursorLine', 'CursorColumn'           ] ,
  \ 'hl+':        ['fg', 'Statement'                            ] ,
  \ 'info':       ['fg', 'PreProc'                              ] ,
  \ 'border':     ['fg', 'Ignore'                               ] ,
  \ 'prompt':     ['fg', 'Conditional'                          ] ,
  \ 'pointer':    ['fg', 'Exception'                            ] ,
  \ 'marker':     ['fg', 'Keyword'                              ] ,
  \ 'spinner':    ['fg', 'Label'                                ] ,
  \ 'header':     ['fg', 'Comment'                              ]
\ }
```

### [luochen1990/rainbow](https://github.com/luochen1990/rainbow)

> \[!NOTE|label:alternative:]
>
> * [HiPhish/rainbow-delimiters.nvim](https://gitlab.com/HiPhish/rainbow-delimiters.nvim)

```vim
Plug 'luochen1990/rainbow'

" luochen1990/rainbow
" for i in '75' '147' '108' '196' '208' '66' '106' '172' '115' '129'; do echo -e "\e[38;05;${i}m${i}"; done | column -c 250 -s ' '; echo -e "\e[m"
let g:rainbow_active    = 1
let g:rainbow_operators = 1
let g:rainbow_conf      = {
  \ 'guifgs' : [ '#6A5ACD', '#ff6347', '#b58900', '#9acd32', '#EEC900', '#9A32CD', '#EE7600', '#268bd2', '#183172' ],
  \ 'ctermfgs' : 'xterm-256color' == $TERM ? [ '75', '147', '108', '196', '208', '66', '106', '172', '115', '129' ] : [ 'lightblue', 'lightgreen', 'yellow', 'red', 'magenta' ],
  \ 'parentheses': ['start=/(/ end=/)/ fold', 'start=/\[/ end=/\]/ fold', 'start=/{/ end=/}/ fold'],
  \ 'operators': '_,_',
  \ 'separately': {
  \   '*': {},
  \   'markdown': {
  \     'parentheses_options': 'containedin=markdownCode contained',
  \   },
  \   'css': {
  \     'parentheses': [ ['(',')'], ['\[','\]'] ],
  \   },
  \   'scss': {
  \     'parentheses': [ ['(',')'], ['\[','\]'] ],
  \   },
  \   'stylus': {
  \     'parentheses': [ 'start=/{/ end=/}/ fold contains=@colorableGroup' ],
  \   },
  \   'vim': {
  \     'parentheses': ['start=/(/ end=/)/', 'start=/\[/ end=/\]/', 'start=/{/ end=/}/ fold', 'start=/(/ end=/)/ containedin=vimFuncBody', 'start=/\[/ end=/\]/ containedin=vimFuncBody', 'start=/{/ end=/}/ fold containedin=vimFuncBody'],
  \   },
  \   'html': {
  \     'parentheses': ['start=/\v\<((area|base|br|col|embed|hr|img|input|keygen|link|menuitem|meta|param|source|track|wbr)[ >])@!\z([-_:a-zA-Z0-9]+)(\s+[-_:a-zA-Z0-9]+(\=("[^"]*"|'."'".'[^'."'".']*'."'".'|[^ '."'".'"><=`]*))?)*\>/ end=#</\z1># fold'],
  \   },
  \   'nerdtree': 0
  \ }}
```

### [Yggdroot/indentLine](https://github.com/Yggdroot/indentLine)

> \[!NOTE|label:alternative:]
>
> * [\* glepnir/indent-guides.nvim](https://dotfyle.com/plugins/glepnir/indent-guides.nvim)
> * [\* shellRaining/hlchunk.nvim](https://github.com/shellRaining/hlchunk.nvim)
> * [nvimdev/indentmini.nvim](https://github.com/nvimdev/indentmini.nvim)
> * [lukas-reineke/indent-blankline.nvim](https://github.com/lukas-reineke/indent-blankline.nvim)
> * [preservim/vim-indent-guides](https://github.com/preservim/vim-indent-guides)
> * [echasnovski/mini.indentscope](https://github.com/echasnovski/mini.indentscope)

```vim
Plug 'Yggdroot/indentLine'

" settings
nnoremap <leader>idl :IndentLineEnable<CR>

let g:indentLine_enabled              = 1
let g:indentLine_color_gui            = "#282828"
let g:indentLine_color_term           = 239
let g:indentLine_indentLevel          = 20
let g:indentLine_showFirstIndentLevel = 1
let g:indentLine_color_tty            = 0
let g:indentLine_faster               = 1
let g:indentLine_concealcursor        = 'inc'
let g:indentLine_conceallevel         = 2
if has( 'gui_running' ) || 'xterm-256color' == $TERM
  let g:indentLine_char               = '¦'
elseif has( 'win32' )
  let g:indentLine_color_term         = 8
  let g:indentLine_char               = '|'
else
  let g:indentLine_color_tty_dark     = 0
  let g:indentLine_char               = '¦'
endif
```

### [vim-airline/vim-airline](https://github.com/vim-airline/vim-airline)

> \[!NOTE|label:references:]
>
> * [\* iMarso : osx/apps/powerline](https://github.com/marslo/ibook/blob/marslo/docs/vim/osx/apps.html#powerline)
> * [\* Getting started with vim-airline](https://tuckerchapman.com/2020/09/15/getting-started-vim-airline/)
> * [How do I fix the status bar symbols in the Airline plugin?](https://vi.stackexchange.com/a/16512/7389)
> * [Airline status line and tab line text changes colour when the vimrc is sourced.](https://www.reddit.com/r/vim/comments/q3ufc0/airline_status_line_and_tab_line_text_changes/)
> * [Vim Airline Setup](https://jnduli.co.ke/vim-airline-setup.html)
> * [autoload/airline/init.vim](https://github.com/vim-airline/vim-airline/blob/master/autoload/airline/init.vim)
> * [Getting started with vim-airline](https://tuckerchapman.com/posts/getting-started-vim-airline/)
> * section:
>   * [#787: How to modify contents of section Y?](https://github.com/vim-airline/vim-airline/issues/787#issue-84289641)
>   * [#1087: How to replace section\_y with contents of section\_x?](https://github.com/vim-airline/vim-airline/issues/1087)
>   * [#1845: how to disable additional section totally.](https://github.com/vim-airline/vim-airline/issues/1845#issuecomment-449700299)
> * tips:
>   * check loaded extensions : `:AirlineExtension`
>   * [#1373 How can I show system time in airline?](https://github.com/vim-airline/vim-airline/issues/1373#issuecomment-273040424)
>   * [\* FAQ](https://github.com/vim-airline/vim-airline/wiki/FAQ)

```vim
Plug 'tpope/vim-fugitive'
Plug 'vim-airline/vim-airline'
Plug 'vim-airline/vim-airline-themes'

" vim-airline/vim-airline
let g:airline_powerline_fonts                      = 1
let g:airline_highlighting_cache                   = 1
let g:airline_detect_spelllang                     = 0              " disable spelling language
let g:airline_exclude_preview                      = 0              " disable in preview window
let g:airline_theme                                = 'base16_embers'" 'apprentice', 'base16', 'gruvbox', 'zenburn', 'base16_atelierheath'
let g:Powerline_symbols                            = 'fancy'
let g:airline_section_y                            = ''             " fileencoding
let g:airline_section_x                            = ''
let g:airline_section_z                            = "%3p%% %l/%L:%c [%B]"
let g:airline_skip_empty_sections                  = 1
let g:airline_detect_modified                      = 1
let g:airline_detect_paste                         = 1
let g:airline#extensions#wordcount#enabled         = 1
let g:airline#extensions#wordcount#filetypes       = '\vtext|nroff|plaintex'
let g:airline#extensions#quickfix#enabled          = 0
let g:airline#extensions#quickfix#quickfix_text    = 'Quickfix'
let g:airline_stl_path_style                       = 'short'
let g:airline#extensions#tabline#enabled           = 1              " ╮ enable airline tabline
let g:airline#extensions#tabline#fnamemod          = ':t'           " │
let g:airline#extensions#tabline#show_close_button = 0              " │ remove 'X' at the end of the tabline
let g:airline#extensions#tabline#show_buffers      = 1              " │
let g:airline#extensions#tabline#show_splits       = 0              " │ disables the buffer name that displays on the right of the tabline
let g:airline#extensions#tabline#tab_min_count     = 2              " │ minimum of 2 tabs needed to display the tabline
let g:airline#extensions#tabline#show_tabs         = 0              " │
let g:airline#extensions#tabline#tab_nr_type       = 1              " ╯ tab number
let g:airline#extensions#branch#format             = 2
let g:airline#extensions#fzf#enabled               = 1
let g:airline#extensions#nerdtree_statusline       = 1
let g:airline#extensions#syntastic#enabled         = 1
let g:airline#extensions#coc#enabled               = 1              " ╮
let g:airline#extensions#coc#show_coc_status       = 0              " │
let g:airline#extensions#coc#error_symbol          = ' ✗:'          " ├ coc
let g:airline#extensions#coc#warning_symbol        = ' ⍨:'          " │
let g:airline#extensions#coc#stl_format_err        = '%C(␊%L)'      " │
let g:airline#extensions#coc#stl_format_warn       = '%C(␊%L)'      " ╯
let g:airline#extensions#ale#enabled               = 0              " ╮
let g:airline#extensions#ale#error_symbol          = ' ᓆ :'         " │
let g:airline#extensions#ale#warning_symbol        = ' ᣍ :'         " ├ ale
let g:airline#extensions#ale#show_line_numbers     = 0              " │
let g:airline#extensions#ale#open_lnum_symbol      = '(␊:'          " │
let g:airline#extensions#ale#close_lnum_symbol     = ')'            " ╯
" let g:airline_mode_map                           = { '__': '-', 'n' : 'N', 'i' : 'I', 'R' : 'R', 'c' : 'C', 'v' : 'V', 'V' : 'V', '': 'V', 's' : 'S', 'S' : 'S', '': 'S', }
if !exists('g:airline_symbols') | let g:airline_symbols = {} | endif
let g:airline_symbols.dirty                        = ' ♪'
let g:airline_left_sep                             = ''
let g:airline_right_sep                            = ''
" +----------------------------------+
" | A | B | C            | X | Y | Z |
" +----------------------------------+
function! AirlineInit()
  let g:airline_section_a = airline#section#create([ '[', 'mode', ']' ])
  let g:airline_section_y = airline#section#create([ '%{strftime("%H:%M %b-%d %a")} ', '['.&ff.']' ])
  let g:airline_section_c = '%<' . airline#section#create([ '%F' ]) " let g:airline_section_c = '%<' . '%{expand(%:p:~)}'
endfunction
autocmd User AirlineAfterInit call AirlineInit()
```

[![airline + ale](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-a6630a5b3866d9f0bfe718a9a186feb78aa5ea90%2Fvim-airline-ale-3.png?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-ale-3.png)

* tips
  * [remove section\_](https://stackoverflow.com/a/45150368/2940319)

    ```vim
    let g:airline_section_<x>         = ''                          " remove the filetype part
    let g:airline_skip_empty_sections = 1                           " remove separators for empty sections
    ```
  * setup short mode

    ```vim
    let g:airline_mode_map = { '__': '-', 'n' : 'N', 'i' : 'I', 'R' : 'R', 'c' : 'C', 'v' : 'V', 'V' : 'V', '': 'V', 's' : 'S', 'S' : 'S', '': 'S', }
    ```
  * unicode symbols

    > \[!NOTE|label:symbols]
    >
    > * [`:help airline`](https://github.com/vim-airline/vim-airline/blob/master/doc/airline.txt)
    >
    > > ```vim
    > > " powerline symbols
    > > let g:airline_left_sep          = ''     " U+E0B0
    > > let g:airline_left_alt_sep      = ''     " U+E0B1
    > > let g:airline_right_sep         = ''     " U+E0B2
    > > let g:airline_right_alt_sep     = ''     " U+E0B3
    > > let g:airline_symbols.branch    = ''     " U+E0A0
    > > let g:airline_symbols.colnr     = ' ℅:'   " U+2105 U+003A
    > > let g:airline_symbols.readonly  = ''     " U+E0A2
    > > let g:airline_symbols.linenr    = ' :'   " U+E0A1
    > > let g:airline_symbols.maxlinenr = '☰ '   " U+2630
    > > let g:airline_symbols.dirty     = '⚡'    " U+26A1
    > > ```
    > >
    > > ```vim
    > > " old vim-powerline symbols
    > > let g:airline_left_sep          = '⮀'     " U+2B80
    > > let g:airline_left_alt_sep      = '⮁'     " U+2B81
    > > let g:airline_right_sep         = '⮂'     " U+2B82
    > > let g:airline_right_alt_sep     = '⮃'     " U+2B83
    > > let g:airline_symbols.branch    = '⭠'     " U+2B60
    > > let g:airline_symbols.readonly  = '⭤'     " U+2B64
    > > let g:airline_symbols.linenr    = '⭡'     " U+2B61
    > > ```
    > >
    > > ```vim
    > > " unicode symbols
    > > let g:airline_left_sep           = '»'    " U+00BB
    > > let g:airline_left_sep           = '▶'    " U+25B6
    > > let g:airline_right_sep          = '«'    " U+00AB
    > > let g:airline_right_sep          = '◀'    " U+25C0
    > > let g:airline_symbols.colnr      = ' ㏇:' " U+33C7
    > > let g:airline_symbols.colnr      = ' ℅:'  " U+2105
    > > let g:airline_symbols.crypt      = '🔒'   " U+0001F512
    > > let g:airline_symbols.linenr     = '☰'   " U+2630
    > > let g:airline_symbols.linenr     = ' ␊:'  " U+240A
    > > let g:airline_symbols.linenr     = ' ␤:'  " U+2424
    > > let g:airline_symbols.linenr     = '¶'    " U+00B6
    > > let g:airline_symbols.maxlinenr  = ''
    > > let g:airline_symbols.maxlinenr  = '㏑'   " U+33D1
    > > let g:airline_symbols.branch     = '⎇'    " U+2387
    > > let g:airline_symbols.paste      = 'ρ'    " U+03C1
    > > let g:airline_symbols.paste      = 'Þ'    " U+00DE
    > > let g:airline_symbols.paste      = '∥'    " U+2225
    > > let g:airline_symbols.spell      = 'Ꞩ'    " U+A7A8
    > > let g:airline_symbols.notexists  = 'Ɇ'    " U+0246
    > > let g:airline_symbols.notexists  = '∄'    " U+2204
    > > let g:airline_symbols.whitespace = 'Ξ'    " U+039E
    > > ```
    >
    > * [`:help airline-customization`](https://vi.stackexchange.com/a/3363/7389)
    >
    > > ```vim
    > > " unicode symbols
    > > let g:airline_left_sep           = '»'    " U+00BB
    > > let g:airline_left_sep           = '▶'    " U+25B6
    > > let g:airline_right_sep          = '«'    " U+00AB
    > > let g:airline_right_sep          = '◀'    " U+25C0
    > > let g:airline_symbols.linenr     = '␊'    " U+240A
    > > let g:airline_symbols.linenr     = '␤'    " U+2424
    > > let g:airline_symbols.linenr     = '¶'    " U+00B6
    > > let g:airline_symbols.branch     = '⎇''   " U+2387
    > > let g:airline_symbols.paste      = 'ρ'    " U+03C1
    > > let g:airline_symbols.paste      = 'Þ'    " U+00DE
    > > let g:airline_symbols.paste      = '∥'    " U+2225
    > > let g:airline_symbols.whitespace = 'Ξ'    " U+039E
    > > ```

    ```vim
    let g:airline_symbols.branch         = '⎇'                   " ╮
    let g:airline_symbols.paste          = 'ρ'                    " ├ unicode symbols
    let g:airline_symbols.dirty          = ' ↯'                   " ╯
    ```
  * [get theme randomly](https://github.com/vim-airline/vim-airline-themes/issues/170#issuecomment-476524390)

    > \[!NOTE]
    >
    > * [#2145 : Align section C to the left when overflowed](https://github.com/vim-airline/vim-airline/issues/2145#issuecomment-673640814)

    ```vim
    let g:airline_theme                  = 'random'
    ```

**sections**

> \[!NOTE|label:references:]
>
> * [#696 : Accents may cause status line exceed width](https://github.com/vim-airline/vim-airline/issues/696#issuecomment-75034875)

```vim
let g:airline_section_x                          = "%-{strftime(\"%H:%M\ %d/%m/%y\")} %1*--%n%%--%*"
let g:airline_section_y                          = "%{&fenc}%{&bomb ? '[bom]' : ''}%{strlen(&ff) > 0 ? '['.&ff.']' : ''}"
let g:airline#parts#ffenc#skip_expected_string   ='utf-8[unix]'
let g:airline_section_c_only_filename            = 0

function! AirlineInit()
  " NORMAL  docs/vim/
  let g:airline_section_a = airline#section#create([ 'mode', '  ', '%{join( split(getcwd(), "/")[-2:-1], "/" )}', '/' ])
  " NORMAL  docs/vim/plugins.md
  let g:airline_section_a = airline#section#create([ 'mode', '  ', '%{join( split(expand("%:p"), "/")[-3:-1], "/" )}' ])
  let g:airline_section_y = airline#section#create(['%{strftime("%H:%M %b-%d %a")} ', '['.&ff.']'])
  let g:airline_section_c = '%<' . airline#section#create(['%{expand("%:p:~")}'])
endfunction
autocmd User AirlineAfterInit call AirlineInit()
```

* section\_a

  > \[!NOTE|label:paths:]
  >
  > * show relative path `%F` : `let g:airline_section_c = airline#section#create([ '%F' ])` -> `~/.vimrc`
  > * show filename only `%f` : `let g:airline_section_c = airline#section#create([ '%f' ])` -> `.vimrc`

  [![section\_a with default mode](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-996d76a3d78a0e0b51c8b261c4932b7e88bca44e%2Fvim-airline-section_a-default.png?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-section_a-default.png)

  [![section\_a with short mode](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-0bb85137407fa25f826bdd8ed7b4f53c6a78dfc3%2Fvim-airline-section_a-short.png?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-section_a-short.png)

  * via function

    ```vim
    function! ShortPath()
      let pathlist=split(expand("%:p:~"), "/")
      return len(pathlist) < 3 ? join( pathlist[-2:-1], "/" ) : join( pathlist[-3:-1], "/" )
    endfunction
    " or"
    function! ShortPath()
      let pathlist=split(expand("%:p:~"), "/")
      if len(pathlist) < 3 | let final_result=join( pathlist[-2:-1], "/" ) | else | let final_result=join( pathlist[-3:-1], "/" ) | endif
      return final_result
    endfunction

    let g:airline_section_a = airline#section#create([ 'mode', '  ', ShortPath() ])
    ```

    * i.e.:

      ```vim
      function! ShortPath()
        let pathlist=split(expand("%:p:~"), "/")
        return len(pathlist) < 3 ? join( pathlist[-2:-1], "/" ) : join( pathlist[-3:-1], "/" )
      endfunction
      function! AirlineInit()
        let g:airline_section_a = airline#section#create([ '[', 'mode', ']', '  ', '%{&fenc}', '  ', ShortPath() ])
        let g:airline_section_y = airline#section#create([ '%{strftime("%H:%M %b-%d %a")} ', '['.&ff.']' ])
        let g:airline_section_c = '%<' . airline#section#create([ '%F' ]) " let g:airline_section_c = '%<' . '%{expand(%:p:~)}'
      endfunction
      autocmd User AirlineAfterInit call AirlineInit()
      ```

      [![airline section\_a shortpath](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-89f15c9a85c1c08c1182edeadec3c21aef488b29%2Fvim-airline-section_a-shortpath-1.png?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-section_a-shortpath-1.png)
  * via `%{}`

    ```vim
    function! AirlineInit()
      let pathlist=split( expand("%:p:~"), "/" )
      let g:airline_section_a = airline#section#create([ 'mode', '  ', '%{len(pathlist) < 3 ? join( pathlist[-2:-1], "/" ) : join( pathlist[-3:-1], "/" )}'])
    endfunction
    autocmd User AirlineAfterInit call AirlineInit()
    ```

    [![airline section\_a shortpath with '%{}'](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-1ac0dbf151698f85a05fa2fb9379a05b1dfa7522%2Fvim-airline-section_a-shortpath-2.png?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-section_a-shortpath-2.png)
* sections with length limitation
  * `%<'`: `let g:airline_section_c = '%<' . airline#section#create(['%{expand("%:p:~")}'])`
  * [`%-0.xx{}`](https://github.com/vim-airline/vim-airline/issues/1485#issuecomment-309734370) : `let g:airline_section_c = '%<' . '%-0.13{expand("%:p:~")}'`
  * i.e.:

    ```vim
    let g:airline_section_c = '%<' . '%-0.20{expand("%:p:~")}'
    " <docs/vim/plugins.md

    let g:airline_section_c = '%<' . '%{expand("%:p:~")}'
    " ~/path/to/ibook/docs/vim/plugins.md

    let g:airline_section_c = airline#section#create(['%F'])
    " ~/path/to/book/docs/vim/plugins.md
    ```

**themes**

> * [n-st/vim-airline-screenshots](https://github.com/n-st/vim-airline-screenshots)
> * [\* Change the vim-airline theme](https://github.com/vim-airline/vim-airline/wiki/Screenshots)
>   * `:AirlineTheme random` : `let g:airline_theme='random'` : `:echo g:airline_theme` [![pick up theme](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-5e5224e5e7b1ca6813ef5e12c4f3e4d39bdb4236%2Fvim-AirlineTheme-random.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-AirlineTheme-random.gif)
>   * [tomorrow](https://github.com/vim-airline/vim-airline/wiki/Screenshots#tomorrow-1)
>   * [distinguished](https://github.com/vim-airline/vim-airline/wiki/Screenshots#distinguished)
>   * [base16](https://github.com/vim-airline/vim-airline/wiki/Screenshots#base16)
>   * [angr](https://github.com/vim-airline/vim-airline/wiki/Screenshots#angr)
>   * [zenburn](https://github.com/vim-airline/vim-airline/wiki/Screenshots#zenburn)
>   * [zenburn](https://github.com/vim-airline/vim-airline/wiki/Screenshots#zenburn)
>   * [wombat](https://github.com/vim-airline/vim-airline/wiki/Screenshots#wombat)

* great themes
  \*
  * base16\_embers [![base16\_embers](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-425b0458ff54a11ec18a76f12eb730305059d2d8%2Fvim-airline-base16_embers_2.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-base16_embers_2.gif)
  * * base16 [![base16](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-80fbaa6c541da225ef2e731f610e4254395540a9%2Fvim-airline-base16.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-base16.gif)
  * * apprentice [![apprentice](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-a47fbdf2dcdc5ff388fed054f73c297f3a1a33b3%2Fvim-airline-apprentice.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-apprentice.gif)
  * * gruvbox [![gruvbox](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-2c09f943426b54e71e9fe6f411da654d739150d3%2Fvim-airline-gruvbox.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-gruvbox.gif)
  * * zenburn [![zenburn](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-af7b4e0dbd734314756413b67101813e3e40cc80%2Fvim-airline-zenburn.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-airline-zenburn.gif)
  * angr
  * selenized/selenized\_bw
  * biogoo
  * base16\_default
  * base16color
  * base16\_chalk
  * base16\_bright
  * biogoo ( dark background in insert mode )
* nice themes
  * owo
  * hybrid
  * bubblegum
  * supernova
  * alduin
  * base16\_summerfruit
  * base16\_atelierseaside
  * raven ( no background color )
  * peaksea ( no background color change )

## programming

### [vim-syntastic/syntastic](https://github.com/vim-syntastic/syntastic)

> \[!NOTE|label:references:]
>
> * [#1577 : Unknown function: SyntasticStatuslineFlag](https://github.com/vim-syntastic/syntastic/issues/1577)
> * [In Editor Linting with Syntastic](https://medium.com/usevim/in-editor-linting-with-syntastic-6814122bdbec)
>
>   ```vim
>   :SyntasticInfo
>   ```

[![style warning](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-2f2bba24ca476ee58dfe22c66efbda3fe50d4834%2Fvim-syntastic-style-warning.png?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-syntastic-style-warning.png)

[![error](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-de2b14e7cef694f1c42d40adc5685bf4f58ce050%2Fvim-syntastic-error.png?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/vim-syntastic-error.png)

```vim
Plug 'vim-syntastic/syntastic'

" syntastic settings                                                " Plug 'vim-syntastic/syntastic'
set statusline+=%#warningmsg#
set statusline+=%{SyntasticStatuslineFlag()}
set statusline+=%*
let g:syntastic_always_populate_loc_list = 1
let g:syntastic_auto_loc_list            = 1
let g:syntastic_check_on_open            = 1
let g:syntastic_check_on_wq              = 0
let g:syntastic_loc_list_height          = 2
let g:syntastic_ignore_files             = ['\.py$']
let g:syntastic_html_tidy_ignore_errors  = [" proprietary attribute \"ng-"]
let g:syntastic_enable_signs             = 1
let g:syntastic_info_symbol              = 'ೲ'                      " ࠵ ϊ
let g:syntastic_error_symbol             = '✗'                      " ஓ ௐ ྾
let g:syntastic_warning_symbol           = '⍨'                      " ᓆ ᓍ
let g:syntastic_style_error_symbol       = '⍥'
let g:syntastic_style_warning_symbol     = 'ఠ'                      " ⍤ ൠ
highlight link SyntasticErrorSign        Error
highlight link SyntasticWarningSign      GruvboxYellow
highlight link SyntasticStyleErrorSign   GruvboxRedSign
highlight link SyntasticStyleWarningSign GruvboxPurpleSign
```

```vim
Bundle 'vim-syntastic/syntastic'

" configure syntastic syntax checking to check on open as well as save
set statusline+=%#warningmsg#
set statusline+=\ %{SyntasticStatuslineFlag()}                      " vim-syntastic/syntastic
set statusline+=\ %* |
let g:syntastic_always_populate_loc_list  = 1
let g:syntastic_auto_loc_list             = 1
let g:syntastic_check_on_open             = 1
let g:syntastic_check_on_wq               = 0
let g:syntastic_loc_list_height           = 2
let g:syntastic_ignore_files              = ['\.py$']
let g:syntastic_html_tidy_ignore_errors   = [" proprietary attribute \"ng-"]
```

```vim
" vim-syntastic/syntastic
" info: ࠵ ೲ; error: ஓ ௐ ྾; warning ᓆ ᓍ 𐘿; style_warning: ⍤ ൠ
set statusline+=%#warningmsg#
if has('unix')
  set statusline+=\ %{SyntasticStatuslineFlag()}
endif
set statusline+=\ %* |
let g:syntastic_always_populate_loc_list = 0                        " ╮ whether if open
let g:syntastic_auto_loc_list            = 0                        " ╯ diagnostics windows
let g:syntastic_check_on_open            = 1
let g:syntastic_check_on_wq              = 0
let g:syntastic_loc_list_height          = 2
let g:syntastic_ignore_files             = ['\.py$']
let g:syntastic_html_tidy_ignore_errors  = [" proprietary attribute \"ng-"]
let g:syntastic_enable_signs             = 1
let g:syntastic_info_symbol              = 'ϊ'
let g:syntastic_error_symbol             = '✗'
let g:syntastic_warning_symbol           = '⍨'
let g:syntastic_style_error_symbol       = '⍥'
let g:syntastic_style_warning_symbol     = 'ఠ'
let g:syntastic_dockerfile_checkers      = [ 'hadolint' ]
highlight link SyntasticErrorSign        Error
highlight link SyntasticWarningSign      GruvboxYellow
highlight link SyntasticStyleErrorSign   GruvboxRedSign
highlight link SyntasticStyleWarningSign GruvboxPurpleSign
```

### [coc.nvim](https://github.com/neoclide/coc.nvim)

> \[!TIP|label:references:]
>
> * [CocList 入坑指南](https://zhuanlan.zhihu.com/p/71846145) | [coc.nvim 插件体系 - 介绍](https://zhuanlan.zhihu.com/p/65524706)
> * [\* Language servers](https://github.com/neoclide/coc.nvim/wiki/Language-servers)
> * [NeoVim for Java Development (COC)](https://javadev.org/devtools/ide/neovim/coc/)
> * [dansomething/coc-groovy](https://github.com/dansomething/coc-groovy)
> * [Manage coc extensions](https://github.com/neoclide/coc.nvim/wiki/Using-coc-extensions#manage-coc-extensions)
> * [nicknisi/dotfiles/config/nvim/coc-settings.json](https://github.com/nicknisi/dotfiles/blob/master/config/nvim/coc-settings.json)
> * [YongJieYongJie/dotfiles/coc-settings.json](https://github.com/YongJieYongJie/dotfiles/blob/master/coc-settings.json)
> * [Ways to configure Coc (Neoclide / coc.nvim)](https://www.reddit.com/r/vim/comments/ip6vpf/ways_to_configure_coc_neoclide_cocnvim/)
> * [\* coc-example-config.vim](https://github.com/neoclide/coc.nvim/blob/master/doc/coc-example-config.vim)

* initialize

  ```bash
  $ pip install jedi
  ```

  ```vim
  " install
  Plug 'neoclide/coc.nvim', { 'branch': 'release' }

  " neoclide/coc.nvim
  set updatetime=300
  set signcolumn=yes
  let g:coc_global_extensions = [
    \   'coc-sh',
    \   'coc-groovy', 'coc-java',
    \   'coc-json',
    \   'coc-css', 'coc-htmlhint', 'coc-html-css-support',
    \   'coc-pyright',
    \   'coc-snippets',
    \   'coc-docker',
    \   'coc-emoji'
    \ ]
  function! CheckBackspace() abort
    let col = col('.') - 1
    return !col || getline('.')[col - 1]  =~# '\s'
  endfunction
  function! ShowDocumentation()
    if CocAction('hasProvider', 'hover')
      call CocActionAsync('doHover')
    else
      call feedkeys('K', 'in')
    endif
  endfunction
  autocmd FileType json syntax match Comment +\/\/.\+$+
  autocmd FileType html let b:coc_root_patterns = ['.git', '.env', 'tailwind.config.js', 'tailwind.config.cjs']
  inoremap <silent><expr> <DOWN>
        \ coc#pum#visible() ? coc#pum#next(1) : CheckBackspace()
        \                   ? "\<DOWN>" : coc#refresh()
  inoremap <expr><UP> coc#pum#visible() ? coc#pum#prev(1) : "\<C-h>"
  inoremap <silent><expr> <C-M>
       \ coc#pum#visible() ? coc#pum#confirm() : "\<C-g>u\<CR>\<c-r>=coc#on_enter()\<CR>"
  command! -nargs=0 OR  :call CocActionAsync('runCommand', 'editor.action.organizeImport')
  nmap     <silent>[g   <Plug>(coc-diagnostic-prev)
  nmap     <silent>]g   <Plug>(coc-diagnostic-next)
  nmap     <silent>gd   <Plug>(coc-definition)
  nmap     <silent>gy   <Plug>(coc-type-definition)
  nmap     <silent>gi   <Plug>(coc-implementation)
  nmap     <silent>gr   <Plug>(coc-references)
  nnoremap <silent>K    :call ShowDocumentation()<CR>
  nmap     <leader>cl   <Plug>(coc-codelens-action)
  " coc-snippets ( ctrl-j )
  imap <C-l> <Plug>(coc-snippets-expand)
  vmap <C-j> <Plug>(coc-snippets-select)
  let g:coc_snippet_next = '<c-j>'
  let g:coc_snippet_prev = '<c-k>'
  imap <C-j> <Plug>(coc-snippets-expand-jump)
  inoremap <silent><expr> <C-j>
        \ pumvisible() ? coc#_select_confirm() :
        \ coc#expandableOrJumpable() ? "\<C-r>=coc#rpc#request('doKeymap', ['snippets-expand-jump',''])\<CR>" :
        \ CheckBackSpace() ? "\<TAB>" :
        \ coc#refresh()
  function! CheckBackSpace() abort
    let col = col('.') - 1
    return !col || getline('.')[col - 1]  =~# '\s'
  endfunction
  ```
* open configure file ( `coc-settings.json` )

  > \[!NOTE|label:references:]
  >
  > * [Using the configuration file](https://github.com/neoclide/coc.nvim/wiki/Using-the-configuration-file)

  ```vim
  :CocConfig
  ```

  * setup sources priority

    > \[!NOTE|label:references:]
    >
    > * [#964 - Configuring priority of completion sources doesn't work](https://github.com/neoclide/coc.nvim/issues/964)
    > * [#2063 - Limit Number of Autocomplete Suggestions Displayed](https://github.com/neoclide/coc.nvim/issues/2063)
    >
    >   ```vim
    >   " coc-settings.json
    >   {
    >     "suggest.maxCompleteItemCount": 20
    >   }
    >
    >   " or vimrc
    >   :set pumheight=20
    >   ```

    ```yaml
    // coc-settings.json
    {
      "coc.source.around.priority": 85,
      "coc.source.file.priority": 80,
      "coc.source.buffer.priority": 70,
      "coc.source.word.priority": 1,
      "coc.source.dictionary.priority": 1,
    }
    ```

    ```vim
    " check sources priority
    :CocList sources
    * html-css-support       [HCS]                 99  html,markdown
    * emoji                  [T]        :          3   markdown
    * word                   [10K]                 1
    * dictionary             [D]                   1
    * tag                    [T]                   3
    * snippets               [S]                   90
    * snippets-source        [S]        $          90  snippets
    * around                 [A]                   85
    * buffer                 [B]                   70
    * file                   [F]        /          80
    * issues                 [[I]]      #          99  gitcommit,gina-commit
    * semantic-commit        [Commit]              99  gitcommit,gina-commit
    * vimlsp                 [LS]       .:#[&$<"'  99  vim
    ```
  * [language server setup](https://www.narga.net/how-to-set-up-code-completion-for-vim/)

    ```json
    {
        "languageserver": {
            "intelephense": {
                "command": "intelephense",
                "args": ["--stdio"],
                "filetypes": ["php"],
                "initializationOptions": {
                    "storagePath": "/tmp/intelephense"
                }
            }
        },
    }
    ```
  * sample for groovy

    > \[!TIP|label:references:]
    >
    > * [#17 unable to resolve base groovy classes](https://github.com/GroovyLanguageServer/groovy-language-server/issues/17)

    ```json
    {
      "langageserver": {
        "groovy": {
          "filetypes": ["groovy"],
          "module": "/Users/marslo/.config/coc/extensions/node_modules/coc-groovy/server/groovy-language-server-all.jar",
          "trace.server": "verbose",
          "settings": {
            "groovy": {
              "classpath": [
                "/opt/homebrew/opt/groovy/libexec/lib",
                "/opt/jenkins/latest/WEB-INF/lib",
                "/opt/jenkins/plugins/credentials/WEB-INF/lib",
                "./libs"
              ]
            }
          }
        }
      }
    }
    ```

    ```json
    {
      "languageserver": {
        "groovy": {
          "trace.server": "off",
          "command": "java",
          "args": [
            "-jar",
            "/path/to/groovy-language-server/build/libs/groovy-language-server-all.jar"
          ],
          "filetypes": ["groovy"],
          "settings": {
            "groovy": {
              "classpath": [
                "/path/to/.groovy/grapes/org.codehaus.groovy/groovy-sql/jars/groovy-sql-3.0.1.jar",
                "/path/to/.groovy/grapes/org.codehaus.groovy/groovy/jars/groovy-3.0.1.jar",
                "/path/to/libs",
                "./libs"
              ]
            }
          }
        }
      }
    }
    ```
* check information

  ```vim
  :CocInfo
  :checkhealth
  :CocOpenLog
  :CocCommand workspace.showOutput
  ```
* CocConfig:

  ```json
  {
    "codeLens.enable": true,
    "java.referencesCodeLens.enabled": true,
    "diagnostic.displayByAle": false,
    "diagnostic.errorSign": "✘",
    "diagnostic.infoSign": "ᓆ",
    "diagnostic.warningSign": "ᑹ",
    "diagnostic.hintSign": "➤",
    "diagnostic-languageserver.filetypes": {
      "yaml": [ "yamllint" ],
      "vim": "vint",
      "sh": "shellcheck"
    },
    "html-css-support.styleSheets": [
        "https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css",
        "/style.css",
        "style.css"
    ],
    "html-css-support.enabledLanguages": [ "html", "markdown" ],
    "coc.source.file.ignoreHidden": false,
    "snippets.userSnippetsDirectory": "~/.marslo/vimrc.d/snips"
  }
  ```

  * start completion from 2nd string

    ```json
    {
      "suggest.minTriggerInputLength": 2
    }
    ```

  ````

  - cause issue of trigger

    > [!TIP]
    > - support autoTrigger: `always`, `trigger`

    ```json
    {
      "suggest.autoTrigger": "trigger",
      "suggest.triggerCompletionWait": 50
    }
  ````

[![nvim coc copilot snippets](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-2b1051dfbc54d0d524ee8fdd87da506cd204a13f%2Fnvim-coc-copilot-snippets.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/nvim-coc-copilot-snippets.gif)

[![nvim coc lspconfig](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-4b324139b11a7d60c9b1a253d79f45ed131f6fcb%2Fnvim-treesitter-coc-lspconfig.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/nvim-treesitter-coc-lspconfig.gif)

* shortcuts

  ```vim
  " neoclide/coc.nvim
  nmap     <silent>[g    <Plug>(coc-diagnostic-prev)
  nmap     <silent>]g    <Plug>(coc-diagnostic-next)
  nmap     <silent>gd    <Plug>(coc-definition)
  nmap     <silent>gy    <Plug>(coc-type-definition)
  nmap     <silent>gi    <Plug>(coc-implementation)
  nmap     <silent>gr    <Plug>(coc-references)
  nmap     <leader>cl    <Plug>(coc-codelens-action)
  nnoremap <silent>K     :call ShowDocumentation()<CR>
  ```

  * `<Plug>(coc-diagnostic-prev)` : <kbd>\[</kbd> + <kbd>g</kbd> : previous diagnostic
  * `<Plug>(coc-diagnostic-next)` : <kbd>]</kbd> + <kbd>g</kbd> : next diagnostic
  * `<Plug>(coc-definition)` : <kbd>g</kbd> + <kbd>d</kbd> : go to definition
  * `<Plug>(coc-type-definition)` : <kbd>g</kbd> + <kbd>y</kbd> : type definition
  * `<Plug>(coc-implementation)` : <kbd>g</kbd> + <kbd>i</kbd> : implementation
  * `<Plug>(coc-references)` : <kbd>g</kbd> + <kbd>r</kbd> : references
  * `<Plug>(coc-codelens-action)` : <kbd>c</kbd> + <kbd>l</kbd> : code lens action
* troubleshooting

  > \[!NOTE|label:references:]
  >
  > * [#805 ALE diagnostic signs don't appear](https://github.com/neoclide/coc.nvim/issues/805)
  > * [#3402 Can coc vim display all message diagnostic in lines of code](https://github.com/neoclide/coc.nvim/issues/3402)
  > * [Debug language server](https://github.com/neoclide/coc.nvim/wiki/Debug-language-server#using-output-channel)

  ```bash
  $ rust-analyzer --help
  error: 'rust-analyzer' is not installed for the toolchain 'stable-x86_64-unknown-linux-gnu'

  $ rustup component add rust-analyzer
  ```

#### [coc-snippets](https://github.com/neoclide/coc-snippets)

> \[!NOTE|label:references:]
>
> * [Configure snippets workflow](https://github.com/neoclide/coc.nvim/wiki/Using-snippets#configure-snippets-workflow)
> * [Snippets with CoC](https://www.chiarulli.me/Neovim/17-snippets/)
> * [Coc.nvim completion and snippets are conflicting](https://www.reddit.com/r/neovim/comments/yl5t0o/cocnvim_completion_and_snippets_are_conflicting/)
> * ultisnips:
>   * [ultisnips/doc/UltiSnips.txt](https://github.com/SirVer/ultisnips/blob/master/doc/UltiSnips.txt)
>   * [UltiSnips Screencast Episode 1](https://www.sirver.net/blog/2011/12/30/first-episode-of-ultisnips-screencast/)
>   * [UltiSnips Screencast Episode 2](https://www.sirver.net/blog/2012/01/08/second-episode-of-ultisnips-screencast/)
>   * [UltiSnips 2.0 and Screencast Episode 3](https://www.sirver.net/blog/2012/02/05/third-episode-of-ultisnips-screencast/)
>   * [UltiSnips Screencast Episode 4](https://www.sirver.net/blog/2012/03/31/fourth-episode-of-ultisnips-screencast/)

[![coc-snippets](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-b13fb39e12b7b7e790dc3bb6e67f08e0b5debef9%2Fnvim-coc-snippet.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/nvim-coc-snippet.gif)

> \[!TIP|label:default snippets]
>
> ```bash
> $ fd all.snippets ~/.config/nvim ~/.vim ~/.local/share/nvim
> /Users/marslo/.vim/plugged/vim-snippets/UltiSnips/all.snippets
> /Users/marslo/.vim/plugged/vim-snippets/snippets/all.snippets
> ```

| OPTIONS | DESCRIPTION                                           |
| :-----: | ----------------------------------------------------- |
|   `b`   | beginning of line                                     |
|   `i`   | In-word explansion                                    |
|   `w`   | Word boundary                                         |
|   `r`   | Regular Expression                                    |
|   `t`   | Do NOT expand tabs                                    |
|   `s`   | Remove Whitespace immediately before the cursor       |
|   `t`   | Trim all whitespaces from right side of snippet lines |
|   `c`   | Custom context snippet                                |
|   `A`   | Snippet will be triggered automatically               |

```vim
" ~/.vimrc.d/extension
Plug 'neoclide/coc.nvim', { 'branch': 'release' }
Plug 'honza/vim-snippets'
let g:coc_global_extensions = [ 'coc-snippets' ]

" coc-snippets ( ctrl-j )
imap <C-l> <Plug>(coc-snippets-expand)
vmap <C-j> <Plug>(coc-snippets-select)
let g:coc_snippet_next = '<c-j>'
let g:coc_snippet_prev = '<c-k>'
imap <C-j> <Plug>(coc-snippets-expand-jump)
inoremap <silent><expr> <C-j>
      \ pumvisible() ? coc#_select_confirm() :
      \ coc#expandableOrJumpable() ? "\<C-r>=coc#rpc#request('doKeymap', ['snippets-expand-jump',''])\<CR>" :
      \ CheckBackSpace() ? "\<TAB>" :
      \ coc#refresh()
function! CheckBackSpace() abort
  let col = col('.') - 1
  return !col || getline('.')[col - 1]  =~# '\s'
endfunction
```

```vim
" ~/.vimrc.d/hightlight
" coc-snippet
highlight! link snipLeadingSpaces snipComment
```

**snippets**

```
snippet "mode(line)?( (\S+))?" "vim modeline" br
${1:#} vim`!v ':set '. (&expandtab ? printf('expandtab shiftwidth=%i tabstop=%i softtabstop=%i', &sw, &ts, &sts) : printf('noexpandtab:sts=%i:sw=%i:ts=%i', &sts, &sw, &ts)) . (&tw ? ':tw='. &tw : '') . (':filetype=')`${2:`!p
snip.rv = match.group(3) if match.group(2) is not None else "sh"`}:
endsnippet

snippet "be(gin)?( (\S+))?" "begin{} / end{}" br
\begin{${1:`!p
snip.rv = match.group(3) if match.group(2) is not None else "something"`}}
  ${2:${VISUAL}}
\end{$1}$0
endsnippet

snippet wow
${1:Text}`!p snip.rv = (75-2*len(t[1]))*' '+t[1].upper()`
endsnippet

snippet case
case ${1:word} in
  ${2:pattern} ) $0;;
esac
endsnippet

snippet query
Your age: ${1|<18,18~60,>60|}
Your height: ${2|<120cm,120cm~180cm,>180cm|}
endsnippet
```

**commands**

```vim
:CocList snippets
:CocCommand snippets.openSnippetFiles
:CocCommand snippets.editSnippets
:CocCommand snippets.openOutput

:CocCommand workspace.showOutput snippets
[Info  - 04:10:41.632] Using ultisnips directories:
[
  "UltiSnips",
  "/Users/marslo/.marslo/vimrc.d/snips"
]
[Info  - 04:10:41.663] Loading textmate snippets from filetypes: jenkinsfile
[Info  - 04:10:41.666] Loaded 23 _ snipmate snippets from: /Users/marslo/.vim/plugged/vim-snippets/snippets/_.snippets
[Info  - 04:10:41.666] Loaded 9 UltiSnip snippets from: /Users/marslo/.marslo/vimrc.d/snips/all.snippets
[Info  - 04:10:41.667] Loaded 14 UltiSnip snippets from: /Users/marslo/.vim/plugged/vim-snippets/UltiSnips/all.snippets
[Info  - 04:10:41.667] Execute python file /var/folders/8g/68t3rg090jd2tpqjcwm9vskh0000gq/T/nvim.marslo/HFc9S7/coc-snippets-7398faf046499cfcea484a37fe5c9294.py from: /Users/marslo/.vim/plugged/vim-snippets/UltiSnips/all.snippets
```

#### [coc-word](https://github.com/neoclide/coc-sources)

> \[!NOTE|label:references:]
>
> * [#1183 - Enable or disable coc extensions per language](https://github.com/neoclide/coc.nvim/issues/1183)

```vim
" via command
:CocInstall coc-word

" or .vimrc
let g:coc_global_extensions = [ 'coc-word' ]
```

```json
"coc.source.word.filetypes": [ "text", "markdown" , "python" ],
```

#### extensions management

> \[!NOTE|label:references:]
>
> * [Implemented coc extensions](https://github.com/neoclide/coc.nvim/wiki/Using-coc-extensions#implemented-coc-extensions)
>   * [yuki-yano/fzf-preview.vim](https://github.com/yuki-yano/fzf-preview.vim)
>   * [neoclide/coc-highlight](https://github.com/neoclide/coc-highlight)
>   * [yaegassy/coc-pylsp](https://github.com/yaegassy/coc-pylsp) | [fannheyward/coc-pyright](https://github.com/fannheyward/coc-pyright) | [yaegassy/coc-pydocstring](https://github.com/yaegassy/coc-pydocstring) | [neoclide/coc-python](https://github.com/neoclide/coc-python)
>   * [xiyaowong/coc-symbol-line](https://github.com/xiyaowong/coc-symbol-line)
>   * [neoclide/coc-pairs](https://github.com/neoclide/coc-pairs)

* list all installed

  ```vim
  :CocList extensions

  $ ls ~/.config/coc/extensions/node_modules
  coc-css     coc-emoji   coc-html-css-support  coc-java  coc-omni     coc-sh        coc-tag
  coc-docker  coc-groovy  coc-htmlhint          coc-json  coc-pyright  coc-snippets
  ```
* show stauts

  > \[!TIP|label:references:]
  >
  > * [`TabMessage`](https://imarslo.gitbook.io/handbook/viml#tabmessage)

  ```vim
  :echo CocAction('extensionStats')
  :TabMessage echo CocAction('extensionStats')
  ```
* add/remove execute:

  ```bash
  :CocInstall coc-sh coc-groovy coc-json coc-css coc-pyright coc-snippets coc-emoji coc-omni coc-tag coc-htmlhint coc-html-css-support coc-docker
  :CocInstall @yaegassy/coc-tailwindcss3
  :CocUninstall coc-git
  ```
* or

  ```bash
  $ nvim -c 'CocInstall -sync coc-groovy \
                              coc-java \
                              coc-css \
                              coc-pyright \
                              coc-snippet \
                              coc-emoji \
                              coc-tag \
                              coc-docker\
                              coc-htmlhint\
                              coc-html-css-support \
                              coc-sh \
                              coc-omni|q'
  ```
* [using custom registry](https://github.com/neoclide/coc.nvim/wiki/Using-coc-extensions#using-custom-registry)

  ```bash
  $ cat ~/.npmrc
  coc.nvim:registry=https://registry.npmjs.org/
  ```
* [update extensions](https://github.com/neoclide/coc.nvim/wiki/Using-coc-extensions#update-extensions)

  ```vim
  :CocUpdate
  :CocUpdateSync
  ```

  ```bash
  # or
  $ vim -c 'CocUpdateSync|q'
  ```

### [nvim-treesitter/nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter)

> \[!NOTE]
>
> * if install from standalone package, `tree-sitter` required
>   * osx: `$ brew install tree-sitter`
> * [Vim/Neovim 代码高亮插件 -- nvim-treesitter](https://zhuanlan.zhihu.com/p/609164334)
> * [#1097 tree-sitter executable not found](https://github.com/nvim-treesitter/nvim-treesitter/issues/1097)
> * [Tree-sitter CLI](https://github.com/tree-sitter/tree-sitter/blob/master/cli/README.md)

[![nvim-treesitter](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-5a30e0f8ce19f933cf23a5e10897bfbadf731b39%2Fnvim-treesitter.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/nvim-treesitter.gif)

```bash
# tree-sitter executable not found
$ cargo install tree-sitter-cli
# or
$ sudo npm i -g tree-sitter-cli
# or
$ brew install tree-sitter

$ which -a tree-sitter
~/.cargo/bin/tree-sitter
# macos
$ which -a tree-sitter
/usr/local/bin/tree-sitter
```

* others

  ```bash
  $ pip3 install tree_sitter
  ```
* configure

  ```vim
  Plug 'nvim-treesitter/nvim-treesitter', { 'do': ':TSUpdate' }
  ```

  ```lua
  -- ~/.config/nvim/init.vim
  require('config/nvim-treesitter')

  -- ~/.config/nvim/lua/config/nvim-treesitter.lua
  require'nvim-treesitter.configs'.setup {
    ensure_installed = { "c", "lua", "vim", "vimdoc", "query", "python", "bash", "groovy", "java", "yaml", "xml", "cmake", "css", "dockerfile", "git_config", "gitcommit", "gitignore", "jq", "json", "markdown", "ssh_config", "vimdoc", "ini" },
    sync_install = true,
    -- install automatically
    auto_install = true,
    ignore_install = { "javascript" },
    indent = {
      enable = true,
      disable = { "markdown" },
    },
    incremental_selection = {
      enable = true,
      keymaps = {
        init_selection = "<CR>",
        node_incremental = "<CR>",
        node_decremental = "<BS>",
        scope_incremental = "<TAB>",
      },
    },
    highlight = {
      enable = true,
      disable = { "markdown" },
      additional_vim_regex_highlighting = false,
    },
  }
  require("nvim-treesitter.install").prefer_git = true
  ```
* install manually

  ```vim
  :TSInstall bash css gitcommit git_config gpg html java jq lua python xml yaml
  ```
* commands

  ```vim
  :TSBufToggle highlight
  :TSInstallInfo
  :TSModuleInfo
  :checkhealth nvim-treesitter
  :echo nvim_get_runtime_file('*/lua.so', v:true)
  ['/Users/marslo/.vim/plugged/nvim-treesitter/parser/lua.so', '/usr/local/Cellar/neovim/0.9.5/lib/nvim/parser/lua.so']
  ```

### [github/copilot.vim](https://github.com/github/copilot.vim)

> \[!NOTE|label:references:]
>
> * [Getting started with GitHub Copilot](https://docs.github.com/en/copilot/using-github-copilot/getting-started-with-github-copilot?tool=vimneovim)
> * [Installing the GitHub Copilot extension in Vim/Neovim on macOS](https://docs.github.com/en/copilot/using-github-copilot/getting-started-with-github-copilot?tool=vimneovim#prerequisites-3)
> * [Managing billing for GitHub Copilot](https://docs.github.com/en/billing/managing-billing-for-github-copilot)
> * [GitHub CoPilot self-signed certificate error in Intellij](https://sidd.io/2023/01/github-copilot-self-signed-cert-issue/)
> * [\* Using Github Copilot with Vim](https://ovid.github.io/articles/using-github-copilot-with-vim.html)
> * [\* Cautiously Configuring Copilot](https://code.kiwi.com/articles/cautiously-configuring-copilot/)
> * [\* Configuring GitHub Copilot in your environment](https://docs.github.com/en/copilot/configuring-github-copilot/configuring-github-copilot-in-your-environment?tool=vimneovim)
> * [GitHub Copilot FAQs + Troubleshooting common issues](https://github.com/orgs/community/discussions/47318)
> * [MariaSolOs/dotfiles - copilot.lua](https://github.com/MariaSolOs/dotfiles/blob/e9eb1f8e027840f872e69e00e082e2be10237499/.config/nvim/lua/plugins/copilot.lua)

[![nvim copilot](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-a1b63004d99a8dc151f0382cf008842a67e0a1c3%2Fnvim-copilot.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/nvim-copilot.gif)

* setup

  ```vim
  Plug 'github/copilot.vim'

  " github/copilot.vim
  let g:copilot_proxy            = 'http://proxy.sample.com:8080'
  let g:copilot_proxy_strict_ssl = v:false
  let g:copilot_filetypes        = {
      \ '*': v:false,
      \ 'gitcommit': v:true,
      \ 'markdown': v:true,
      \ 'yaml': v:true,
      \ 'groovy': v:true,
      \ 'python': v:true,
      \ 'Jenkinsfile': v:true,
      \ 'sh': v:true
      \ }
  " disable for extra large file
  autocmd BufReadPre *
      \ let f=getfsize(expand("<afile>"))
      \ | if f > 100000 || f == -2
      \ |   let b:copilot_enabled = v:false
      \ | endif
  " invpaste -> paste in insert/normal/visual mode
  noremap <leader>pp :set invpaste<cr>
  map <silent> <F2>  :Copilot disable<CR>
  ```

  ```vim
  :Copilot setup

  " check status
  :Copilot status
  Copilot: Ready
  " or
  Copilot: Disabled for filetype=c by g:copilot_filetypes

  :Copilot log
  :resize -5
  " or
  :autocmd BufWinEnter * if bufname('%') ==# 'copilot:///log' | resize -5 | endif
  " or
  autocmd BufWinEnter copilot:///log execute 'resize -5'
  " or
  autocmd BufWinEnter copilot:///log call timer_start(50, {-> execute('resize -5')})

  :Copilot panel
  ```
* config

  > \[!NOTE|label:references:]
  >
  > * copilot enable/disable for filetypes:
  >   * [vimrc solution](https://github.com/orgs/community/discussions/29977#discussioncomment-3451927)
  >   * [init.lua solution](https://github.com/orgs/community/discussions/38074#discussioncomment-8430826)

  ```vim
  let g:copilot_proxy = '192.168.100.1:8080'
  let g:copilot_proxy_strict_ssl = v:false
  ```
* shortcuts
  * `copilot#Accept("\<CR>")` : <kbd>Tab</kbd> : accept suggestion

    ```vim
    " to re-mapping
    imap <silent><script><expr> <C-J> copilot#Accept("\<CR>")
    let g:copilot_no_tab_map = v:true
    ```
  * `<Plug>(copilot-accept-word)` : <kbd>Meta/Alt</kbd> + <kbd>⇢</kbd>: accept the next word of the current suggestion

    ```vim
    " to re-mapping
    imap <C-L>   <Plug>(copilot-accept-word)
    ```
  * `<Plug>(copilot-accept-line)` : <kbd>Meta/Alt</kbd> + <kbd>Ctrl</kbd> + <kbd>⇢</kbd> : accept the next line of the current suggestion

    ```vim
    " to re-mapping
    imap <C-M-L> <Plug>(copilot-accept-line)
    ```
  * `<Plug>(copilot-next)` : <kbd>Meta/Alt</kbd> + <kbd>]</kbd> : next suggestion
  * `<Plug>(copilot-previous)` : <kbd>Meta/Alt</kbd> + <kbd>\[</kbd> : previous suggestion
  * `<Plug>(copilot-dismiss)` : <kbd>Control/Ctrl</kbd> + <kbd>]</kbd> : dismiss the current suggestion.
  * `<Plug>(copilot-suggest)` : <kbd>Meta/Alt</kbd> + <kbd>\</kbd>> : explicitly request a suggestion, even if Copilot is disabled</kbd>
* self-signed certificate error

  > \[!NOTE|label:references:]
  >
  > * [IntelliJ IDEA and Github Copilot: not working due to self signed certificate](https://stackoverflow.com/a/75247385/2940319)
  > * [SSL Converter](https://www.sslshopper.com/ssl-converter.html)
  > * [\* Installing custom certificates](https://docs.github.com/en/copilot/configuring-github-copilot/configuring-network-settings-for-github-copilot#installing-custom-certificates)
  >   * [Add certificates to a keychain using Keychain Access on Mac](https://support.apple.com/en-gb/guide/keychain-access/kyca2431/mac)
  >   * [Installing a root CA certificate in the trust store](https://ubuntu.com/server/docs/security-trust-store)
  >   * [Installing the trusted root certificate in windows](https://learn.microsoft.com/en-us/skype-sdk/sdn/articles/installing-the-trusted-root-certificate)
  > * [\* iMarslo: convert and import windows certs into linux](https://imarslo.gitbook.io/handbook/good/ssl/server#convert-from-windows-certmgrmsc)

  ```vim
  $ openssl x509 -inform der -in <exported_cert>.cer -out mycert.pem
  $ export NODE_EXTRA_CA_CERTS="/path/to/mycert.pem"

  # or
  $ keytool -import -storepass changeit -keystore PATH_TO_YOUR_INTELLIJ_JRE/lib/security/cacerts -file PATH_TO_YOUR_CUSTOM_ROOTCA.pem
  ```
* [vscode](https://stackoverflow.com/a/55191955/2940319)

  ```json
  // settings.json
  {
    "http.proxyStrictSSL": false,
    "http.proxy": "http://proxy.sample.com:8080",
  }
  ```

#### [CopilotChat.nvim](https://copilotc-nvim.github.io/CopilotChat.nvim/)

> \[!NOTE|label:references:]
>
> * [CopilotC-Nvim/CopilotChat.nvim](https://github.com/CopilotC-Nvim/CopilotChat.nvim)
> * [deathbeam/dotfiles - copilot.lua](https://github.com/deathbeam/dotfiles/blob/master/nvim/.config/nvim/lua/config/copilot.lua)

```vim
" install
Plug 'CopilotC-Nvim/CopilotChat.nvim' , { 'branch': 'canary' }      " ╮
Plug 'zbirenbaum/copilot.lua'                                       " ├ copilot chat
Plug 'nvim-lua/plenary.nvim'                                        " ╯
```

```lua
-- ~/.config/nvim/init.vim
require("CopilotChat").setup {
  debug = true,
  allow_insecure = true,
  show_folds = false,
}
```

#### troubleshooting

* No GitHub token found in WSL
  * error message

    ```bash
    No GitHub token found, please use `:Copilot setup` to set it up from copilot.vim or copilot.lua
    ```
  * error log

    ```bash
    [CopilotChat.nvim] [ERROR 23:59:58] /home/marslo/.vim/plugged/CopilotChat.nvim/lua/CopilotChat/copilot.lua:275: No GitHub token found, please use `:Copilot setup` to set it up from copilot.vim or copilot.lua
    ```
  * solution

    ```bash
    $ user="$(jq -c -r 'to_entries[].value.user' < ~/.config/github-copilot/apps.json)"
    $ token="$(jq -c -r 'to_entries[].value.oauth_token' < ~/.config/github-copilot/apps.json)"
    $ echo "{\"github.com\":{\"user\":\"${user}\",\"oauth_token\":\"${token}\"}}" > ~/.config/github-copilot/hosts.json
    ```
* \[ghostText] Error on ghost text request: FetchError: CA signature digest algorithm too weak
  * error log

    ```bash
    [2024-11-19 21:41:44] [INFO] [lsp] GitHub Copilot Language Server 1.236.0 initialized
    [2024-11-19 21:41:54] [INFO] [certificates] Removed 2 expired certificates
    [2024-11-19 21:41:54] [ERROR] [default] Error sending telemetry FetchError: CA signature digest algorithm too weak
        at fetch (/Users/marslo/.vim/plugged/copilot.vim/node_modules/@adobe/helix-fetch/src/fetch/index.js:99:11)
        at processTicksAndRejections (node:internal/process/task_queues:105:5)
        at cachingFetch (/Users/marslo/.vim/plugged/copilot.vim/node_modules/@adobe/helix-fetch/src/fetch/index.js:288:16)
        at Dge.fetch (/Users/marslo/.vim/plugged/copilot.vim/lib/src/network/helix.ts:93:22) {
      type: 'system',
      _name: 'FetchError',
      code: 'UNSPECIFIED',
      errno: undefined,
      erroredSysCall: undefined
    }
    [2024-11-19 21:41:56] [ERROR] [ghostText] Error on ghost text request: FetchError: CA signature digest algorithm too weak
        at fetch (/Users/marslo/.vim/plugged/copilot.vim/node_modules/@adobe/helix-fetch/src/fetch/index.js:99:11)
        at processTicksAndRejections (node:internal/process/task_queues:105:5)
        at cachingFetch (/Users/marslo/.vim/plugged/copilot.vim/node_modules/@adobe/helix-fetch/src/fetch/index.js:288:16)
        at Dge.fetch (/Users/marslo/.vim/plugged/copilot.vim/lib/src/network/helix.ts:93:22)
        at bte.fetchWithParameters (/Users/marslo/.vim/plugged/copilot.vim/lib/src/openai/fetch.ts:450:26)
        at bte.fetchAndStreamCompletions (/Users/marslo/.vim/plugged/copilot.vim/lib/src/openai/fetch.ts:353:26)
        at genericGetCompletionsFromNetwork (/Users/marslo/.vim/plugged/copilot.vim/lib/src/ghostText/ghostText.ts:149:21)
        at getGhostText (/Users/marslo/.vim/plugged/copilot.vim/lib/src/ghostText/ghostText.ts:698:23)
        at getGhostTextWithAbortHandling (/Users/marslo/.vim/plugged/copilot.vim/agent/src/methods/getCompletions.ts:313:16)
        at handleChecked (/Users/marslo/.vim/plugged/copilot.vim/agent/src/methods/inlineCompletion.ts:86:33) {
      type: 'system',
      _name: 'FetchError',
      code: 'UNSPECIFIED',
      errno: undefined,
      erroredSysCall: undefined
    }
    ```
  * solutin

### [tomtom/tcomment\_vim](https://github.com/tomtom/tcomment_vim)

```vim
Plug 'tomtom/tcomment_vim'

" tomtom/tcomment_vim
" g:tcomment_mapleader1 = ','
map  <leader>x gcc
vmap <leader>x <c-_>b
nmap <C-/>     gcc
imap <C-/>     <c-_><c-_>
vmap <C-/>     <c-_>b
```

### [dense-analysis/ale](https://github.com/dense-analysis/ale)

> \[!NOTE|label:references:]
>
> * [How do I disable "annotations" generated by ALE in vim?](https://www.reddit.com/r/vim/comments/151tiqz/how_do_i_disable_annotations_generated_by_ale_in/)
> * [How do i get rid of Ale errors on the line i am editing?](https://www.reddit.com/r/vim/comments/b9amj9/how_do_i_get_rid_of_ale_errors_on_the_line_i_am/)
> * [ale/supported-tools.md](https://github.com/dense-analysis/ale/blob/master/supported-tools.md)
> * [yamllint](https://yamllint.readthedocs.io/en/stable/configuration.html)
>   * [\* iMarslo: \~/.config/yamllint/config](https://github.com/marslo/dotfiles/blob/main/.config/yamllint/config)
>   * [\* iMarslo: yamllint.yaml](https://github.com/marslo/dotfiles/blob/main/.yamllint.yaml)

> \[!TIP] to reset the ale\_lsit\_window\_size via autocmd:
>
> > ```vim
> > augroup ALEResizeLocList
> >   autocmd!
> >   autocmd BufWinEnter * if &buftype ==# 'quickfix' && getloclist(0) != [] | execute "resize 2" | endif
> > augroup END
> > ```

```vim
" ~/.vimrc.d/extension
Plug 'stephpy/vim-yaml'                                             " ╮ yaml
Plug 'pedrohdz/vim-yaml-folds'                                      " ╯
Plug 'dense-analysis/ale'

" pedrohdz/vim-yaml-folds                                           " brew install yamllint; pipx install yamllint
set foldlevelstart=20

" dense-analysis/ale
" error: 💢 ✘ 👾 💣  🙅 🤦; warning: ⚠ ⸮ ⸘ ☹; info: ⸚ ϔ 𐘿 𐰦 ; style_error: ᑹ; " style_warning: ᓏ ᓍ ఠ ൠ;
let g:ale_open_list                       = 1                       " ╮ whether if open
let g:ale_list_window_size                = 2                       " ╯ diagnostics windows
let g:ale_echo_msg_format                 = '[%linter%] %code%: %s [%severity%] '
let g:ale_virtualtext_prefix              = '%comment% %type% [%code%]: '
let g:ale_sign_error                      = '✗'
let g:ale_sign_warning                    = 'ᑹ'
let g:ale_sign_info                       = 'ᓆ'
let g:ale_sign_style_error                = '⍥'
let g:ale_sign_style_warning              = '⍨'
let g:ale_lint_on_text_changed            = 'never'
let g:ale_fix_on_save                     = 0
let g:ale_lint_on_save                    = 1
let g:ale_warn_about_trailing_blank_lines = 1
let g:ale_warn_about_trailing_whitespace  = 1
let g:ale_set_balloons                    = 1
let g:ale_hover_to_preview                = 1
let g:ale_floating_preview                = 1
let g:ale_close_preview_on_insert         = 1
let g:ale_groovy_npmgroovylint_options    = '--loglevel warning --config ~/.groovylintrc.json'
let g:ale_use_neovim_diagnostics_api      = 0
" for ansbile.yaml
let g:ale_ansible_ansible_lint_executable = 'ansible-lint'
let g:ale_ansible_language_server_config = {}
let g:ale_ansible_language_server_executable = 'ansible-language-server'
```

* shortcuts

  ```vim
  noremap  ]a   :ALENextWrap<CR>
  noremap  [a   :ALEPreviousWrap<CR>
  noremap  ]A   :ALELast<CR>
  noremap  [A   :ALEFirst<CR>
  ```

  * `:ALENextWrap<CR>` : <kbd>]</kbd> + <kbd>a</kbd>
  * `:ALEPreviousWrap<CR>` : <kbd>\[</kbd> + <kbd>a</kbd>
  * `:ALELast<CR>` : <kbd>]</kbd> + <kbd>A</kbd>
  * `:ALEFirst<CR>` : <kbd>\[</kbd> + <kbd>A</kbd>
* linter/checker install

  ```bash
  $ brew install checkstyle stylelint prettier
  # shell
  $ brew install bashate shfmt
  # yaml
  $ brew install yamllint yamlfmt
  # java
  $ brew install google-java-format
  # groovy/Jenkinsfile
  $ npm i -g npm-groovy-lint
  ```
* debug info

  ```vim
  :ALEInfo
  ```

![ale error](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-220b4ecdd677dbca61beaaa148f8069dee64c130%2Fvim-ale-error.png?alt=media)

![ale warning](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-2df1bf2b7109c3cc7aac2ba1e0ae57563c2afd3f%2Fvim-ale-warning.png?alt=media)

![ale info](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-2514d692523f2aea73a3e21ca4162c0e6afeba4e%2Fvim-ale-info.png?alt=media)

## color and theme

> \[!NOTE|label:references:]
>
> * [Highlighting color strings with correspondent color](https://vi.stackexchange.com/a/26891/7389)
> * plugins:
>   * [chrisbra/Colorizer](https://github.com/chrisbra/Colorizer)
>   * [gko/vim-coloresque](https://github.com/gko/vim-coloresque)
>   * [ap/vim-css-color](https://github.com/ap/vim-css-color)
>   * [skammer/vim-css-color](https://github.com/skammer/vim-css-color)
>   * [lifepillar/vim-colortemplate](https://github.com/lifepillar/vim-colortemplamarkdownRulete)
> * theme
>   * [rafi/awesome-vim-colorschemes](https://github.com/rafi/awesome-vim-colorschemes)
>   * [morhetz/gruvbox](https://github.com/morhetz/gruvbox) | [sainnhe/gruvbox-material](https://github.com/sainnhe/gruvbox-material) | [luisiacc/gruvbox-baby](https://github.com/luisiacc/gruvbox-baby) | [ellisonleao/gruvbox.nvim](https://github.com/ellisonleao/gruvbox.nvim)
> * wallpapers
>   * [FrenzyExists/wallpapers](https://github.com/FrenzyExists/wallpapers/tree/main)

```vim
set encoding=UTF-8
if has('win32') || has('win64')
  set guifont=OperatorMonoLig\ Nerd\ Font\ Mono:h29
else
  set guifont=OperatorMono\ Nerd\ Font:h29
  set renderoptions=type:directx,renmode:5
endif
```

* more

  ```vim
  set guifont=Agave\ Nerd\ Font\ Mono:h32
  set guifont=JetBrainsMono\ Nerd\ Font\ Mono:h26
  set guifont=OperatorMono\ Nerd\ Font:h29
  set renderoptions=type:directx,gamma:1.5,contrast:0.5,geom:1,renmode:5,taamode:1,level:0.5
  ```

### [scrooloose/nerdtree](https://github.com/preservim/nerdtree)

> \[!NOTE|label:references:]
>
> * [#201 - File coloring based on type.](https://github.com/preservim/nerdtree/issues/201)
> * configs
>   * [bdryanovski/vimrc/vimsrc/\_plugins.vim](https://github.com/bdryanovski/vimrc/blob/master/vimsrc/_plugins.vim#L128)

[![nvim nerdtree devicons coc lspconfig](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-58c7c8efe3207159b2828144aab2d3da35a10cf4%2Fnvim-nerdtree-devicon-highlight-snippets-copilot.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/nvim-nerdtree-devicon-highlight-snippets-copilot.gif)

```vim
Plug 'scrooloose/nerdtree'

" scrooloose/nerdtree
map <C-A-n> :NERDTreeToggle<CR>
nnoremap <silent> <leader>nt :NERDTreeToggle<CR>
let NERDTreeShowHidden            = 1
let NERDTreeHighlightCursorline   = 0
let g:NERDTreeShowLineNumbers     = 0
let g:NERDTreeQuitOnOpen          = 1
let g:NERDTreeWinPos              = 'left'
let g:NERDTreeWinSize             = 25
" will cause tiagofumo/vim-nerdtree-syntax-highlight highlight issue
" let g:NERDTreeFileLines         = 1
let g:NERDTreeDirArrowExpandable  = '+'
let g:NERDTreeDirArrowCollapsible = '⏵'
let g:NERDTreeIgnore              = [
      \ '^.*history$',
      \ '.*iterm2_shell_integration.*',
      \ '^.*\.swp',
      \ '.*\.log',
      \ '.wget-hsts',
      \ '.DS_Store',
      \ '^__pycache__$',
      \ 'vim_mru_files',
      \ 'viminfo',
      \ '^node_modules$',
      \ '^.git$',
      \ '^.Trash$',
      \ 'NERDTree.*',
      \ 'CFUserTextEncoding',
      \ '.*tags',
      \ '.cache',
      \ '.bundle',
      \ '.bash_.*',
      \ '.gradle.*',
      \ '.gnupg'
      \]
autocmd BufEnter * if winnr() == winnr('h') && bufname('#') =~ 'NERD_tree_\d\+' && bufname('%') !~ 'NERD_tree_\d\+' && winnr('$') > 1 |
    \ let buf=bufnr() | buffer# | execute "normal! \<C-W>w" | execute 'buffer'.buf | endif
autocmd BufEnter * if winnr('$') == 1 && exists('b:NERDTree') && b:NERDTree.isTabTree() | quit | endif
" start nerdtree when vim start
autocmd VimEnter *  NERDTree
```

### [ryanoasis/vim-devicons](https://github.com/ryanoasis/vim-devicons)

> \[!NOTE|label:unicodes]
>
> * [vim-devicon](https://github.com/ryanoasis/vim-devicons)
>   * [FAQ & Troubleshooting](https://github.com/ryanoasis/vim-devicons/wiki/FAQ-&-Troubleshooting)
>   * [Extra Configuration](https://github.com/ryanoasis/vim-devicons/wiki/Extra-Configuration#character-mappings)
>   * [Usage](https://github.com/ryanoasis/vim-devicons/wiki/usage)
>   * [vim-scripts/vim-webdevicons/readme.md](https://github.com/vim-scripts/vim-webdevicons/blob/master/readme.md)
> * bracket issue in nerdtree
>   * [Square brackets around icons](https://github.com/ryanoasis/vim-devicons/wiki/FAQ-&-Troubleshooting#square-brackets-around-icons)
>   * [#37 - g:webdevicons\_conceal\_nerdtree\_brackets](https://github.com/ryanoasis/vim-devicons/issues/37#issuecomment-93743685)
>   * [#185 - docs(readme): fix conflict with NERDTree](https://github.com/luochen1990/rainbow/pull/185)
>   * [Remove those rectangular bracket around folder icon?](https://www.reddit.com/r/neovim/comments/n31xfr/remove_those_rectangular_bracket_around_folder/)
> * configs
>   * [bdryanovski/vimrc/vimsrc/\_plugins.vim](https://github.com/bdryanovski/vimrc/blob/master/vimsrc/_plugins.vim#L47-L70)
>   * [LumpyChen/Conf-mac/Vim/.vimrc.bundles.local](https://github.com/LumpyChen/Conf-mac/blob/master/Vim/.vimrc.bundles.local#L8)
>   * [zeorin/dotfiles/.vimrc](https://github.com/zeorin/dotfiles/blob/e01cebffcd11763ac647aad160eeba861758b348/.vimrc#L850) | [latest](https://github.com/zeorin/dotfiles/blob/b5bddeef0694acaf7cbb1da3e48862d1d0cd8a3e/.vimrc#L876)
>   * [skbolton/titan/nvim/nvim/plugin/filesystem.vim](https://github.com/skbolton/titan/blob/b6c44d3c9b6aab2ae011d6072ca0e2a5a254a82a/nvim/nvim/plugin/filesystem.vim#L19)
>   * [#276 - The symbol for opened folder in NERDTree is not working](https://github.com/ryanoasis/vim-devicons/issues/276#issue-470708269)
>   * [NERDTreeExtensionHighlightColor](https://github.com/tiagofumo/vim-nerdtree-syntax-highlight/issues/6#issuecomment-242753362)
>   * [\* init.vim](https://gist.github.com/asilvadesigns/0882eb61977b24813fb3c6e4c6fbc8c7#file-init-vim-L380)
> * icons:
>   * [\* iMarslo: devicons](https://github.com/marslo/ibook/blob/marslo/docs/vim/tools/fonts.md#devicons)
>   * [filetype: U+E5FA to U+E9F9](https://utf8-chartable.de/unicode-utf8-table.pl?start=58874\&number=1024\&utf8=dec\&unicodeinhtml=hex)
> * requires [nerd fonts](https://github.com/ryanoasis/nerd-fonts) | [nerd fonts preview and download](https://www.nerdfonts.com/font-downloads)

[![nvim nerdtree devicon highlight](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-d4301e05eee8f6515e9e4b2da31c34db59f1cfb4%2Fnvim-nerdtree-devicon-highlight.png?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/nvim-nerdtree-devicon-highlight.png)

```vim
" ryanoasis/vim-devicons
let g:WebDevIconsOS                                                    = 'Darwin'
let g:DevIconsEnableFoldersOpenClose                                   = 1
let g:DevIconsEnableFolderExtensionPatternMatching                     = 0
let g:DevIconsDefaultFolderOpenSymbol                                  = ''
let g:WebDevIconsUnicodeDecorateFolderNodesDefaultSymbol               = ''
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols              = {}
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['log']       = ''
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['json']      = ''
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['md']        = ''
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['perm']      = '󰌋'
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['groovy']    = ''
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['sh']        = '󱆃'
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['yaml']      = '󱚥'
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['yml']       = '󱚥'
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['gitcommit'] = ''
let g:WebDevIconsUnicodeDecorateFileNodesExactSymbols                  = {}
let g:WebDevIconsUnicodeDecorateFileNodesExactSymbols['jenkinsfile']   = ''
let g:WebDevIconsUnicodeDecorateFileNodesExactSymbols['devops']        = '󰘦'
let g:WebDevIconsUnicodeDecorateFileNodesExactSymbols['vimrc.d']       = '󰷺'
let g:WebDevIconsUnicodeDecorateFileNodesExactSymbols['vars']          = '󱆃'
let g:WebDevIconsUnicodeDecorateFileNodesExactSymbols['src']           = '󰵮'
let g:WebDevIconsUnicodeDecorateFileNodesPatternSymbols                = {}
let g:WebDevIconsUnicodeDecorateFileNodesPatternSymbols['.*ignore$']   = ''
let g:WebDevIconsUnicodeDecorateFileNodesPatternSymbols['.*rc$']       = '󱔁'
let g:WebDevIconsUnicodeDecorateFileNodesPatternSymbols['.*git.*$']    = ''
if exists('g:loaded_webdevicons') | call webdevicons#refresh() | endif
autocmd filetype nerdtree set conceallevel=3
autocmd filetype nerdtree set concealcursor=nvic

" tiagofumo/vim-nerdtree-syntax-highlight
" #293739 #BDBB72 #808000 #ba55d3 #183172 #0d6efd #3a346f #fd7e14 #d63384 #6c71c4
let g:NERDTreeSyntaxEnabledExtensions                 = ['rb', 'lua', 'vim', 'sh', 'py', 'groovy', 'css', 'html', 'json', 'log']
let g:NERDTreeSyntaxEnabledExactMatches               = ['.marslo', 'jenkins', 'virtualization', 'vimrc.d', 'devops', 'vars', 'jenkinsfile', '.vimrc']
let g:NERDTreeExtensionHighlightColor                 = {}
let g:NERDTreeExtensionHighlightColor['groovy']       = '8FAA54'       " #8FAA54
let g:NERDTreeExtensionHighlightColor['log']          = '44788E'       " #44788E
let g:NERDTreeExtensionHighlightColor['yaml']         = '9370db'       " #9370db
let g:NERDTreeExtensionHighlightColor['yml']          = '9370db'       " #9370db
let g:NERDTreeExtensionHighlightColor['png']          = '719899'       " #719899
let g:NERDTreeExtensionHighlightColor['css']          = 'fd7e14'       " #fd7e14
let g:NERDTreeExactMatchHighlightColor                = {}
let g:NERDTreeExactMatchHighlightColor['README']      = '0099BD'       " #0099BD
let g:NERDTreePatternMatchHighlightColor              = {}
let g:NERDTreePatternMatchHighlightColor['.*rc$']     = '616E88'       " #616E88
let g:NERDTreePatternMatchHighlightColor['.*git.*$']  = '6c71c4'       " #6c71c4
let g:NERDTreePatternMatchHighlightColor['.*rc$']     = '4682b4'       " #4682b4
let g:NERDTreePatternMatchHighlightColor['.*ignore$'] = 'cd853f'       " #cd853f
let g:NERDTreePatternMatchHighlightColor['.*\.bak$']  = '293739'       " #293739
```

* default settings

  ```vim
  let g:WebDevIconsUnicodeDecorateFolderNodes        = 1
  let g:WebDevIconsNerdTreeAfterGlyphPadding         = ' '
  let g:webdevicons_enable_nerdtree                  = 1
  let g:webdevicons_enable_unite                     = 1
  let g:webdevicons_enable_vimfiler                  = 1
  let g:webdevicons_conceal_nerdtree_brackets        = 1
  let g:WebDevIconsNerdTreeGitPluginForceVAlign      = 1
  let g:DevIconsEnableFolderExtensionPatternMatching = 0

  :echo g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols
  {'erl': '', 'styl': '', 'db': '', 'rmd': '', 'c++': '', 'pyc': '', 'pyd': '', 'go': '', 'suo':
  '', 'lua': '', 'bash': '', 'pyo': '', 'mustache': '', 'gif': '', 'nix': '', 'jsx': '', 'leex':
  '', 'lhs': '', 'sol': 'ﲹ', 'scala': '', 'zsh': '', 'jpeg': '', 'pem': '', 'ts': '', 'xcplaygroun
  d': '', 'fsi': '', 'coffee': '', 'scss': '', 'js': '', 'gitcommit': '', 'xul': '', 'mdx': '', '
  less': '', 'fish': '', 'htm': '', 'rb': '', 'f#': '', 'c': '', 'd': '', 'md': '', 'webp': '',
  'h': '', 'mli': 'λ', 'mk': '', 'rs': '', 'haml': '', 'png': '', 'hh': '', 'php': '', 'cc': '',
  't': '', 'jl': '', 'json': '', 'cljc': '', 'exs': '', 'jenkinsfile': '', 'hs': '', 'sql': '', '
  ico': '', 'ps1': '', 'cs': '', 'bmp': '', 'sln': '', 'cljs': '', 'html': '', 'cpp': '', 'hrl':
  '', 'ml': 'λ', 'sass': '', 'vue': '﵂', 'awk': '', 'conf': '', 'pl': '', 'pm': '', 'cp': '', 'rli
  b': '', 'pp': '', 'tex': 'ﭨ', 'elm': '', 'jpg': '', 'toml': '', 'webmanifest': '', 'mjs': '', 's
  wift': '', 'r': 'ﳒ', 'ai': '', 'fs': '', 'csh': '', 'psd': '', 'psb': '', 'heex': '', 'rss': ''
  , 'cxx': '', 'css': '', 'log': '', 'rake': '', 'sh': '', 'hpp': '', 'bat': '', 'fsx': '', 'ini'
  : '', 'gemspec': '', 'markdown': '', 'hbs': '', 'twig': '', 'rproj': '鉶', 'yaml': '', 'fsscript'
  : '', 'ksh': '', 'vim': '', 'ejs': '', 'clj': '', 'ex': '', 'edn': '', 'slim': '', 'eex': '',
  'tsx': '', 'dump': '', 'groovy': '', 'py': '', 'hxx': '', 'diff': '', 'dart': '', 'java': '', '
  yml': ''}

  :echo g:WebDevIconsUnicodeDecorateFileNodesExactSymbols
  {'.vimrc': '', 'gruntfile.coffee': '', '_gvimrc': '', '_vimrc': '', 'dropbox': '', '.gvimrc': '',
   'license': '󰌋', 'procfile': '', 'config.ru': '', 'gemfile': '', '.gitignore': '', 'COMMIT_EDITMSG'
  : '', 'src': '', '.gitmodules': '', 'makefile': '', 'rakefile': '', '.bashprofile': '', 'gulpfile
  .coffee': '', 'gruntfile.js': '', '.zshenv': '', 'gruntfile.ls': '', 'node_modules': '', 'gulpfile
  .js': '', '.bashrc': '', 'robots.txt': '󰚩', '.zshrc': '', 'mix.lock': '', 'gulpfile.ls': '', 'exac
  t-match-case-sensitive-2': '2', 'docker-compose.yml': '', '.gitconfig': '', '.gitattributes': '', 'r
  eact.jsx': '', 'exact-match-case-sensitive-1.txt': '1', 'dockerfile': '', '.zprofile': '', 'cmakelis
  ts.txt': '', '.ds_store': '', 'favicon.ico': ''}
  ```

```vim
Plug 'ryanoasis/vim-devicons'
Plug 'tiagofumo/vim-nerdtree-syntax-highlight'

" ryanoasis/vim-devicons
let g:WebDevIconsOS                                               = 'Darwin'
let g:WebDevIconsUnicodeDecorateFolderNodes                       = 1
let g:WebDevIconsNerdTreeAfterGlyphPadding                        = ' '
let g:webdevicons_enable_nerdtree                                 = 1
let g:webdevicons_enable_unite                                    = 1
let g:webdevicons_enable_vimfiler                                 = 1
let g:webdevicons_conceal_nerdtree_brackets                       = 1
let g:DevIconsEnableFoldersOpenClose                              = 1
let g:DevIconsDefaultFolderOpenSymbol                             = ''
let g:WebDevIconsUnicodeDecorateFolderNodesDefaultSymbol          = ''
let g:DevIconsEnableFolderExtensionPatternMatching                = 1
let g:WebDevIconsNerdTreeGitPluginForceVAlign                     = 1
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols         = {}
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['log']  = ''
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['json'] = ''
let g:WebDevIconsUnicodeDecorateFileNodesExtensionSymbols['md']   = ''
let g:WebDevIconsUnicodeDecorateFileNodesExactSymbols             = {}
let g:WebDevIconsUnicodeDecorateFileNodesExactSymbols['src']      = ''
if exists('g:loaded_webdevicons') | call webdevicons#refresh() | endif

" tiagofumo/vim-nerdtree-syntax-highlight
let s:brown       = "905532"                                      " #905532
let s:aqua        = "3AFFDB"                                      " #3AFFDB
let s:blue        = "689FB6"                                      " #689FB6
let s:darkBlue    = "44788E"                                      " #44788E
let s:purple      = "834F79"                                      " #834F79
let s:lightPurple = "834F79"                                      " #834F79
let s:red         = "AE403F"                                      " #AE403F
let s:beige       = "F5C06F"                                      " #F5C06F
let s:yellow      = "F09F17"                                      " #F09F17
let s:orange      = "D4843E"                                      " #D4843E
let s:darkOrange  = "F16529"                                      " #F16529
let s:pink        = "CB6F6F"                                      " #CB6F6F
let s:salmon      = "EE6E73"                                      " #EE6E73
let s:green       = "8FAA54"                                      " #8FAA54
let s:lightGreen  = "31B53E"                                      " #31B53E
let s:white       = "FFFFFF"                                      " #FFFFFF
let s:rspec_red   = 'FE405F'                                      " #FE405F
let s:git_orange  = 'F54D27'                                      " #F54D27
let g:NERDTreeHighlightCursorline                        = 1
let g:NERDTreeExtensionHighlightColor                    = {}
let g:NERDTreeExtensionHighlightColor['groovy']          = s:beige
let g:NERDTreeExtensionHighlightColor['md']              = "CC6666"
let g:NERDTreeExactMatchHighlightColor                   = {}
let g:NERDTreeExactMatchHighlightColor['.gitignore']     = s:git_orange
let g:NERDTreePatternMatchHighlightColor                 = {}
let g:NERDTreePatternMatchHighlightColor['.*\.md$']      = s:yellow
let g:WebDevIconsDefaultFolderSymbolColor                = s:beige
let g:WebDevIconsDefaultFileSymbolColor                  = s:darkBlue
let g:NERDTreeSyntaxEnabledExtensions                    = ['rb', 'sh', 'py', 'groovy', 'css', 'html']
let g:NERDTreeSyntaxEnabledExactMatches                  = ['.marslo', 'jenkins', 'virtualization', 'devops']
```

* [more settings for vim-devicon](https://github.com/zeorin/dotfiles/blob/e01cebffcd11763ac647aad160eeba861758b348/.vimrc#L850) | [latest](https://github.com/zeorin/dotfiles/blob/b5bddeef0694acaf7cbb1da3e48862d1d0cd8a3e/.vimrc)

  ```vim
  Plug 'ryanoasis/vim-devicons'

  let g:WebDevIconsUnicodeDecorateFolderNodes = 1
  let g:DevIconsEnableFoldersOpenClose = 1
  if exists("g:loaded_webdevicons") | call webdevicons#refresh() | endif
  augroup devicons
    autocmd!
    autocmd FileType nerdtree setlocal nolist
    autocmd FileType nerdtree syntax match hideBracketsInNerdTree "\]" contained conceal containedin=ALL
    autocmd FileType nerdtree syntax match hideBracketsInNerdTree "\[" contained conceal containedin=ALL
    autocmd FileType nerdtree setlocal conceallevel=3
    autocmd FileType nerdtree setlocal concealcursor=nvic
  augroup END
  function! DeviconsColors(config)
    let colors = keys(a:config)
    augroup devicons_colors
      autocmd!
      for color in colors
        if color == 'normal'
          exec 'autocmd FileType nerdtree,startify if &background == ''dark'' | '.
            \ 'highlight devicons_'.color.' guifg='.g:sol.gui.base01.' ctermfg='.g:sol.cterm.base01.' | '.
            \ 'else | '.
            \ 'highlight devicons_'.color.' guifg='.g:sol.gui.base1.' ctermfg='.g:sol.cterm.base1.' | '.
            \ 'endif'
        elseif color == 'emphasize'
          exec 'autocmd FileType nerdtree,startify if &background == ''dark'' | '.
            \ 'highlight devicons_'.color.' guifg='.g:sol.gui.base1.' ctermfg='.g:sol.cterm.base1.' | '.
            \ 'else | '.
            \ 'highlight devicons_'.color.' guifg='.g:sol.gui.base01.' ctermfg='.g:sol.cterm.base01.' | '.
            \ 'endif'
        else
          exec 'autocmd FileType nerdtree,startify highlight devicons_'.color.' guifg='.g:sol.gui[color].' ctermfg='.g:sol.cterm[color]
        endif
        exec 'autocmd FileType nerdtree,startify syntax match devicons_'.color.' /\v'.join(a:config[color], '|').'/ containedin=ALL'
      endfor
    augroup END
  endfunction
  let g:devicons_colors = {
    \'normal': ['', '', '', '', ''],
    \'emphasize': ['', '', '', '', '', '', '', '', '', '', ''],
    \'yellow': ['', '', ''],
    \'orange': ['', '', '', 'λ', '', ''],
    \'red': ['', '', '', '', '', '', '', '', ''],
    \'magenta': [''],
    \'violet': ['', '', '', ''],
    \'blue': ['', '', '', '', '', '', '', '', '', '', '', '', ''],
    \'cyan': ['', '', '', ''],
    \'green': ['', '', '', '']
  \}
  call DeviconsColors(g:devicons_colors)
  ```

### [RRethy/vim-hexokinase](https://github.com/RRethy/vim-hexokinase)

```vim
Plug 'rrethy/vim-hexokinase', { 'do': 'make hexokinase' }

" rrethy/vim-hexokinase
let g:Hexokinase_highlighters  = [ 'backgroundfull' ]              " available options: 'virtual', 'sign_column', 'background', 'backgroundfull', 'foreground', 'foregroundfull'
let g:Hexokinase_optInPatterns = [
\     'full_hex',
\     'triple_hex',
\     'rgb',
\     'rgba',
\     'hsl',
\     'hsla',
\     'colour_names'
\ ]
let g:Hexokinase_ftEnabled     = [ 'css', 'html', 'javascript']    " not recommended
```

## utils

### [vim-scripts/AuthorInfoDetect](https://github.com/vim-scripts/AuthorInfo)

```vim
Plug 'marslo/authorinfo'

noremap <leader>aid :AuthorInfoDetect<CR>
let g:vimrc_author = 'marslo'
let g:vimrc_email  = 'marslo.jiao@gmail.com'
autocmd BufWritePre, FileWritePre * :AuthorInfoDetect<CR>
autocmd BufWritePre               * :AuthorInfoDetect<CR>
```

### [simnalamburt/vim-mundo](https://github.com/simnalamburt/vim-mundo)

```vim
" ~/.vimrc
if has( 'persistent_undo' )
  if has('nvim')
    let target_path = expand( '~/.vim/undo' )
    set undodir=expand('~/.vim/undo')
  else
    let target_path = expand( '~/.vim/undo/vundo' )
  endif
  if !isdirectory( target_path )
    call system( 'mkdir -p ' . target_path )
  endif
  set undofile
  let &undodir=target_path
endif
```

```vim
" ~/.vimrc.d/extension
Plug 'simnalamburt/vim-mundo'

"simnalamburt/vim-mundo
noremap <Leader>u :MundoToggle<CR>
let g:mundo_prefer_python3 = 1
let g:mundo_width          = 26
```

### [yegappan/mru](https://github.com/yegappan/mru)

```vim
noremap <leader>re :MRU<CR>
let MRU_Auto_Close    = 1                                           " most recently used(mru)
let MRU_Max_Entries   = 10
let MRU_Exclude_Files = '^/tmp/.*\|^/temp/.*\|^/media/.*\|^/mnt/.*'
```

### [amitds1997/remote-nvim.nvim](https://github.com/amitds1997/remote-nvim.nvim)

> \[!NOTE|label:references:]
>
> * [#21635 remote ssh plugin (like vscode remote-ssh)](https://github.com/neovim/neovim/issues/21635)
> * [DanielWeidinger/nvim-sshfs](https://github.com/DanielWeidinger/nvim-sshfs)
> * [ipod825/ranger.nvim](https://github.com/ipod825/ranger.nvim) | [ipod825/vim-netranger](https://github.com/ipod825/vim-netranger)
> * [ashwinvis/ssh.nvim](https://codeberg.org/ashwinvis/ssh.nvim)

## markdown

### [preservim/vim-markdown](https://github.com/preservim/vim-markdown)

```vim
Plug 'preservim/vim-markdown'

" preservim/vim-markdown
let g:vim_markdown_toc_autofit          = 1
let g:vim_markdown_conceal              = 0
let g:vim_markdown_conceal_code_blocks  = 0
let g:vim_markdown_strikethrough        = 1
let g:vim_markdown_folding_disabled     = 1                         " =1 to disable folding
let g:vim_markdown_new_list_item_indent = 2
```

* other configurations

  ```vim
  let g:vim_markdown_frontmatter        = 1
  let g:vim_markdown_json_frontmatter   = 1
  let g:vim_markdown_autowrite          = 1
  let g:vim_markdown_follow_anchor      = 1
  let g:vim_markdown_anchorexpr         = "'<<'.v:anchor.'>>'"
  ```

### [dhruvasagar/vim-table-mode](https://github.com/dhruvasagar/vim-table-mode)

```vim
Plug 'dhruvasagar/vim-table-mode'

noremap <Leader>tm :TableModeToggle<CR>
let g:tabular_loaded             = 1
let g:table_mode_corner          = '|'
let g:table_mode_header_fillchar = '-'
let g:table_mode_align_char      = ":"
let g:table_mode_corner          = "|"
let g:table_mode_align_char      = ":"
" let g:table_mode_corner_corner = '+'
```

* automatic alignment table in markdown

  ```vim
  function! s:isAtStartOfLine(mapping)
    let text_before_cursor = getline('.')[0 : col('.')-1]
    let mapping_pattern = '\V' . escape(a:mapping, '\')
    let comment_pattern = '\V' . escape(substitute(&l:commentstring, '%s.*$', '', ''), '\')
    return (text_before_cursor =~? '^' . ('\v(' . comment_pattern . '\v)?') . '\s*\v' . mapping_pattern . '\v$')
  endfunction
  inoreabbrev <expr> <bar><bar>
            \ <SID>isAtStartOfLine('\|\|') ?
            \ '<c-o>:TableModeEnable<cr><bar><space><bar><left><left>' : '<bar><bar>'
  inoreabbrev <expr> __
            \ <SID>isAtStartOfLine('__') ?
            \ '<c-o>:silent! TableModeDisable<cr>' : '__'
  ```

### [godlygeek/tabular](https://github.com/godlygeek/tabular)

```vim
Plug 'godlygeek/tabular'

" settings
if exists(":Tabularize")
  nmap <Leader>a= :Tabularize /=<CR>
  vmap <Leader>a= :Tabularize /=<CR>
  nmap <leader>a: :Tabularize /:\zs<CR>
  vmap <leader>a: :Tabularize /:\zs<CR>
  inoremap <silent> <Bar>   <Bar><Esc>:call <SID>table_auto_align()<CR>
endif
```

* [function for auto-alignment](https://github.com/marslo/dotfiles/blob/main/.marslo/vimrc.d/functions#L119)

  ```bash
  function! s:table_auto_align()
    let p = '^\s*|\s.*\s|\s*$'
    if exists(':Tabularize') && getline('.') =~# '^\s*|'
      \ && (getline(line('.')-1) =~# p || getline(line('.')+1) =~# p)
      let column = strlen(substitute(getline('.')[0:col('.')],'[^|]','','g'))
      let position = strlen(matchstr(getline('.')[0:col('.')],'.*|\s*\zs.*'))
      Tabularize/|/l1
      normal! 0
      call search(repeat('[^|]*|',column).'\s\{-\}'.repeat('.',position),'ce',line('.'))
    endif
  endfunction
  ```

## git

* call bash cmd in silent mode

  ```vim
  nnoremap <leader>mp  :execute 'silent !git push --force' \| redraw! \| echohl Function \| echo 'change committed !!'<CR>
  " or to call gitalias
  nnoremap <leader>mp  :execute 'silent !git mp' \| redraw!<CR>
  ```

[![git blamer blame](https://1999659500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHqOSW6on5cHbtwcSH6%2Fuploads%2Fgit-blob-86502e21e655537af7c44b15cd2b19a757a984d7%2Fnvim-git-blamer-blame.gif?alt=media)](https://github.com/marslo/ibook/blob/marslo/docs/screenshot/vim/nvim-git-blamer-blame.gif)

### [airblade/vim-gitgutter](https://github.com/airblade/vim-gitgutter)

> \[!NOTE|label:references:]
>
> * [GitGutter Documentation](https://jisaacks.github.io/GitGutter/)
> * [Can't enable gitgutter with GitGutterEnable after disabling it on startup](https://github.com/airblade/vim-gitgutter/issues/409)
> * [How to display in real time](https://github.com/airblade/vim-gitgutter/issues/579)

```vim
Plug 'airblade/vim-gitgutter'

" airblade/vim-gitgutter
set updatetime=250
set signcolumn=yes
let g:gitgutter_enabled          = 1
let g:gitgutter_realtime         = 0
let g:gitgutter_eager            = 0
if has('win32') || has('win64')
  let g:gitgutter_git_executable = 'c:\iMarslo\myprograms\Git\bin\git.exe'
else
  let g:gitgutter_git_executable = '/usr/local/bin/git'
endif
highlight clear SignColumn
```

* shortcuts

  ```vim
  noremap  ]h :GitGutterNextHunk<CR>
  noremap  [h :GitGutterPrevHunk<CR>
  ```

  * `:GitGutterNextHunk<CR>` : <kbd>]</kbd> + <kbd>h</kbd>
  * `:GitGutterPrevHunk<CR>` : <kbd>\[</kbd> + <kbd>h</kbd>

### [tpope/vim-fugitive](https://github.com/tpope/vim-fugitive)

```vim
Plug 'tpope/vim-fugitive'

" fugitive
nnoremap <leader>mp :silent exec '! git mp'<CR>
nnoremap <Leader>ga :Git add %:p<CR><CR>
nnoremap <Leader>gs :Gstatus<CR>
nnoremap <leader>gl :silent! Glog<CR>:bot copen<CR>
nnoremap <leader>gp :Ggrep<Space>
nnoremap <leader>gb :Git branch<Space>
nnoremap <leader>go :Git checkout<Space>
nnoremap <leader>gc :Git commit -am ""<Left>
command! -bar -nargs=* Gpull execute 'Git pull'
command! -bar -nargs=* Gpush execute 'Git push'
```

### [APZelos/blamer.nvim](https://github.com/APZelos/blamer.nvim)

```vim
Plug 'APZelos/blamer.nvim'

" APZelos/blamer.nvim
nnoremap <Leader>bb  :BlamerToggle<CR>
if has( 'nvim' )
  let g:blamer_enabled            = 1
else
  let g:blamer_enabled            = 0
endif
let g:blamer_delay                = 100
let g:blamer_show_in_visual_modes = 0
let g:blamer_show_in_insert_modes = 0
let g:blamer_relative_time        = 1
let g:blamer_prefix               = '  '
let g:blamer_template             = '<committer> • <commit-short> • <summary>'
```

### [zivyangll/git-blame.vim](https://github.com/zivyangll/git-blame.vim)

```vim
" zivyangll/git-blame.vim
nnoremap <Leader>ebb :<C-u>call gitblame#echo()<CR>
```

## troubleshooting

### airline

> \[!NOTE|label:references:]
>
> * fonts
>   * [Why vim-airline is not showing symbols properly?](https://stackoverflow.com/a/34210791/2940319)
>
>   * [The powerline font symbols are not showing up](https://github.com/vim-airline/vim-airline/wiki/FAQ#the-powerline-font-symbols-are-not-showing-up)
>
>   * [lujiacn/Monaco for Powerline.md](https://gist.github.com/lujiacn/32b598b1a6a43c996cbd93d42d466466)
>
> > ````
> > ```vim
> > if has("mac") || has("macunix")
> >     set guifont=Monaco\ for\ Powerline:h24
> > elseif has("win32") || has("win64")
> >     set guifont=Monaco\ for\ Powerline:h14:cANSI
> >     set renderoptions=type:directx,renmode:5
> > endif
> > ```
> > ````

* solution : install powerline fonts

  > \[!NOTE|label:references:]
  >
  > * [\* powerline/fonts](https://github.com/powerline/fonts)
  > * [supermarin/powerline-fonts](https://github.com/supermarin/powerline-fonts)

  ```bash
  $ git clone git@github.com:powerline/fonts.git ${iRCHOME}/utils/
  $ git clone git@github.com:supermarin/powerline-fonts.git ${iRCHOME}/utils/

  $ cd ${iRCHOME}/utils/fonts
  $ ./install.sh
  ```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://imarslo.gitbook.io/handbook/vim/plugins.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.