---

Ⅰ. 插件描述

A simple task and time manager. Project moved here:

Ⅱ. 基本信息

创建日期：  2018-05-26 使用用户：  4 Github星：  210 插件作者：  Clément DOUIN

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'soywod/kronos-vim'

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

:source %
:PluginInstall

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

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'soywod/kronos-vim'

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

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'soywod/kronos-vim'

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

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/soywod/kronos.vim

Ⅳ. 文档说明

⚠️ Project archived. Have a look at unfog, its successor.

Kronos.vim

A simple task and time manager.

<p align="center">

</p>

Table of contents

• Requirements

• Usage

  • Create
  • Read
  • Update
  • Start/stop
  • Done
  • Hide done tasks
  • Context
  • Sort
  • Worktime
  • Delete
• Backend
• Import
• Mappings
• Contributing
• Changelog
• Credits

Requirements

• VIM v8+ or NVIM v0.3.4+ (not tested on lower versions)
• Python v3.3+ (check it with :echo has('python3') and :!python3 --version)

Usage

:Kronos

Then you can create, read, update, delete tasks using Vim mapping. The table
will automatically readjust when you save the buffer (:w).

Create

To create a task, you can:

• Write or copy a full table line: |id|desc|tags|active|due|
• Follow the Kronos format: <desc> <tags> <due>

