46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# coc-pairs
|
|
|
|
Auto pair extension for [coc.nvim](https://github.com/neoclide/coc.nvim).
|
|
|
|
**Note** you can use other vim auto pairs plugins with coc.nvim, it's a
|
|
simplified implementation to make auto pairs work like in VSCode.
|
|
|
|
**Note** `b:coc_paires` have renamed to `b:coc_pairs`
|
|
|
|
For enhanced `<CR>` experience, checkout `:h coc#on_enter()`.
|
|
|
|
## Tips
|
|
|
|
- You should disable/remove other auto pair plugins for this extension work as expected.
|
|
- When you type a paired character which is just the next character, it would just move to the right by one column.
|
|
- When the previous content ends with two inserting characters, the characters would just be inserted without inserting the paired character. This makes inserting triple quotes easier.
|
|
- `'` only pairs when the character before is not a word character.
|
|
- for `<` to insert paired `>`, the previous character should not be an empty space.
|
|
|
|
## Install
|
|
|
|
In vim/neovim, run this command:
|
|
|
|
```
|
|
:CocInstall coc-pairs
|
|
```
|
|
|
|
## Features
|
|
|
|
- Insert pair characters automatically.
|
|
- Buffer local pairs, ex: `autocmd FileType tex let b:coc_pairs = [["$", "$"]]`
|
|
|
|
## Options
|
|
|
|
- `pairs.disableLanguages`, list of language ids to disable this extension, default: `[]`.
|
|
- `pairs.enableCharacters`, list of enabled characters, default: `` ["(", "[", "{", "<", "'", "\"", "`"] ``.
|
|
- `pairs.enableBackspace`, enable imap for backspace to remove paired characters,
|
|
default: `true`, won't work when `<bs>` is already mapped.
|
|
|
|
To disable characters for a specified filetypes, you can use `b:coc_pairs_disabled`, ex:
|
|
|
|
autocmd FileType markdown let b:coc_pairs_disabled = ['`']
|
|
|
|
## License
|
|
|
|
MIT
|