PyEnchant wrapper for Kakoune.
This is an old version in Python. I'm now using a more advanced (and faster!) version written in Rust with more features.
Check out: https://git.sr.ht/~dmerej/kak-spell instead
-
Install the C Enchant library, and the required dictionaries. See PyEnchant documentation for details.
-
Install the
kak-spellscript, for instance with pipx:
pipx install kak-spell
- Install plug.kak and add the following lines in your
kakrc:
plug "dmerejkowsky/kak-spell"- (optional): declare a user mode and some mappings:
plug "dmerejkowsky/kak-spell" config %{
declare-user-mode kak-spell
map global user s ': enter-user-mode -lock kak-spell<ret>' -docstring 'enter spell user mode'
map global kak-spell a ': kak-spell-add<ret>' -docstring 'add the selection to the user dict'
map global kak-spell d ': kak-spell-disable<ret>' -docstring 'clear spelling highlighters'
map global kak-spell e ': kak-spell-enable en_US<ret> :kak-spell <ret>' -docstring 'enable spell check in English'
map global kak-spell f ': kak-spell-enable fr_FR<ret> :kak-spell <ret>' -docstring 'run spell check in French'
map global kak-spell l ': kak-spell-list <ret>' -docstring 'list spelling errors in a buffer'
map global kak-spell n ': kak-spell-next<ret>' -docstring 'go to next spell error'
map global kak-spell p ': kak-spell-previous<ret>' -docstring 'go to next spell error'
map global kak-spell r ': kak-spell-replace<ret>' -docstring 'suggest a list of replacements'
map global kak-spell x ': kak-spell-remove<ret>' -docstring 'remove the selection from the user dict'
}Note that kak-spell-enable does several things:
- Set a buffer scoped option
kak_spell_langthat is used by other commands - Add a highlighter so that spelling errors are colored with the
Errorface - Adds a
BufWritePosthook to spell check the buffer each time it gets written
The command kak-spell-disable undoes all of the above.
For now, there's no option to disable the hook, or to have it run in response to other events. Please open an issue if this bothers you.
You can discuss features of this plugin on discuss.kakoune.com.
I'd like to thank all the people who contributed code and ideas to make usage of this plugin easier.