There are excellent alternatives for spell and grammer checking such as ltex which can check latex, markdown and comments. I have limited time and the need for me to work on this further has demished. It was a great project to hone my lua skills and learn about treesitter.
Prosesitter uses treesitter and vale to bring true syntax aware prose linting to neovim. While it is reasonably feature complete it still needs a lot of stability work. There is a list of great alternative the end of the readme if you are looking for something right now.
prosesitter.nvim is a text linting tool that adds grammar, spell and style checking to your comments and strings. It uses language tool and vale as backends to check what you write for problems. Style issues can vary using the passive voice, weasle words ('very' unique) to using noninclusive terms. You set your own style or use an existing one. Prosesitter will offer to setup a self contained install of language tool and vale including some defaults styles from the vales style libary.
- Low performance impact; backends are called asynchronously and only when needed with only the text that changed.
- Portable; written in lua and depends only on the backends, offers to install them if not found.
- Configurable; specify exactly what you want to lint for which language, switch between prose style without reloading.
- Can supports any language with a treesitter parser; (you might need to add your own query if I have not yet added one adding queries). Out of the box support for: latex, bash, lua, python, rust, c, and c++.
- Telescope integration.
- neovim > 0.6
- treesitter set up
- (windows only) vale installed
packer.nvim:
use {
'dvdsk/prosesitter'
}
vim-plug:
plug 'dvdsk/prosesitter'
require("telescope").load_extension("prosesitter") -- Optionally, depends on telescope.nvim
require("prosesitter"):setup()or pass a (partial)configuration; setting up your own vale binary, vale config and or adding extra treesitter queries (see adding queries)
require("telescope").load_extension("prosesitter") -- Optionally, depends on telescope.nvim
require("prosesitter"):setup({
vale_bin = vim.fn.stdpath("data") .. "/prosesitter/vale",
vale_cfg = vim.fn.stdpath("data") .. "/prosesitter/vale_cfg.ini",
-- override default behaviour for a languag
ext = {
py = {
queries = {
strings = "[(string) ] @capture",
comments = "[(comment)+ ] @capture",
},
lint_target = "both",
disabled = false,
},
tex = {
lint_target = "strings",
disabled = false,
},
sh = {
lint_target = "comments",
},
},
-- highlight groups to use for lint errors, warnings and suggestions
severity_to_hl = { error = "SpellBad", warning = "SpellRare", suggestion = "SpellCap" },
auto_enable = true, -- do not start linting files on open (default = true)
default_cmds = false, -- do not add commands (default = true)
})You can map/use either lua functions or commands, the following functions are availible:
next/prev: jump to the next/prev linting issue from the current cursor pos and show the error in a popup windowpopup: show a popup window if there is a linting issue on the current cursor posdisable: disables linting on change removing all added highlightsenable: re-enable linting on change and lint all open (supported) buffersswitch_vale_cfg: switches to a different vale config, updates all highlights to reflect the change. Not availible as command, takes as argument the path to the vale config to use
The functions next, prev and popup return a bool that is true if they could jump/open a popup window. Use this (for example) to create a single keymap for prosesitters popup and your lsps show documentation function.
The commands:
PsNextPsPrevPsPopupPsEnablePsDisable
Unfortunatly I have not yet found good keybindings to suggest as I have a rather excentric config.
Setting up a simple keybinding
local opt = { noremap = true, silent = true, nowait = true }
vim.api.nvim_set_keymap("n", ",", "lua require('prosesitter').next()", opt)A more complicated example:
-- if there was a linting error on the current cursor
-- position open a popup, otherwise show the lsp hover
-- documentation
function Hover()
if not require('prosesitter').popup() then
vim.lsp.buf.hover()
end
end
local cmd = ":lua Hover()<CR>"
local opt = { noremap = true, silent = true, nowait = true }
vim.api.nvim_set_keymap("n", ",", cmd, opt)You might not want to switch style too often, thus command can be more suitable then a keybind. You can set one up like this:
vim.cmd(':command EmailStyle lua require("prosesitter").switch_vale_cfg("~/Documents/vale_mail.ini")')In no paticular order I would like to add the following features:
- ability to hide a specific error
- support for more queries (PR's are welcome!)
- allow easy switching between linting comments, strings and comments and strings
- making linting strings more practical by filtering out urls and paths
- function to try and automatically fix an issue
- Do you have a treesitter parser installed for the file you want to prose lint? Try installing one with
TSInstall<tab to autocomplete>. - If the treesitter parser is crashing it can help to update it to the latest version with
TSInstall update - No linting is done on a
.texfile. It could be that vim has decided the file does not contain LaTeX. You can force vim to treat.texfiles as LaTeX by settingvim.g.tex_flavor = "latex"in your init.lua.
If you like this plugin you might also be intrested in:
- ltex, a language server for latex and markdown with spell and grammar checking build in using languagetool. A great alternative for this plugin if you want to have spell and grammar checking for latex and markdown in vim. Use together with grammar-guard.nvim.
- spellsitter, the inspiration for this plugin and a great alternative if you are just looking for spellchecking comments
- ale a asynchronous linting plugin that leaves syntax handling to the linters. Supports the default syntax vale supports (Markdown, AsciiDoc, reStructuredText, HTML, XML).
- vim-language collects all grammer mistakes into the quickfix list
- vim-grammarous grammar checker automatically downloads and sets up LanguageTool.