os

Homepage: http://orgmode.org/worg/org-contrib/gsoc2012/student-projects/org-sync

Updated:

Summary

Synchronize Org documents with external services

Commentary

This package implements an extension to org-mode that synchnonizes
org document with external services.  It provides an interface that
can be implemented in backends.  The current focus is on
bugtrackers services.

The entry points are `os-import', `os-sync' and `os'.  The first
one prompts for a URL to import, the second one pulls, merges and
pushes every buglists in the current buffer and the third one
combines the others in one function: if nothing in the buffer can
be synchronized, ask for an URL to import.

The usual workflow is first to import your buglist with
`os-import', modify it or add a bug and run `os-sync'.

A buglist is a top-level headline which has a :url: in its
PROPERTIES block.  This headline is composed of a list of
subheadlines which corresponds to bugs.  The requirement for a bug
is to have a state, a title and an id.  If you add a new bug, it
wont have an id but it will get one once you sync.  If you omit the
status, OPEN is chose.

The status is an org TODO state.  It can be either OPEN or CLOSED.
The title is just the title of the headline.  The id is a number in
the PROPERTIES block of the headline.

Org DEADLINE timestamp are also handled and can be inserted in a
bug headline which can then be used by the backend if it supports
it.

Paragraphs under bug-headlines are considered as their description.
Additionnal data used by the backend are in the PROPERTIES block of
the bug.

To add a bug, just insert a new headline under the buglist you want
to modify e.g.:
    ** OPEN my new bug
Then simply call `os-sync'.

Dependencies