Home

Awesome

⏱ Unfog.vim

Vim plugin for Unfog CLI task & time manager.

image

Table of contents

Installation

First you need to install the unfog CLI:

curl -sSL https://raw.githubusercontent.com/soywod/unfog/master/install.sh | sh

Then you can install this plugin with your favorite plugin manager. For eg: with vim-plug, add to your .vimrc:

Plug "soywod/unfog.vim"

Then:

:PlugInstall

Usage

It is recommanded to first read the Unfog CLI documentation to understand the concept.

To list tasks:

:Unfog

Then you can manage tasks using Vim mapping. The table will automatically readjust on buffer save (:w). Also have a look at the mappings section for special actions.

Add

gif

Info

Default mapping: K (Shift-k).

gif

Edit

gif

Toggle

Default mapping: <CR> (Enter).

gif

Done

gif

Context

Default mapping: gc (Go to Context).

gif

Worktime

Default mapping: gw (Go to Worktime).

gif

Mappings

Here the default mappings:

FunctionMapping
List done tasksgd
List deleted tasksgD
Toggle task<CR>
Show task infosK
Set contextgc
Show worktimegw
Jump to the next cell<C-n>
Jump to the prev cell<C-p>
Delete in celldic
Change in cellcic
Visual in cellvic

You can customize them:

nmap gd     <plug>(unfog-list-done)
nmap gD     <plug>(unfog-list-deleted)
nmap <cr>   <plug>(unfog-toggle)
nmap K      <plug>(unfog-info)
nmap gc     <plug>(unfog-context)
nmap gw     <plug>(unfog-worktime)
nmap <c-n>  <plug>(unfog-next-cell)
nmap <c-p>  <plug>(unfog-prev-cell)
nmap dic    <plug>(unfog-delete-in-cell)
nmap cic    <plug>(unfog-change-in-cell)
nmap vic    <plug>(unfog-visual-in-cell)

Contributing

Git commit messages follow the Angular Convention, but contain only a subject.

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

Code should be as clean as possible, variables and functions use the camel case convention. 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.

Credits