htodo: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (Reverted edit of Gazza, changed back to last version by RyanKing)
(oops need a new page for overall format effort vs to-do on the wiki itself)
Tag: Redirect target changed
 
(13 intermediate revisions by 9 users not shown)
Line 1: Line 1:
<h1>hToDo</h1>
#redirect:[[to-do-format]]
 
''This is just an initial draft''
 
[http://en.wikipedia.org/wiki/ICalendar#To-do_.28VTODO.29 VTODO] is part of the [http://www.ietf.org/rfc/rfc2445.txt RFC2445 iCalendar spec] used for describing todo items.
 
VTODO is fairly straight-forward, as it doesn't contain any nested entities, and has a fairly small list of properties.  Most of these it shares with VEVENT, suggesting htodo be modeled on hevent in [[hcalendar]], and the ground assumption is that htodo should work just like hevent with respect to these properties.  The shared properties are:
 
''class, created, description, dtstamp, dtstart, geo, last-mod, location, organizer, priority, recurid, seq, statusm summary, uid, url, duration, attach, attendee, categories, comment, contact, exdate, exrule, rstatus, related, resources, rdate, rrule, x-prop''
 
The unique properties to VTODO are:
 
* '''completed''' The date/time the todo was completed
* '''due''' The date/time this todo is due
* '''percent''' Integer from 0-100, completion status
 
As the data types for '''completed''' and '''due''' are the same as, e.g., '''dtstart''', then the usage should be the same.  For example,
 
&lt;abbr class="due" title="2007-01-01T13:10:05.0Z"&gt;January 1, 2007&lt;/abbr&gt;
 
As for percent, the contents of span with class "percent" will do, I think.  If there is a "%" in the body, it can be ignored.  The numerical part is assumed to be from 0-100.  For example,
 
&lt;span class="percent"&gt;50%&lt;/span&gt;
 
and
 
&lt;span class="percent"&gt;50&lt;/span&gt; percent
 
are equivalent.
 
Here is a full example,
 
&lt;div class="vtodo"&gt;
  &lt;span class="summary"&gt;Create a spec for hToDo&lt;/span&gt;
  &lt;span class="status"&gt;first draft&lt;/span&gt;
  Initiated &lt;abbr class="dtstart" title="2006-05-12"&gt;May 12, 2006&lt;/abbr&gt;
&lt;/div&gt;

Latest revision as of 22:47, 14 December 2021

Redirect to: