vim-tautology

Ⅰ. 插件描述

Vim plugin for marking recurring words in text

Ⅱ. 基本信息

创建日期：  2018-06-03
使用用户：  1
Github星：  3
插件作者：  Evgeniy

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加: 
Plugin 'egryaznov/vim-tautology'
… 然后在Vim中运行以下命令: 
:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加: 
NeoBundle 'egryaznov/vim-tautology'
… 然后在Vim中运行以下命令: 
:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加: 
Plug 'egryaznov/vim-tautology'
… 然后在Vim中运行以下命令: 
:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令: 
cd ~/.vim/bundle
git clone https://github.com/egryaznov/vim-tautology

Ⅳ. 文档说明

This repository contains sources for a vim plugin that detects and marks recurring words in your text.

Description

If you are like me then you often repeat yourself when writing a piece of English text. The same word can occur multiple times in the same
paragraph, which makes a reader bored and frustrated. For instance, consider the following passage:

I was in school today. School is still the same old, dull place that it always was. Today an old man came to me and asked about my

  1. I didn't answer because I was late for school.

Notice that the words "school", "old", "today", "place" are redundant and must be replaced to increase the readability of the text.
Such pesky recurring words can be hard to trace, so I've created this plugin to facilitate the process.

The plugin marks all tautologies in a given piece of text by prefixing them with a specified symbol, '@' by default.
Watch the demo:
Alt Link

How To Use

There are two pre-defined commands TautologyMark and TautologyClear. The former marks all tautologies in selected text, and
latter removes all inserted marks. Step-by-step usage:

  1. Set the variable g:tautology_dir to the path to directory of this plugin. Default is ~/.vim/plugged/vim-tautology.
  2. Select the text you want to snoop for tautologies, for example with vip:
  3. Run :TautologyMark

**I @was in school @today. School is still the same @old, dull @place that it always @was. @Today an @old man came to me and asked
about my @place. I didn't answer because I @was late for school.**

  1. Circle through with /@\w*, edit, remove or replace them with synonyms, etc...
  2. When you done, simply gv and run :TautologyClear, this will remove all marks that are still left.

Installation and Prerequisites

Install via your favorite vim plugin manager. I suggest using vim-plug, just place the
following in your .vimrc:

Plug 'egryaznov/vim-tautology'

You will need the last version of Vim and the third version of python interpreter to run the plugin. Make sure the command python3 is
available on your system.

!IMPORTANT!

Manually set the path to the directory of this plugin by assigning it to the variable g:tautology_dir. For example, default is:
let g:tautology_dir = ~/.vim/plugged/vim-tautology/. Change it if you either of Windows or not using vim-plug.

Configuration

There are 6 main variables that let you control the behaviour of this plugin:

  1. g:tautology_dir. Path to the directory of this plugin. Please set this variable manually to ensure the correct workings of the plugin. Default is ~/.vim/plugged/vim-tautology.
  2. g:tautology_mark. The string that will be used as a prefix to recurring words. Default value is @.
  3. g:tautology_stop_words. The list of words that are too ubiquitous to consider, like "and", "the", "as" and so on. The words in this list
    will be omitted when marking tautologies. Default is `['I', 'the', 'a', 'an', 'to', 'be', 'of', 'and', 'in', 'that', 'this',

'as']`, but now it cannot be appended, only redefined.

  1. g:tautology_min_length. Skip words which are below this length. Useful to avoid marks clumping. Default is 4. It's not
    advisable to set it below 1.
  2. g:tautology_window_size. Controls how many words behind the examined word is compared with. Default is 30.
  3. g:tautology_skip. Controls how many words directly before the examined word is skipped to prevent overabundance of marks.

Last two variables define the so-called window of tautologies. For example, suppose window_size = 6, tautology_skip = 2 and current
word is dog, then the window in the following text will be:

The quick [brown fox jumps over] the lazy dog.

Mappings

Of course, typing all these commands is laborious, so you can set g:tautology_mappings = 1 to use gz as :TautologyMark and gZ as
:TautologyClear. Please note that these mappings work only in visual mode.

Issues

Currently a sharp symbol # cannot be set as a mark, because Vim treats it as a name of alternate file (see :h alternate-file).
Avoid it and use @ instead. This problem may be fixed soon.

The global variable g:tautology_stop_words cannot be appended with +=, only redefined.

添加新评论