mirror of
https://github.com/preservim/vim-litecorrect.git
synced 2025-11-12 11:53:48 -05:00
102 lines
3.0 KiB
Markdown
102 lines
3.0 KiB
Markdown
# vim-litecorrect
|
||
|
||
> Lightweight auto-correction for Vim
|
||
|
||
We type `teh` when we meant to type `the`. This plugin is to help us catch
|
||
the most common of these typos and correct each upon hitting the space bar
|
||
(or non-keyword character.)
|
||
|
||
Features of this plugin:
|
||
|
||
* Focused on the most common of typos that we make
|
||
* Uses Vim’s `iabbrev`
|
||
* Buffer-scoped behavior
|
||
* User-extendable
|
||
|
||
Note that this plugin is not a replacement for teh spell checker in Vim.
|
||
|
||
The default typos and their corrections are stored in a global dictionary:
|
||
|
||
```
|
||
let g:litecorrect#defaults =
|
||
\{'I' : ['i'],
|
||
\ 'The' : ['TEh', 'Teh'],
|
||
\ 'that' : ['htat'],
|
||
\ 'the' : ['hte', 'teh'],
|
||
\ 'this' : ['htis'],
|
||
\ 'then' : ['tehn'],
|
||
\ 'what' : ['waht'],
|
||
\}
|
||
```
|
||
|
||
Note that the corrections are stored as key-value entries where the value
|
||
is a list of the common misspellings for the key.
|
||
|
||
## Requirements
|
||
|
||
May require a recent version of Vim.
|
||
|
||
## Installation
|
||
|
||
Install using Pathogen, Vundle, Neobundle, or your favorite Vim package
|
||
manager.
|
||
|
||
## Configuration
|
||
|
||
Because you may not want auto-corrections in all file types you edit, you can
|
||
configure this plugin per file type. For example, to enable litecorrect support
|
||
in `markdown` and `textile` files, place in your `.vimrc`:
|
||
|
||
```vim
|
||
augroup litecorrect
|
||
autocmd!
|
||
autocmd FileType markdown call litecorrect#init()
|
||
autocmd FileType textile call litecorrect#init()
|
||
augroup END
|
||
```
|
||
|
||
Alternatively, you can build on the defaults by providing your own corrections:
|
||
|
||
```
|
||
let user_dict = {
|
||
\ 'maybe': ['mabye'],
|
||
\ 'medieval': ['medival', 'mediaeval', 'medevil'],
|
||
\ 'then': ['hten'],
|
||
\ }
|
||
augroup litecorrect
|
||
autocmd!
|
||
autocmd FileType markdown call litecorrect#init(user_dict)
|
||
autocmd FileType textile call litecorrect#init(user_dict)
|
||
augroup END
|
||
```
|
||
|
||
The corrections you provide will be in addition to those in those in
|
||
`g:litecorrect#defaults`. Where there’s a conflict, your correction will
|
||
prevail.
|
||
|
||
## Criteria to add to defaults
|
||
|
||
Suggestions for adding to the defaults are welcome, but good evidence is
|
||
needed that they are common typos.
|
||
|
||
## Related
|
||
|
||
For a more comprehensive approach, check out
|
||
[vim-autocorrect](https://github.com/panozzaj/vim-autocorrect).
|
||
|
||
## See also
|
||
|
||
If you like this plugin, you may like these other ones from the same author:
|
||
|
||
* [vim-quotable](http://github.com/reedes/vim-quotable) - extends Vim to support typographic (‘curly’) quotes
|
||
* [vim-lexical](http://github.com/reedes/vim-lexical) - Building on Vim’s spell-check and thesaurus/dictionary completion
|
||
* [vim-thematic](http://github.com/reedes/vim-thematic) — Conveniently manage Vim’s appearance to suit your task and environment
|
||
* [vim-writer](http://github.com/reedes/vim-writer) - Extending Vim to better support writing prose and documentation
|
||
|
||
## Future development
|
||
|
||
If you have any ideas on improving this plugin, please post them to the github
|
||
project issue page.
|
||
|
||
<!-- vim: set tw=74 :-->
|