h-event

From Microformats Wiki
Revision as of 17:11, 13 June 2013 by Barnabywalters (talk | contribs) (Initial dump from mf2 page)
Jump to navigation Jump to search

<entry-title>h-event</entry-title> Tantek Çelik (Editor)


h-event is a simple, open format for publishing events on the web. h-event is one of several open microformat draft standards suitable for embedding data in HTML/HTML5.

h-event is the microformats-2 replacement for hCal.

Example

Here is a simple event example:

<div class="h-event">
  <h1 class="p-name">Microformats Meetup</h1>
  <p>From <time class="dt-start" datetime="2013-06-30 12:00:00">on 30<sup>th</sup> June 2013, 12:00</time>
     to <time class="dt-end" datetime="2013-06-30 18:00:00">18:00</time>
     at <span class="p-location">Some bar in SF</span></p>
  
  <p class="summary">Get together and discuss all things microformat-related.</p>
</div>

Get started

The class h-event is a root class name that indicates the presence of an h-event.

p-name, p-summary, dt-start and the other h-event property classnames listed below define properties of the h-event.

See microformats-2-parsing to learn more about property classnames.

Properties

Inside an element with class h-event:

  • p-name - event name/title
  • p-summary - short summary of the event
  • dt-start - datetime the event starts
  • dt-end - datetime the event ends
  • dt-duration - the total duration of the event
  • p-description - a more detailed description of the event
  • u-url - a permalink for the event
  • p-category - event category(ies)/tag(s)
  • p-location - where the event takes place, optionally a nested h-adr
  • p-geo - geophysical location of the event, optionally a nested h-geo
  • p-latitude - decimal latitude
  • p-longitude - decimal longitude

Experimental properties currently in use in the wild but not part of the official h-entry spec:

  • p-attendee - a person attending the event, optionally a nested h-card

Status

h-event is a microformats.org draft specification. Public discussion on h-event takes place on h-event-feedback, the #microformats irc channel on irc.freenode.net, and microformats-new mailing list.

h-event is ready to use and implemented in the wild, but for backwards compatibility you should also mark h-events up as classic hCal events.

Property Details

(stub, to be expanded)

p-location is often a postal address, optionally marked up with h-adr, for example:

<p class="p-adr h-adr">
  <span class="p-street-address">17 Austerstræti</span>
  <span class="p-locality">Reykjavík</span>
  <span class="p-country-name">Iceland</span>
</p>

Examples in the wild

Real world in the wild examples:

  • ... add uses of h-event you see in the wild here.

Background

This work is based on the existing hCal and vcalendar specifications.

Design Principles

(stub, expand)

See Also