h-event: Difference between revisions
Jump to navigation
Jump to 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]] | 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 | <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="summary">Get together and discuss all things | <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- | '''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 | 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 | * '''<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>''' - | * '''<code>dt-duration</code>''' - duration of the event | ||
* '''<code>p-description</code>''' - | * '''<code>p-description</code>''' - more detailed description of the event | ||
* '''<code>u-url</code>''' - | * '''<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 [[ | 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 | <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 [[ | 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
<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 update for hCalendar.
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:
p-name- event name (or title)p-summary- short summary of the eventdt-start- datetime the event startsdt-end- datetime the event endsdt-duration- duration of the eventp-description- more detailed description of the eventu-url- permalink for the eventp-category- event category(ies)/tag(s)p-location- where the event takes place, optionally a nested h-adr or h-cardp-geo- geophysical location of the event, optionally a nested h-geop-latitude- decimal latitudep-longitude- decimal longitude
Experimental properties currently in use in the wild but not (yet) 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 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:
- ... add uses of h-event you see in the wild here.
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)