hcalendar-cheatsheet

From Microformats

hCalendar cheatsheet

hCalendar properties and how to use them.

Table of contents

Properties (Class Names)

  • vevent {1}
    • category*
    • class?
    • description?
    • dtend (ISO date)?
    • dtstart (ISO date) {1}
    • duration?
    • geo?
      • latitude?
      • longitude?
    • location?
    • status?
    • summary {1}
    • uid?
    • url?
    • last-modified?
    • rdate !
    • rrule !
    • attendee !
    • contact !
    • organiser !

Key

Based on Perl's standard quantifiers (http://www.perl.com/doc/manual/html/pod/perlre.html):

bold {1} MUST be present exactly once
italic* OPTIONAL, and MAY occur more than once
+ MUST be present, and MAY occur more than once
 ? OPTIONAL, but MUST NOT occur more than once
[square brackets] list of common values
(parentheses) data format
# comment
 ! awaiting documentation

Notes

Geo

  • Coordinates MUST use the datum of WGS84 (http://en.wikipedia.org/wiki/World_Geodetic_System).
  • If latitude is present, so MUST be longitude, and vice versa.
  • Coordinates MAY be combined a single <abbr> element; then the latitude and longitude MUST be separated by a semicolon in the title attribute and latitude MUST be first:
<abbr class="geo" title="37.386013;-122.082932">home</abbr>
  • Best practice is that the same number of decimal places SHOULD be used in each value, with trailing zeroes if applicable.
  • Some sources for latitude/ longitude coordinates (http://wikitravel.org/en/Wikitravel:Geocoding#Sources_for_lat.2Flongs)

Related pages

This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. These thoughts, issues, and questions are kept in separate pages.

Personal tools