---

Ⅰ. 插件描述

Bring the beauty of the Pomodoro technique to (Neo)Vim

Ⅱ. 基本信息

创建日期：  2017-09-26 使用用户：  3 Github星：  3 插件作者：  Reinaldo Molina

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'rmolin88/pomodoro-vim'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'rmolin88/pomodoro-vim'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'rmolin88/pomodoro-vim'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/rmolin88/pomodoro.vim

Ⅳ. 文档说明

Vim-Pomodoro

vim-pomodoro is a (Neo)Vim plugin for the Pomodoro time management technique. This is a fork that mitigate some issues with the original plugin.

It requires the timers feature.

Usage

The usage of vim-pomodoro is simple. :PomodoroStart [pomodoro_name] starts a new pomodoro.
The parameter pomodoro_name is optional. After a pomodoro has ended, a confirmation dialog will
remind you to take a break. When the break has ended, another dialog will ask you if you want
to start a new pomodoro. Furthermore, the remaining time of a pomodoro can be displayed in the
statusline of vim.

If you do not want vim-pomodoro to use popup windows but text dialogs inside Vim, add
set guioptions+=c to your ~/.gvimrc. Please note that this will globally disable
popup notification windows in Vim.

Also, in addition to the default notifications inside vim, vim-pomodoro allows you to add
further external notifications, such as sounds, system-notification popups etc.

Configuration

Add the following options to your ~/.vimrc to configure vim-pomodoro

" Duration of a pomodoro in minutes (default: 25)
let g:pomodoro_time_work = 25

" Duration of a break in minutes (default: 5)
let g:pomodoro_time_slack = 5 

" Log completed pomodoros, 0 = False, 1 = True (default: 0)
let g:pomodoro_do_log = 0 

" Path to the pomodoro log file (default: /tmp/pomodoro.log)
let g:pomodoro_log_file = "/tmp/pomodoro.log" 

To display the remaining time of a pomodoro in your statusline, add

set statusline=%#ErrorMsg#%{PomodoroStatus()}%#StatusLine# 

to your ~/.vimrc

Bells and Whistles

Notifications outside vim can be enabled through the option g:pomodoro_notification_cmd.
For instance, to play a sound file after each completed pomodoro or break, add something like

let g:pomodoro_notification_cmd = "mpg123 -q ~/.vim/pomodoro-notification.mp3"

to your ~/.vimrc. System-wide notifications can, for instance, be done via zenity and
the option

let g:pomodoro_notification_cmd = 'zenity --notification --text="Pomodoro finished"''

Installation

The recommended installation method is via vim-plug.
Add:

Plug 'tricktux/vim-pomodoro'