Revision 607060 of "HCalendar" on knwiki

{{lowercase}}
{{About||details of hCalendar used on Wikipedia|:Wikipedia:Microformats}}
'''hCalendar''' (short for '''''HTML iCalendar''''') is a [[Microformats|microformat]] standard for displaying a semantic [[HTML|(X)HTML]] representation of [[iCalendar]]-format [[calendar]] information about an event, on [[World Wide Web|web pages]], using HTML classes and [[Rel attribute|''rel'' attributes]].
It allows parsing tools (for example other websites, or browser add-ons<ref>[http://microformats.org/wiki/browsers Microformats.org: Browser Support for Microformats]</ref> like [[Firefox]]'s [[Operator (extension)|Operator extension]]) to extract the details of the event, and display them using some other website, index or search them, or to load them into a calendar or diary program, for instance. Multiple instances can be displayed as timelines.
==Example==
Consider this semi-fictional example:
<pre>
  The English Wikipedia was launched
  on 15 January 2001 with a party from 
  2-4pm at 
  Jimmy Wales' house 
  (more information).
</pre>
The HTML mark-up might be:
<pre>
<nowiki>
<p>
  The English Wikipedia was launched 
  on 15 January 2001 with a party from 
  2-4pm at 
  Jimmy Wales' house 
  (<a href="http://en.wikipedia.org/wiki/History_of_Wikipedia">more information</a>)
</p>
</nowiki>
</pre>
hCalendar mark-up may be added using <code>span</code> [[HTML element]]s and the [[HTML#Attributes|classes]] <code>vevent</code>, <code>summary</code>, <code>dtstart</code> (start date), <code>dtend</code> (end date), <code>location</code> and <code>url</code>:
<pre>
<nowiki>
<p class="vevent">
  The <span class="summary">English Wikipedia was launched</span> 
  on 15 January 2001 with a party from 
  <abbr class="dtstart" title="2001-01-15T14:00:00+06:00">2</abbr>-
  <abbr class="dtend" title="2001-01-15T16:00:00+06:00">4</abbr>pm at 
  <span class="location">Jimmy Wales' house</span> 
  (<a class="url" href="http://en.wikipedia.org/wiki/History_of_Wikipedia">more information</a>)
</p>
</nowiki>
</pre>
Note the use of the <code>abbr</code> element to contain the machine readable, [[ISO8601]], date-time format for the start and end times.
==Accessibility concerns==
Concerns have been expressed<ref>[http://www.webstandards.org/2007/04/27/haccessibility/ Web Standards Project, hAccessibility: Abbreviations in Microformats]</ref> that, where it occurs, the use of the <code>abbr</code> element (using the so-called [http://microformats.org/wiki/abbr-design-pattern abbr-design-pattern]) in the above manner causes accessibility problems, not least for users of screen readers and aural browsers. Work is underway to find an alternative method of presenting ISO8601 date-time information.<ref>[http://microformats.org/wiki/assistive-technology Microformats Wiki: Assistive Technology]</ref>
==Geo==
The [[Geo (microformat)|Geo microformat]] is a part of the hCalendar specification, and is often used to include the coordinates of the event's location within an hCalendar.
==Attributes==
<!-- list to follow -->
For a full list of attributes, see the [http://microformats.org/wiki/hcalendar-cheatsheet hCalendar cheat-sheet].
==Users==
Notable organisations and other websites using hCalendar include:
<!--significant examples only, please; listed alphabetically-->
*[[Birmingham Town Hall]] and [[Symphony Hall, Birmingham|Symphony Hall]]<ref>[http://www.birmingham.gov.uk/microformats Microformats - Birmingham City Council<!-- Bot generated title -->]</ref>
*[[Facebook]]<ref name="Protalinski">{{cite web|url=http://www.zdnet.com/blog/facebook/facebook-adds-hcalendar-and-hcard-microformats-to-events/266|title=Facebook adds hCalendar and hCard microformats to Events|last=Protalinski|first=Emil|date=2011-02-18|publisher=ZDNet|accessdate=24 March 2011}}</ref>
*[[Google]] (in Google maps<ref>[http://googlemapsapi.blogspot.com/2007/06/microformats-in-google-maps.html Official Google Maps API Blog: Microformats in Google Maps<!-- Bot generated title -->]</ref> and in Search Engine Results Pages <ref>[http://microformats.org/2010/04/28/google-adds-support-for-hcalendar-and-hrecipe-rich-snippets Microformats.org: Google adds support for hCalendar and hRecipe Rich Snippets]</ref><ref>[http://support.google.com/webmasters/bin/answer.py?hl=en&amp;answer=164506 Google Webmaster Tools: Rich snippets - Events]</ref>)
*The [[Opera (web browser)|Opera]] web browser website<ref>[http://my.opera.com/dstorey/blog/microformats-on-opera-sites David Storey - Microformats on Opera sites<!-- Bot generated title -->]</ref>
*The [[Radio Times]]<ref name="uf-wild" />
*The [[University of Bath]]<ref name="uf-wild">[http://microformats.org/wiki/hcalendar-examples-in-wild hCalendar Examples in the wild · Microformats Wiki<!-- Bot generated title -->]</ref>
*The [[University of Washington]]<ref name="uf-wild" />
*[[Upcoming.org]]<ref name="uf-wild" />
*[[Wikipedia]]<ref>[[Wikipedia:Microformats]]</ref>
*Yahoo!, on [[Yahoo!|Yahoo! Local]]<ref name="uf-wild" />
==References==
{{reflist}}
==External links==
* [http://microformats.org/wiki/hcalendar hCalendar at the Microformats Wiki]
{{DEFAULTSORT:Hcalendar}}
[[Category:Microformats]]