Task
Sublime Text Task Plugin
Details
Installs
- Total 8K
- Win 4K
- Mac 2K
- Linux 1K
Jun 14 | Jun 13 | Jun 12 | Jun 11 | Jun 10 | Jun 9 | Jun 8 | Jun 7 | Jun 6 | Jun 5 | Jun 4 | Jun 3 | Jun 2 | Jun 1 | May 31 | May 30 | May 29 | May 28 | May 27 | May 26 | May 25 | May 24 | May 23 | May 22 | May 21 | May 20 | May 19 | May 18 | May 17 | May 16 | May 15 | May 14 | May 13 | May 12 | May 11 | May 10 | May 9 | May 8 | May 7 | May 6 | May 5 | May 4 | May 3 | May 2 | May 1 | Apr 30 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 0 | 1 |
Mac | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 1 | 0 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 2 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 |
Linux | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
Overview
We already have Vim-Task, now we need one task plugin for Sublime Text 2.
ScreenShot
SublimeTask with Monaco font
Installation
I assume you have git installed, if not, you can download the latest source from Github Downloads then copy the whole directory into the Packages directory.
The location of the “Packages” packages directory depends on the OS you’re using, below is a possible location that you may find your Packages directory:
- OS X:
- ~/Library/Application Support/Sublime Text 2/Packages
- Linux:
- ~/.config/sublime-text-2/Packages
- Windows:
- %APPDATA%/Sublime Text 2/Packages
Take OS X for example:
$ cd ~/Library/Application\ Support/Sublime\ Text\ 2/Packages/
$ git clone git@github.com:samsonw/SublimeTask.git
TODO: add this Package to sublime_package_control, so later we can install it directly in editor via package control.
UPDATE: This package has already been accepted by sublime_package_control, now you can install it directly in the editor, the package name there is just called “Task”.
Shortcut Key & Key Binding
By default, I mapped Command+Ctr+Enter (OS X) and Ctrl+Shift+Alt+Enter (Windows, Linux) for toggling the task status, you can simply remap to what’s the most comfortable for you in your Default User keymap file.
OS X:
[ { "keys": ["super+ctrl+enter"], "command": "task"} ]
Linux, Windows:
[ { "keys": ["ctrl+shift+alt+enter"], "command": "task"} ]
Customization
To change the task display color, you need to edit a file called Task.tmLanguage bundled together with this SublimeTask package.
$ subl ~/Library/Application\ Support/Sublime\ Text\ 2/Packages/SublimeTask/Task.tmLanguage
(you may need to enable sublime command line invocation to execute above command)
<dict>
<key>comment</key>
<string>Completed Tasks</string>
<key>match</key>
<string>^\s*✓[^\[\]]*</string>
<key>name</key>
<string>string</string>
</dict>
As you can see above, I use “string” scope for the Completed Tasks by default, which will be mapped to green in my color scheme file. If it doesn’t look good in your color scheme, you can simply customize it by changing “string” to something appropriate to your color scheme.
You can find the scope name in your color scheme file.
File Format & Syntax
The Task grammar and commands by default apply to file todo.txt and files with extension .task, .tasks, .todo and .todolists. You can also customize this by editing SublimeTask/Task.tmLanguage:
<key>fileTypes</key>
<array>
<string>task</string>
<string>tasks</string>
<string>todo.txt</string>
<string>todo</string>
<string>todolists</string>
</array>
All the formats and syntax is similar, quoted below for your references:
Headers end with a colon (“:”). Pending (uncompleted) tasks start with a hyphen (“-”). Completed tasks start with a checkmark (“✓”). Headers and tasks can be indented for grouping/hierarchy, as seen in the screenshot above.
Bug & Feedback
Please report bugs and issues to github: https://github.com/samsonw/SublimeTask/issues, any feedback and suggestion is welcome.