h-event

(Difference between revisions)

Jump to: navigation, search
(Initial dump from mf2 page)
m (some minor edits/fixes)
Line 4: Line 4:
<dfn style="font-style:normal;font-weight:bold">h-event</dfn> is a simple, open format for publishing events on the web. h-event is one of several open [[microformats|microformat]] draft standards suitable for embedding data in HTML/HTML5.
<dfn style="font-style:normal;font-weight:bold">h-event</dfn> is a simple, open format for publishing events on the web. h-event is one of several open [[microformats|microformat]] draft standards suitable for embedding data in HTML/HTML5.
-
h-event is the [[microformats-2]] replacement for [[hCal]].
+
h-event is the [[microformats-2]] update for [[hCalendar]].
== Example ==
== Example ==
Line 12: Line 12:
<div class="h-event">
<div class="h-event">
   <h1 class="p-name">Microformats Meetup</h1>
   <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>
+
   <p>From  
-
    to <time class="dt-end" datetime="2013-06-30 18:00:00">18:00</time>
+
    <time class="dt-start" datetime="2013-06-30 12:00">30<sup>th</sup> June 2013, 12:00</time>
-
    at <span class="p-location">Some bar in SF</span></p>
+
    to <time class="dt-end" datetime="2013-06-30 18: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>
+
   <p class="p-summary">Get together and discuss all things microformats-related.</p>
</div>
</div>
</source>
</source>
Line 23: Line 23:
The class '''<code>h-event</code>''' is a ''root class name'' that indicates the presence of an h-event.
The class '''<code>h-event</code>''' 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.
+
'''p-name''', '''dt-start''', '''dt-end''', '''p-location''', '''p-summary''', and the other h-event property class names listed below define ''properties'' of the h-event.
-
See [[microformats-2-parsing]] to learn more about property classnames.
+
See [[microformats-2-parsing]] to learn more about property class names.
== Properties ==
== Properties ==
-
 
Inside an element with class '''h-event''':
Inside an element with class '''h-event''':
-
* '''<code>p-name</code>''' - event name/title
+
* '''<code>p-name</code>''' - event name (or title)
* '''<code>p-summary</code>''' - short summary of the event
* '''<code>p-summary</code>''' - short summary of the event
* '''<code>dt-start</code>''' - datetime the event starts
* '''<code>dt-start</code>''' - datetime the event starts
* '''<code>dt-end</code>''' - datetime the event ends
* '''<code>dt-end</code>''' - datetime the event ends
-
* '''<code>dt-duration</code>''' - the total duration of the event
+
* '''<code>dt-duration</code>''' - duration of the event
-
* '''<code>p-description</code>''' - a more detailed description of the event
+
* '''<code>p-description</code>''' - more detailed description of the event
-
* '''<code>u-url</code>''' - a permalink for the event
+
* '''<code>u-url</code>''' - permalink for the event
* '''<code>p-category</code>''' - event category(ies)/tag(s)
* '''<code>p-category</code>''' - event category(ies)/tag(s)
-
* '''<code>p-location</code>''' - where the event takes place, optionally a nested [[h-adr]]
+
* '''<code>p-location</code>''' - where the event takes place, optionally a nested [[h-adr]] or [[h-card]]
* '''<code>p-geo</code>''' - geophysical location of the event, optionally a nested [[h-geo]]
* '''<code>p-geo</code>''' - geophysical location of the event, optionally a nested [[h-geo]]
* '''<code>p-latitude</code>''' - decimal latitude
* '''<code>p-latitude</code>''' - decimal latitude
* '''<code>p-longitude</code>''' - decimal longitude
* '''<code>p-longitude</code>''' - decimal longitude
-
Experimental properties currently in use in the wild but not part of the official h-entry spec:
+
Experimental properties currently in use in the wild but not (yet) part of the official h-entry spec:
-
 
+
* '''<code>p-attendee</code>''' - a person attending the event, optionally a nested [[h-card]]
* '''<code>p-attendee</code>''' - a person attending the event, optionally a nested [[h-card]]
Line 51: Line 49:
'''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 [http://microformats.org/discuss/mail/microformats-new/ microformats-new mailing list].
'''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 [http://microformats.org/discuss/mail/microformats-new/ 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.
+
h-event is ready to use and implemented in the wild, but for backwards compatibility you should also mark h-events up as classic [[hCalendar]] events.
== Property Details ==
== Property Details ==
(stub, to be expanded)
(stub, to be expanded)
-
<code>p-location</code> is often a postal address, optionally marked up with [[h-adr]], for example:
+
<code>p-location</code> is typically a physical address, optionally marked up with [[h-adr]], for example:
<source lang=html4strict>
<source lang=html4strict>
Line 70: Line 68:
* ... add uses of h-event you see in the wild here.
* ... add uses of h-event you see in the wild here.
 +
 +
See [[microformats2#Examples_in_the_wild|microformats2 examples in the wild]] for more (and copy any h-event examples to here in-line).
== Background ==
== Background ==
-
This work is based on the existing [[hCal]] and [[vcalendar]] specifications.
+
This work is based on the existing [[hCalendar]] and [[iCalendar]] specifications.
== Design Principles ==
== Design Principles ==
Line 79: Line 79:
== See Also ==
== See Also ==
-
 
* [[microformats-2]]
* [[microformats-2]]
* [[microformats-2-parsing]]
* [[microformats-2-parsing]]

Revision as of 17:34, 13 June 2013

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 update for hCalendar.

Contents

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">30<sup>th</sup> June 2013, 12:00</time>
    to <time class="dt-end" datetime="2013-06-30 18:00">18:00</time>
    at <span class="p-location">Some bar in SF</span></p>
  <p class="p-summary">Get together and discuss all things microformats-related.</p>
</div>

Get started

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

p-name, dt-start, dt-end, p-location, p-summary, and the other h-event property class names listed below define properties of the h-event.

See microformats-2-parsing to learn more about property class names.

Properties

Inside an element with class h-event:

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

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 hCalendar events.

Property Details

(stub, to be expanded)

p-location is typically a physical 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:

See microformats2 examples in the wild for more (and copy any h-event examples to here in-line).

Background

This work is based on the existing hCalendar and iCalendar specifications.

Design Principles

(stub, expand)

See Also

Categories

h-event was last modified: Wednesday, December 31st, 1969

Views