diff --git a/README.markdown b/README.markdown index 07f609d..7cde4a2 100644 --- a/README.markdown +++ b/README.markdown @@ -15,6 +15,7 @@ * Includes 16 dictionaries covering different types of word usage * Buffer-scoped configuration (leaves your global settings alone) * Unicode-friendly, including support for ‘typographic quotes’ +* Supports a user-configurable ring of dictionaries ## What is _wordy_? @@ -55,6 +56,8 @@ package manager. ## Configuration +### On demand + You’ll typically use this plugin on-demand. It does not require any special configuration. @@ -74,6 +77,37 @@ Press ENTER or type command to continue As instructed, press the enter key and it will disturb you no longer, at least until _wordy_ feels the urge to build again. +### Ring + +Define your own ring of dictionaries, overriding the default one in your +`.vimrc`: + +``` +let g:wordy#ring = [ + \ 'weak', + \ ['being', 'passive-voice', ], + \ 'business-jargon', + \ 'weasel', + \ 'puffery', + \ ['problematic', 'redundant', ], + \ ['colloquial', 'idiomatic', 'similies', ], + \ ] +``` + +You can navigate the ring with the following commands: + +``` +:NextWordy +:PrevWordy +``` + +Optionally create a key map in your `.vimrc` to rapidly cycle through the +ring: + +``` +nnoremap K :NextWordy +``` + ## Using _wordy_ You’ll use the commands that follow to enable _wordy_. To disable it and @@ -92,7 +126,7 @@ go to those words flagged by _wordy_. ### Weak and lazy usage ``` -:WeakWordy +:WeakWordy (weak) ``` Weak and lazy words are common in first drafts. @@ -120,8 +154,8 @@ asking whether it detracts from the point you are trying to make. ### Redundant and problematic usage ``` -:WordyWordy -:ProblemWordy +:WordyWordy (redundant) +:ProblemWordy (problematic) ``` Did you ever receive an ‘advance warning’ when a mere warning would do? @@ -138,15 +172,16 @@ targeted by _ProblemWordy_. [1]: http://www.dailywritingtips.com/50-problem-words-and-phrases/ -### Puffery and Jargonese +### Puffery and Jargon > “The man embodies _authenticity_; his _disruptive_ ideas on > _self-actualization_ reflect his _dynamic_ and _transformative_ -> personality.” (puffery and jargonese) +> personality.” (puffery and jargon) ``` -:PuffWordy -:JargonWordy +:PuffWordy (puffery) +:JargonWordy (business-jargon) +:ArtJargonWordy (art-jargon) ``` Instead of puffery, demonstrate through details. @@ -158,7 +193,7 @@ Instead of puffery, demonstrate through details. ### Manipulative language ``` -:WeaselWordy +:WeaselWordy (weasel) ``` Words can be used to hide or obscure a weak position, or to cast doubt on @@ -175,8 +210,8 @@ will seek to purge such loaded language from your writing. ### To be and the passive voice ``` -:BeingWordy -:PassiveWordy (includes BeingWordy) +:BeingWordy (being) +:PassiveWordy (being, passive-voice) ``` You may find this dictionary useful in avoiding overuse of the many forms @@ -185,7 +220,7 @@ of the verb to be, often found in overly-passive sentences. ### Colloquialisms, Idioms, and Similies ``` -:TriteWordy +:TriteWordy (colloquial, idiomatic, similies) ``` Dictionaries for uncovering the tired cliché, including colloquial and @@ -194,10 +229,10 @@ idiomatic phrases scraped from Wiktionary and Wikipedia. ### Miscellaneous ``` -:SaidWordy -:OpineWordy -:AintWordy -:VagueTimeWordy (renamed from TimeWordy) +:SaidWordy (said-synonyms) +:OpineWordy (opinion) +:AintWordy (contractions) +:VagueTimeWordy (vague-time) ``` A few dictionaries to serve specific needs. diff --git a/autoload/wordy.vim b/autoload/wordy.vim index e0df01a..559c766 100644 --- a/autoload/wordy.vim +++ b/autoload/wordy.vim @@ -22,7 +22,8 @@ function! wordy#init(...) abort endif " switch to usage dictionaries, building if needed - let l:dicts = get(l:args, 'd', []) + let l:d = get(l:args, 'd', []) " may be string or list + let l:dicts = (type(l:d) == type([])) ? l:d : [l:d] if len(l:dicts) let l:dst_paths = [] " TODO &spelllang) @@ -58,7 +59,25 @@ function! wordy#init(...) abort exe 'setlocal spelllang=' . l:lang . ',' . join(l:dst_paths, ',') setlocal spell endif + echohl ModeMsg | echo 'wordy: ' . join(l:dicts, ', ') | echohl NONE endif endfunction +function! wordy#jump(mode) + " mode=1 next in ring + " mode=-1 prev in ring + let l:avail_count = len(g:wordy#ring) + if l:avail_count == 0 | return | endif + if g:wordy_ring_index < 0 + " ring navigation not initialized; start at begin or end + let g:wordy_ring_index = + \ a:mode == 1 + \ ? 0 + \ : (l:avail_count - 1) + else + let g:wordy_ring_index = (g:wordy_ring_index + a:mode) % l:avail_count + endif + call wordy#init({ 'd': g:wordy#ring[ g:wordy_ring_index ]}) +endfunction + " vim:ts=2:sw=2:sts=2 diff --git a/plugin/wordy.vim b/plugin/wordy.vim index 0dbf9a9..dcad5cd 100644 --- a/plugin/wordy.vim +++ b/plugin/wordy.vim @@ -18,42 +18,45 @@ let g:wordy_dir = fnamemodify(resolve(expand(':p')), ':h:h') command -nargs=0 NoWordy call wordy#init({}) -command -nargs=0 BeingWordy call wordy#init({ 'd': ['being',] }) +command -nargs=0 BeingWordy call wordy#init({ 'd': 'being' }) command -nargs=0 PassiveWordy call wordy#init({ 'd': ['passive-voice', 'being',] }) -command -nargs=0 WeakWordy call wordy#init({ 'd': ['weak',] }) -command -nargs=0 LazyWordy call wordy#init({ 'd': ['weak',] }) +command -nargs=0 WeakWordy call wordy#init({ 'd': 'weak' }) +command -nargs=0 LazyWordy call wordy#init({ 'd': 'weak' }) -command -nargs=0 ProblemWordy call wordy#init({ 'd': ['problematic',] }) -command -nargs=0 WordyWordy call wordy#init({ 'd': ['redundant',] }) +command -nargs=0 ProblemWordy call wordy#init({ 'd': 'problematic' }) +command -nargs=0 WordyWordy call wordy#init({ 'd': 'redundant' }) -command -nargs=0 JargonWordy call wordy#init({ 'd': ['business-jargon', 'art-jargon',] }) -command -nargs=0 PuffWordy call wordy#init({ 'd': ['puffery',] }) -command -nargs=0 WeaselWordy call wordy#init({ 'd': ['weasel',] }) +command -nargs=0 JargonWordy call wordy#init({ 'd': 'business-jargon' }) +command -nargs=0 ArtJargonWordy call wordy#init({ 'd': 'art-jargon' }) +command -nargs=0 PuffWordy call wordy#init({ 'd': 'puffery' }) +command -nargs=0 WeaselWordy call wordy#init({ 'd': 'weasel' }) -command -nargs=0 TriteWordy call wordy#init({ 'd': [ 'colloquial', 'idiomatic', 'similies',] }) +command -nargs=0 TriteWordy call wordy#init({ 'd': ['colloquial', 'idiomatic', 'similies',] }) " tools for formal and objective writing -command -nargs=0 VagueTimeWordy call wordy#init({ 'd': ['vague-time',] }) -command -nargs=0 OpineWordy call wordy#init({ 'd': ['opinion',] }) -command -nargs=0 SaidWordy call wordy#init({ 'd': ['said-synonyms',] }) -command -nargs=0 AintWordy call wordy#init({ 'd': ['contractions',] }) +command -nargs=0 VagueTimeWordy call wordy#init({ 'd': 'vague-time' }) +command -nargs=0 OpineWordy call wordy#init({ 'd': 'opinion' }) +command -nargs=0 SaidWordy call wordy#init({ 'd': 'said-synonyms' }) +command -nargs=0 AintWordy call wordy#init({ 'd': 'contractions' }) -" tools for creative writing -command -nargs=0 CreativeWordy call wordy#init({ 'd': [ 'being', - \ 'colloquial', - \ 'idiomatic', - \ 'business-jargon', - \ 'art-jargon', - \ 'weasel', - \ 'opinion', - \ 'passive-voice', - \ 'puffery', - \ 'redundant', - \ 'similies', - \ 'weak', - \ ]}) +command -nargs=0 NextWordy call wordy#jump(1) +command -nargs=0 PrevWordy call wordy#jump(-1) +let g:wordy_ring_index = -1 " start at beginning + +" user configurable ring of dictionaries +if !exists('g:wordy#ring') + let g:wordy#ring = [ + \ 'weak', + \ ['being', 'passive-voice', ], + \ 'business-jargon', + \ 'weasel', + \ 'puffery', + \ ['problematic', 'redundant', ], + \ ['colloquial', 'idiomatic', 'similies', ], + \ ] +endif let &cpo = s:save_cpo unlet s:save_cpo