Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JoosepAlviste/nvim-ts-context-commentstring
Neovim treesitter plugin for setting the commentstring based on the cursor location in a file.
https://github.com/JoosepAlviste/nvim-ts-context-commentstring
lua neovim neovim-plugin plugin tree-sitter treesitter
Last synced: about 2 months ago
JSON representation
Neovim treesitter plugin for setting the commentstring based on the cursor location in a file.
- Host: GitHub
- URL: https://github.com/JoosepAlviste/nvim-ts-context-commentstring
- Owner: JoosepAlviste
- License: mit
- Created: 2021-02-24T19:33:53.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-27T19:00:35.000Z (2 months ago)
- Last Synced: 2024-03-28T20:11:29.256Z (2 months ago)
- Topics: lua, neovim, neovim-plugin, plugin, tree-sitter, treesitter
- Language: Lua
- Homepage:
- Size: 2.37 MB
- Stars: 1,005
- Watchers: 8
- Forks: 32
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-neovim - JoosepAlviste/nvim-ts-context-commentstring - Sets the `commentstring` option based on the cursor location in the file. The location is checked via treesitter queries. (Editing Support / Comment)
- awesome-stars - nvim-ts-context-commentstring
- awesome-stars - JoosepAlviste/nvim-ts-context-commentstring - Neovim treesitter plugin for setting the commentstring based on the cursor location in a file. (Lua)
- awesome-neovim - JoosepAlviste/nvim-ts-context-commentstring - Sets the `commentstring` option based on the cursor location in the file. The location is checked via treesitter queries. (Editing Support / Comment)
- awesome-neovim - JoosepAlviste/nvim-ts-context-commentstring - Sets the `commentstring` option based on the cursor location in the file. The location is checked via treesitter queries. (Editing Support / Comment)
README
# `nvim-ts-context-commentstring`
A Neovim plugin for setting the `commentstring` option based on the cursor
location in the file. The location is checked via treesitter queries.
This is useful when there are embedded languages in certain types of files. For
example, Vue files can have many different sections, each of which can have a
different style for comments.
Note that this plugin *only* changes the `commentstring` setting. It does not
add any mappings for commenting. It is recommended to use a commenting plugin
like [`Comment.nvim`](https://github.com/numToStr/Comment.nvim) alongside this
plugin.
## Getting started
**Requirements:**
- [Neovim version 0.9.4](https://github.com/neovim/neovim/releases/tag/v0.9.4)
- Tree-sitter parsers (e.g. installed with [nvim-treesitter](https://github.com/nvim-treesitter/nvim-treesitter))
**Installation:**
Use your favorite plugin manager. For example, here's how it would look like
with [lazy.nvim](https://github.com/folke/lazy.nvim):
```lua
require('lazy').setup {
'JoosepAlviste/nvim-ts-context-commentstring',
}
```
**Setup:**
Defaults work out of the box.
Set `vim.g.skip_ts_context_commentstring_module = true` somewhere in your configuration to skip backwards compatibility routines and speed up loading.
If you want to change the configuration, call the `setup` function of this plugin, e.g.:
```lua
require('ts_context_commentstring').setup {
enable_autocmd = false,
}
```
> **Note**
>
> There is a minimal configuration file available at
> [`utils/minimal_init.lua`](https://github.com/JoosepAlviste/nvim-ts-context-commentstring/blob/main/utils/minimal_init.lua) for reference.
> **Note**
>
> Don't forget to use `:h lua-heredoc` if you're using `init.vim`.
## Configuration
It is recommended to use a commenting plugin that has an integration available
with this plugin. Then, the `commentstring` calculation can be triggered only
when commenting. The available integrations are listed in the
[wiki](https://github.com/JoosepAlviste/nvim-ts-context-commentstring/wiki/Integrations).
The following plugins have an integration available:
- [`b3nj5m1n/kommentary`](https://github.com/JoosepAlviste/nvim-ts-context-commentstring/wiki/Integrations#kommentary)
- [`terrortylor/nvim-comment`](https://github.com/JoosepAlviste/nvim-ts-context-commentstring/wiki/Integrations#nvim-comment)
- [`numToStr/Comment.nvim`](https://github.com/JoosepAlviste/nvim-ts-context-commentstring/wiki/Integrations#commentnvim)
- [`echasnovski/mini.nvim/mini-comment`](https://github.com/JoosepAlviste/nvim-ts-context-commentstring/wiki/Integrations#minicomment)
- [`tpope/vim-commentary`](https://github.com/JoosepAlviste/nvim-ts-context-commentstring/wiki/Integrations#vim-commentary)
However, if an integration is not set up, then the default behavior is to
calculate the `commentstring` on the `CursorHold` autocmd, meaning that the
`:h updatetime` should be set to a smaller value than the default of 4s:
```lua
vim.opt.updatetime = 100
```
> **Note**
>
> For more advanced configuration options, see `:h ts-context-commentstring`.
## More demos
**React:**
**Svelte:**
**HTML:**
**Nesting:**
I injected HTML into JavaScript strings and created multiple levels of nesting
with language tree. This sort of nesting of languages works without any extra
configuration in the plugin.
