Skip to content

Latest commit

 

History

History
92 lines (53 loc) · 4.66 KB

README.md

File metadata and controls

92 lines (53 loc) · 4.66 KB

Bulldog

An HTML viewer for Todo.Txt Build Status

Be tenacious, like a bulldog, on your task list.

Bulldog is a single-page HTML view of your todo.txt file. Use the command line interface for capture, editing, and completing tasks. But if you want something a little bit more "app-y" for managing your tasks, Bulldog is for you.

Browser Compatibility

  • Safari 5+
  • Chrome 9+
  • Firefox - unsupported at this time (waiting on a bug fix)
  • Others? Let us know

Installation

Bulldog is released as a single HTML file via the Downloads page, called index.html, that needs to live in the same directory as your todo.txt file.

You will also need to set up a web server to point to this directory or configure your browser to allow AJAX requests from a file:// URL. Bulldog makes an AJAX request to read in todo.txt

This isn't very user-friendly at this point in time.

For these examples, I keep my todo.txt file (and all of my Todo.txt stuff) in /Users/dwf/Dropbox/todo.

Via HTTP and a Local Web Server

Using Apache on MacOS

These steps work on MacOS 10.7 (Lion), serving Bulldog via the built-in web server (Apache 2). Please look up the equivalent steps for your operating system and web server.

  1. Make a symlink from Apache's directory to your ToDo.txt directory: ln -s /Users/dwf/Dropbox/todo /Library/WebServer/Documents/todo
  2. Restart Apache by visiting the Sharing pane under System Preferences, and turning Web Sharing off (if it's on) and then on
  3. Copy Bulldog's index.html to /Users/dwf/Dropbox/todo
  4. Visit http://localhost/todo

Using an Ad-hoc Web Server (Multiplatform)

An ad-hoc web server can be run with these steps if Python is installed (tested only on Linux but should work in other platforms):

  1. Cd into the directory containing index.html and todo.txt
  2. Run python -m SimpleHTTPServer
  3. Visit http://localhost:8000/

Via the Local File Protocol

With some tweaking of your browser settings, file://path/to/index.html will work

  • Safari: no change needed
  • Firefox: enable "cross domain AJAX requests" via config settings; this differs across versions of Firefox, so you'll need to Google it
  • Chrome/Chromium: launch the executable with the --disable-web-security flag set

Usage

Bulldog is a read-only view of your tasks. It is not meant as a replacement for the command line interface. Use the CLI for operations on tasks and then view the new state with Bulldog.

When you open Bulldog, you see all of your tasks in the pane on the right. You should see each task's number, the action of the task, as well as its context and project. Contexts are set with the '@' syntax, and Projects with the '+' syntax.

The left column defaults to showing you all of your projects, including the 'All' project that shows all tasks, sorted by task number. Choosing a project will show all tasks for that project, sorted by priority. (No priority is lower than Z).

If you've updated or added any tasks via the command line, just reload your browser to refresh the tasks.

From the left column you can also choose to group tasks by context, or by next actions.

Next Actions

Todo.txt has no built-in concept of Getting Things Done's next actions. So we added it. Setting a task to priority N makes it a next action - after all, why would you be using that many priorities? Next actions are labeled as such and are considered higher priority than A.

The next actions tab - labeled ➔ - shows only your next actions, grouped by context.

Roadmap?

  • Make it easier to install
  • Support Dropbox installation (hosting via Dropbox's web UI, todo.txt on Dropbox)
  • Editing tasks & storing back to todo.txt - this would require a server, which may be out of scope
  • Show "DONE" actions, listed by interesting groupings

Implementation

Bulldog is a single-page HTML application. It uses jQuery and Backbone.js (which means it also uses Underscore.js) to read in the todo.txt file via AJAX, build out local data objects (Backbone models & collections), and then display the tasks and UI.

The base CSS and navigation UI are from Twitter's Bootstrap.

All of the CSS and JavaScript is included inline so that no server is required.

Contributions

I welcome contributions and suggestions. Any code changes should include tests - naturally, using Jasmine.

License

Bulldog is © Infews LLC and is provided under the MIT License.