imdone

  _   __  __   _____                         
 (_) |  \/  | |  __ \                        
  _  | \  / | | |  | |   ___    _ __     ___ 
 | | | |\/| | | |  | |  / _ \  | '_ \   / _ \
 | | | |  | | | |__| | | (_) | | | | | |  __/
 |_| |_|  |_| |_____/   \___/  |_| |_|  \___|

###Keep your tasks in your work!!! Create tasks in any file using markdown syntax and organize them with a local kanban board. Your tasks are in your files, so you can share your board on github, dropbox, or any other cloud storage provider.

###Tasks are just markdown links!!!

Put a task at the top of a list called "todo"
[this is a task](#todo:10)

In javascript code
//[this is a task in javascript code](#todo:0)

Put a task on the bottom of a list called "doing" (giving it a sort value of 1000 will put it at the bottom unless you have tons of tasks in the list)
[this is a task in doing](#todo:20)

Tasks are sorted by the number after the :

Prerequisites

• nodejs is installed
• npm is installed

Install

npm install -g imdone

Run

• open a terminal window and navigate to your local project folder and run:
  imdone -o

• You can start it in multiple directories and switch between projects in the UI

• Here's the help output

  Usage: imdone [options]
  
  Options:
  
    -h, --help                output usage information
    -V, --version             output the version number
    -o, --open                Open imdone in the default browser
    -s, --stop                Stop imdone server
    -d, --dirs <directories>  A comma separated list of project directories
  
  Examples:
  
    Open imdone in a browser with the current working directory as the project root
  
    $ imdone -o
  
    Open imdone in a browser with list of project directories
  
    $ imdone -o -d projects/imdone,projects/myproject
  

How you can help

If you like iMDone and want to help me make it better, you can make a contribution at pledgie. Every donation is very much appreciated.

If you have some spare time, then there is no better way to help an open source project than to get involved in one of the following ways.

• Help diagnose and report problems
• Suggest fixes by sending in patches
• Improve the code
• Help with unit and end-to-end testing
• Provide peer support on our forum
• Publish an article on your blog (send the link) to educate others regarding some aspect of the project
• Help with missing documentation

See it in action!

fork this repository and run imdone in your local copy. I use imdone for keep track of development of imdone

imdone will create a directory named imdone that will contain your custom configuration and a file to keep your lists in order

• you should keep the imdone directory in source control

Filter by file name

• You can filter by the file name the task are in.
• As you type in the "filter by file name" field, tasks are filtered

Configuration

After running imdone for the first time, modify imdone/imdone.js in your project directory. The default config looks like this. Your imdone.js will extend this.

module.exports = {
	include:/^.*$/,
	exclude:/^(node_modules|imdone|target)\/|\.(git|svn)\/|\~$|\.(jpg|png|gif|swp)$/,
	//github : {url : "http://www.github.com/piascikj/imdone"}, //Use this if you want links to point at github
	marked : {
		gfm: true,
		pedantic: false,
		sanitize: true
	}
};

Disclaimer

iMDone has only been tested on my Ubuntu 12.04 desktop using chrome 23.0.x as the default browser. It should work on any machine that has nodejs and npm installed and for auto update of boards, a browser that supports websockets.

Roadmap

• [Support editing files directly using Ace editor](#done:40)
• Show file explorer when editing files
• Enable ctrl+s for save (don't close file on save)
• Enable svn and git commit after file changes
• [User should be able to create and edit existing files using Ace editor](#doing:0)
• Preview of markdown files
• Convert front end to use backbone.js and require.js
• respect marked configuration in client javascript

Release notes

####0.1.25

• Sort lists in dropdown menu
• Open files for editing
• Loading dependencies with require (Strange workaround for ace)

####0.1.24

• Print source and markdown preview

####0.1.23

• Upgrade express to latest version
• Preview markdown files

####0.1.22

• Fix rename list bug introduced in last version

####0.1.20

• Open multiple projects at once from command line

####0.1.19

• Bug fixes. Sorting tasks was broken

####0.1.18

• Dark theme
• Ace editor

####0.1.17

• Now using commander for better cli user experience

####0.1.14

• replace mu2 with Handlebars

####0.1.13

• Moved open page to open cli option
• switched to socket.io for near real-time updates

####0.1.11

• Now able to hide a list from board using hidden #####imdone/data.js is now formatted like this

  { lists:[Array of list names], hidden:[Array of list names to hide] }

####0.1.10

• Source view if github is not set
• Default lists are respected if added to imdone/data.js
• Lists won't be removed unless specifically removed in ui or imdone/data.js

####0.1.8

• Sort is fixed for multiple projects

####0.1.7

• Start in multiple project directories

####0.1.6

• Added filter by file name

####0.1.4

• Use line number when loading page in github

####0.1.3

• include added to config for files to include. Order is include > Exclude

####0.1.2

• Using websockets to refresh board on changes