---

Ⅰ. 插件描述

Lightweight auto-correction for Vim

Ⅱ. 基本信息

创建日期：  2013-12-29 使用用户：  144 Github星：  70 插件作者：  Reed Es

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'reedes/vim-litecorrect'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'reedes/vim-litecorrect'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'reedes/vim-litecorrect'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/reedes/vim-litecorrect

Ⅳ. 文档说明

# 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
• Pure Vimscript using the efficient iabbrev
• Included auto-correct entries limited to 350 (in 2016) to ensure fast
  loading (see expansion policy below)
• Buffer-scoped behavior (won’t touch global settings)

Note that this plugin is not intended to be a replacement for teh spell
checker in Vim. It’s best used with spell-check enabled.

Expansion policy

Since it was created in 2013, litecorrect has limited the number of
default auto-correct entries (such as teh->the) to 300, avoiding the
excessive load times of comparable plugins and focusing on the most common
of typos.

Meanwhile, the adoption of new disk technologies reduces the penalty we
pay when initializing plugins. This provides litecorrect an opportunity
to grow while not significantly impacting load-time performance.

Henceforth, litecorrect will expand by up to 50 entries each year. For
2016 it will grow to 350 entries. For 2017, 400 entries, and so on.

Requirements

May require a recent version of Vim.

Installation

litecorrect is best installed using a Vim package manager, such
as Vundle, Plug, NeoBundle, or Pathogen.

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:

set nocompatible
filetype plugin on       " may already be in your .vimrc

augroup litecorrect
  autocmd!
  autocmd FileType markdown,mkd call litecorrect#init()
  autocmd FileType textile call litecorrect#init()
augroup END

Optionally, you can build on the defaults by providing your own corrections.
Note that the corrections are stored as key-value entries where the value is
a list of the common misspellings for the key.

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 the defaults. Where
there’s a conflict, your correction will prevail.

Correct previous misspelling

To augment litecorrect you may find the following key mapping useful.
It forces the top-ranked correction on the first misspelled word
before the cursor.

Add to your .vimrc with a key mapping of your choice:

nnoremap <C-s> [s1z=<c-o>
inoremap <C-s> <c-g>u<Esc>[s1z=`]A<c-g>u

It generates a fresh undo point prior to the correction so
that you can conveniently undo if necessary.

Note that litecorrect does not map any keys.

Typographic characters

By default, straight quotes will be used in corrections. For example:

Im -> I'm
shouldnt -> shouldn't
thats -> that's

If you prefer typographic (“curly”) quotes, install an educating quote plugin
like vim-textobj-quote that will automatically transform straight quotes
to curly ones in your typing, including your corrections. For example:

I'm -> I’m
shouldn't -> shouldn’t
that's -> that’s

Criteria to add (or modify) default entries

Note that the number of default entries will be limited for fast loading. See
policy above.

Suggestions for improving the defaults are welcome, but good evidence is needed
that a suggested auto-correct entry adds value to the list.

Related projects

If load time performance isn’t an issue, you can seek a more comprehensive
approach:

• wordlist.vim - nearly 800 entries
• vim-autocorrect - over 12K entries!

An alternative that builds on tpope/vim-abolish:

• vim-correction - approx. 700 entries

See also

If you find this plugin useful, you may want to check out these others by
@reedes:

• vim-colors-pencil - color scheme for Vim inspired by IA Writer
• vim-lexical - building on Vim’s spell-check and thesaurus/dictionary completion
• vim-one - make use of Vim’s +clientserver capabilities
• vim-pencil - rethinking Vim as a tool for writers
• vim-textobj-quote - extends Vim to support typographic (‘curly’) quotes
• vim-textobj-sentence - improving on Vim's native sentence motion command
• vim-thematic - modify Vim’s appearance to suit your task and environment
• vim-wheel - screen-anchored cursor movement for Vim
• vim-wordy - uncovering usage problems in writing
• vim-wordchipper - power tool for shredding text in Insert mode

Future development

If you’ve spotted a problem or have an idea on improving this plugin,
please post it to the github project issue page.