/spellsitter.nvim

Treesitter powered spellchecker

Primary LanguageLuaMIT LicenseMIT

spellsitter.nvim

CI License: MIT

Enable Neovim's builtin spellchecker for buffers with tree-sitter highlighting.

Requirements

Neovim >= 0.5.0

Installation

packer.nvim:

use {
  -- Optional but recommended
  -- 'nvim-treesitter/nvim-treesitter',
  'lewis6991/spellsitter.nvim',
}

vim-plug:

" Optional but recommended
" Plug 'nvim-treesitter/nvim-treesitter'
Plug 'lewis6991/spellsitter.nvim'

Note: This plugin does not depend on nvim-treesitter however it is recommended in order to easily install tree-sitter parsers.

Usage

For basic setup with all batteries included:

require('spellsitter').setup()

If using packer.nvim spellsitter can be setup directly in the plugin spec:

use {
  'lewis6991/spellsitter.nvim',
  config = function()
    require('spellsitter').setup()
  end
}

Configuration can be passed to the setup function. Here is an example with all the default settings:

require('spellsitter').setup {
  -- Whether enabled, can be a list of filetypes, e.g. {'python', 'lua'}
  enable = true,

  -- Spellchecker to use. values:
  -- * vimfn: built-in spell checker using vim.fn.spellbadword()
  -- * ffi: built-in spell checker using the FFI to access the
  --   internal spell_check() function
  spellchecker = 'vimfn',
}

Non-Goals

  • Support external spellchecker backends.