bnbeckwith / writegood-mode

Minor mode for Emacs to improve English writing
http://bnbeckwith.com/code/writegood-mode.html
462 stars 31 forks source link
emacs emacs-lisp emacs-mode

: (add-to-list 'load-path "path/to/writegood-mode") : (require 'writegood-mode) : (global-set-key "\C-cg" 'writegood-mode)

I use the command key above to start the mode when I wish to check my writing.

Alternatively, this package is also available on MELPA. If installed through the package manager, then only the global key customization would be necessary.

: (global-set-key "\C-c\C-gg" 'writegood-grade-level) : (global-set-key "\C-c\C-ge" 'writegood-reading-ease)

The user is free to customize three main portions of the mode.

** Faces

The three faces used pull from the default warning face and add subtle backgrounds. There is a separate face for each check performed.

** Weasel Words

There is a large list of included weasel words, but you may have your own. See the ~write-good-weasel-words~ variable to modify this list.

Additionally, if you require more than a list of words to mark up your content, then there is a custom variable, ~writegood-weasel-words-additional-regexp~ that allows a custom regular expression for matching whatever you heart desires (expressed as a regex).

** Passive Voice Irregulars

There is also a list of irregular passive voice verbs. These are the verbs that do not end in 'ed' to signify past tense. This variable allow the user to modify the list as needed.

Similar to weasel words, the custom variable ~writegood-passive-voice-irregulars-additional-regexp~ allows the use of an additional regular expression to highlight passive voice irregulars.