![Create
task](https://user-images.githubusercontent.com/10437171/50438709-61a63800-08ef-11e9-8f49-aa02b6da7f3b.gif)

A tag should start by a +. You can add as many tags as you need.

A due should start by a :. There is 3 kinds of due:

• The absolute due: :DDMMYY:HHMM, which correspond to a specific date.
• The approximative due, which is a partial absolute, for eg. :DD,
  ::HH, :DDM:M. Kronos will try to find the closest date matching this
  due.
• The relative due, which is relative to the actual date. For eg. :1y,
  :2mo, :4h. Available units: y, mo, w, d, h, m.
  *Note: unit
  order should be respected, from the biggest to the smallest. 2y4mo24m is
  valid, 3m4d is not.*

Here some use cases:

Actual date	Given pattern	Due
03/03/2019 21:42	:4	04/03/2019 00:00
03/03/2019 21:42	:2	02/04/2019 00:00
03/03/2019 21:42	:0304 or :034	03/04/2019 00:00
03/03/2019 21:42	:3004 or 304	30/04/2019 00:00
03/03/2019 21:42	:0202	02/02/2020 00:00
03/03/2019 21:42	:020221	02/02/2021 00:00
03/03/2019 21:42	::22	03/03/2019 22:00
03/03/2019 21:42	::19	04/03/2019 19:00
03/03/2019 21:42	:4:2150	04/03/2019 21:50
03/03/2019 21:42	:2d	05/03/2019 21:42
03/03/2019 21:42	:1w10m	10/03/2019 21:52
03/03/2019 21:42	:1y13mo1h	03/04/2021 22:42

Note: the date format is DD/MM/YYYY HH:MM

Read

To show focused task details, press <K>:

![Read
task](https://user-images.githubusercontent.com/10437171/50438871-2f490a80-08f0-11e9-9ef9-a016a898947d.gif)

Update

To update a task, just edit the cell and save:

![Update
task](https://user-images.githubusercontent.com/10437171/50439213-7e436f80-08f1-11e9-8180-965d52ab7d52.gif)

For the due field, you need to use the Kronos due format (:18,
:20:1230, 2w...).

Start/stop

To start/stop a task, press <Enter>:

![Start/stop
task](https://user-images.githubusercontent.com/10437171/50439087-fcebdd00-08f0-11e9-8853-54639eaa2146.gif)

Done

To mark a task as done, delete the line:

![Done
task](https://user-images.githubusercontent.com/10437171/50439278-c367a180-08f1-11e9-9729-86554b116479.gif)

Hide done tasks

To show/hide done tasks, press <gh> (for go hide):

![Hide done
tasks](https://user-images.githubusercontent.com/10437171/50440820-278d6400-08f8-11e9-890c-b68d83f0f0fc.gif)

Context

The context filters tasks by a list of tags. Once set up:

• You will see only tasks containing at least one tag of your context
• When you create a task, all tags in your context will be assigned
  to it

To set up a context, press gc (for go to context), and type all tags you
want in your context (separated by spaces). Typing an empty context removes it:

![Set
context](https://user-images.githubusercontent.com/10437171/50439628-09713500-08f3-11e9-88e0-a5ed72c9134e.gif)

Sort

You can sort tasks by pressing gs (for ascending) or gS (for descending).
The sort depends on the position of the cursor. For eg, if it's in the ID
column, it will sort the ids.

*Note: once the tasks sorted, the buffer will be considered as modified, no
matter the result.*

Worktime

The worktime allows you to check how much time you spent on one or many tags,
grouped by day. Press gw (for go to worktime), and type the tags you want
to calculate the total worktime:

You can also add a beginning date with >DDMMYY:HHMM and a ending date with
<DDMMYY:HHMM. (they can be absolute dues or approximative dues, but not
relative dues). Here some valid options:

• tag1 tag2 >18 <20: worktime for tag1, tag2 between the 18th and the 20th
  of the current month
• tag1 >:10 : worktime for tag1 starting at 10AM of the current day
• tag2 <18:22 : worktime for tag2 ending at 10PM of the 18th of the current
  month

Delete

To delete a task, delete the line when [done tasks are
shown](#hide-done-tasks):

![Delete
task](https://user-images.githubusercontent.com/10437171/50439349-0295f280-08f2-11e9-8c26-e9f67698c59c.gif)

Backend

By default, Kronos stores tasks in a file
(/path/to/vim/pluggins/kronos.vim/.database). You can define an additionnal
backend (for now, only Taskwarrior is available):

let g:kronos_backend = 'file' | 'taskwarrior'

This way, tasks will be synchronized with Taskwarrior. It means you can manage
basic actions with Kronos, and manage advanced ones with Taskwarrior CLI.

*Note: the synchronization is only from Kronos to Taskwarrior. To synchronize
from Taskwarrior to Kronos, check the import section below.*

Import

If you want to import your Taskwarrior tasks into Kronos, you can use the
import.py script at the root folder of the plugin. Usage:

./import.py taskwarrior ./path/to/your/backlog.data

Note: this will erase the current database

Mappings

Here the default mappings:

Function	Mapping
Toggle task	<CR>
Show task infos	K
Set context	gc
Sort (asc)	gs
Sort (desc)	gS
Hide/show done tasks	gh
Show worktime	gw
Jump to the next cell	<C-n>
Jump to the prev cell	<C-p>
Delete in cell	dic
Change in cell	cic
Visual in cell	vic

You can customize them:

nmap <cr>   <plug>(kronos-toggle)
nmap K      <plug>(kronos-info)
nmap gc     <plug>(kronos-context)
nmap gs     <plug>(kronos-sort-asc)
nmap gS     <plug>(kronos-sort-desc)
nmap gh     <plug>(kronos-hide-done)
nmap gw     <plug>(kronos-worktime)
nmap <c-n>  <plug>(kronos-next-cell)
nmap <c-p>  <plug>(kronos-prev-cell)
nmap dic    <plug>(kronos-delete-in-cell)
nmap cic    <plug>(kronos-change-in-cell)
nmap vic    <plug>(kronos-visual-in-cell)

Contributing

Git commit messages follow the [Angular
Convention](https://gist.github.com/stephenparish/9941e89d80e2bc58a153), but
contain only a subject.

Use imperative, present tense: “change” not “changed” nor
“changes”
Don't capitalize first letter
No dot (.) at the end

Code should be as clean as possible, variables and functions use the snake case

1. A line should never contain more than 80 characters.

Tests should be added for each new functionality. Be sure to run tests before
proposing a pull request.

Changelog

• Jul. 24, 2019 - Add tasks sorting
• Jul. 23, 2019 - Add option to use Taskwarrior as backend
• May. 14, 2019 - Add relative due + rewrite datetime part in python3
• May. 13, 2019 - Add custom mapping
• May. 12, 2019 - Add script to import tasks from taskwarrior (thanks to KevCui)
• May. 11, 2019 - Remove sync support due to too many complications
• Dec. 31, 2018 - Worktime is now calculated also per day
• Dec. 26, 2018 - Refactor interface
  (Vimwiki like)
• Oct. 18, 2018 - ~Refactor code to match the [Kronos
  protocol](https://github.com/soywod/kronos)~
• Jul. 05, 2018 - Add context by tags
• Jun. 26, 2018 - ~Implement Gist sync feature~
• Jun. 25, 2018 - Add ability to mark tasks as undone
• Jun. 24, 2018 - Add option to show or hide done tasks
• Jun. 23, 2018 - Init changelog

Credits

• Taskwarrior, a task manager
• Timewarrior, a time manager
• vim-taskwarrior, a
  Taskwarrior wrapper for vim
• Vimwiki