https://github.com/freitass/todo.txt-vim

Vim plugin for Todo.txt
https://github.com/freitass/todo.txt-vim

Last synced: about 1 month ago
JSON representation

Vim plugin for Todo.txt

• Host: GitHub
• URL: https://github.com/freitass/todo.txt-vim
• Owner: freitass
• Created: 2011-05-31T01:05:40.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2024-03-27T13:53:44.000Z (9 months ago)
• Last Synced: 2024-08-01T16:56:18.635Z (4 months ago)
• Language: Vim Script
• Homepage:
• Size: 91.8 KB
• Stars: 483
• Watchers: 21
• Forks: 121
• Open Issues: 28
• Metadata Files:
  • Readme: README.markdown

Awesome Lists containing this project

• my-awesome-github-stars - freitass/todo.txt-vim - Vim plugin for Todo.txt (Vim Script)

README

        
### (Apr 2015) Important note: mappings were changed!

As it was suggested on issue [#28](https://github.com/freitass/todo.txt-vim/issues/28) (and as recommended by vim's documentation), all mappings were changed to use `` instead of ``. If you don't have `maplocalleader` set on your environment then yours is probably `\`. For more information on that regard, please take a look at `:h `.

### (Jan 2016) Note: Overdue date highlight and Python Optional dependency

A new feature was added to highlight dates in overdue tasks as an Error (as suggested on issue [#44](https://github.com/freitass/todo.txt-vim/issues/44)). It depends on a Python library, however, and as such will only be able to work if your version of Vim was compiled with the `+python` option (as most common versions do).

If your Vim installation does **not** have Python support, this plugin **will work just fine** but this feature will be disabled.

### Quick install

    git clone git://github.com/freitass/todo.txt-vim.git

    cd todo.txt-vim

    cp -R * ~/.vim

Also make sure your .vimrc contains

    

    syntax on

    filetype plugin on

You can set the `` in your .vimrc file with 

    

    let maplocalleader=""

This plugin gives syntax highlighting to [todo.txt](http://todotxt.com/) files. It also defines a few mappings, to help with editing these files:

Sorting tasks:  

`s`   Sort the file  

`s+`  Sort the file on +Projects  

`s@`  Sort the file on @Contexts  

`sd`  Sort the file on dates  

`sdd`  Sort the file on due dates  

Edit priority:  

`j`   Decrease the priority of the current line  

`k`   Increase the priority of the current line  

`a`   Add the priority (A) to the current line  

`b`   Add the priority (B) to the current line  

`c`   Add the priority (C) to the current line  

Date:  

`d`   Set current task's creation date to the current date  

`date`        (Insert mode) Insert the current date  

Mark as done:  

`x`   Mark current task as done  

`X`   Mark all tasks as done  

`D`   Move completed tasks to done.txt  

This plugin detects any text file with the name todo.txt or done.txt with an optional prefix that ends in a period (e.g. second.todo.txt, example.done.txt).

If you want the help installed, run ":helptags ~/.vim/doc" inside vim after having copied the files.

Then you will be able to get the commands help with: `:h todo.txt`.