htodo: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(oops need a new page for overall format effort vs to-do on the wiki itself)
Tag: Redirect target changed
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''This page violates several aspects of the microformats [[process]].  In particular: failure to document [[to-do-examples]], [[to-do-formats]], [[to-do-brainstorming]], premature naming.  Please read [[process]] and join the microformats-new mailing list before proceeding any further.'''
''This is just an initial draft''
[ VTODO] is part of the [ 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;
&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;

Latest revision as of 22:47, 14 December 2021

Redirect to: