---

Ⅰ. 插件描述

version-control friendly text formatting

Ⅱ. 基本信息

创建日期：  2016-11-19 使用用户：  2 Github星：  18 插件作者：  Enno Nagel

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'konfekt/vim-sentence-chopper'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'konfekt/vim-sentence-chopper'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'konfekt/vim-sentence-chopper'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/konfekt/vim-sentence-chopper

Ⅳ. 文档说明

This Vim plug-in furnishes

• an operator mapping gw in normal mode, for example gwip operates on a paragraph,
• a mapping gww (and gwgw) in normal mode that operates on a single line,
• a mapping gw that operates on the visual selection, and
• a command ChopSentences that operates on given range (equal to the whole buffer if unspecified)

that put each sentence onto a single line.

That is, lines are only broken at punctuation marks .?! (customizable by the variable g:punctuation_marks) for better version control of prose such as markdown, tex or text files.

For best results, ensure that latexindent is installed and the folder that contains its executable is listed in $PATH (respectively in %PATH% on Microsoft Windows).
This formatter will also distinguish TeX markup from prose to preserve syntactic line breaks.

Usage

For example, hitting gwip on

  Hello! How are you? Fine. And you?

turns it into

  Hello!
  How are you?
  Fine.
  And you?

Configuration

The variable g:punctuation_marks defines punctuation marks at which sentences are split up other than .;
it is by default set to

  let g:punctuation_marks = '?!'

The variable g:latexindent defines whether latexindent should be used by default;
it is by default set to

  let g:latexindent = 1

The variable g:latexindent_options defines the command-line options passed to latexindent as listed by latexindent -h;
it is by default set to

  let g:latexindent_options = ''

The variable g:latexindent_yaml_options defines the documented YAML options passed to latexindent;
it is by default set to

  let g:latexindent_yaml_options = ''

For example, to split up sentences after . or ; or : instead of . or ? or !, and put every sentence in parentheses onto its proper line, add to your vimrc

let g:latexindent_yaml_options = 'modifyLineBreaks:oneSentencePerLine:sentencesEndWith:'
       \ . 'other: \;|\:' . ';'
       \ . 'questionMark: 0' . ';'
       \ . 'exclamationMark: 0' . ','
       \ . 'modifyLineBreaks:oneSentencePerLine:' . 'sentencesFollow:other: "\)"' . ','
       \ . 'modifyLineBreaks:oneSentencePerLine:' . 'sentencesBeginWith:other: [a-z]'

Mappings

To change mappings, for example, to use zy instead of gw, add the lines

    nmap zy <plug>(ChopSentences)
    xmap zy <plug>(ChopSentences)

to your vimrc.

Hints

To replace (or delete, or any other operation by Vim) up to the next punctuation mark, say . and ,;:!?, add

onoremap <silent> . :<c-u>call search('\v\C%(%([^[:digit:]IVX]\|[)''"])\zs[.]\|[,;:!?])[[:space:])''"]\|[.,;:!?]$','W')<CR>

to your vimrc!
Then, for example, hitting c. will change and d. delete the text up to the next punctuation mark.
Say c. turns That's*it, Sir., where * stands for the cursor position, into That's*, Sir.
This can be thought of as a counterpart to Vim's built-in C and D commands for prose.

To normalize Unicode Homoglyphs, for example, of white spaces and punctuation marks, before chopping sentences, see the Vim plug-in vim-unicode-homoglyphs that highlights and normalizes Unicode homoglyphs.