Microformats Wiki - User contributions [en]

hcalendar-implementations

2008-11-03T15:32:39Z

James Tindall: permatime typo edit

<h1>hCalendar Implementations</h1>
{{TOC-right}}
This page is an '''informative''' section of the [[hcalendar|hCalendar specification]].

The following implementations have been developed which either generate or parse hCalendars. If you have an [[hcalendar|hCalendar]] implementation, feel free to add it to the New Implementations section. If you have a page or site which just ''publishes'' hCalendar events, please use [[hcalendar-examples-in-wild]] instead.

==New Implementations==
Add new implementations here:

* [http://www.w3.org/People/Bos/HcalProxy/ Hcalproxy] runs as an HTTP server, either standalone or under inetd(8), and converts hCalendar to iCalendar.
* The calendar of [http://TikiWiki.org TikiWiki CMS/Groupware] uses hCalendar markup for events. It's a built-in feature (no need to download separate module/plugin/etc). You can see in action over at [http://wiki-translation.com wiki-translation.com]
* [http://code.google.com/p/schoorbs Schoorbs] has bookings flavored with hCalendar in view_entry.php since revision 175 (becoming 1.0-Alpha2).
* [http://buzzword.org/cognition/ Cognition] supports [[User:TobyInk/hcalendar-1.1|hcalendar 1.1]]
* ...

==Authoring==
Implementations you can use to author, create, and publish hCalendar events.

===Web-based Creators===
;hCalendar Creator : [http://microformats.org/code/hcalendar/creator hCalendar creator] ([[hcalendar-creator-feedback|hCalendar creator feedback]]) - create your own hCalendar events.
;Conference Schedule Creator : [http://dmitry.baranovskiy.com/work/csc/ Conference Schedule Creator] ([[hcalendar-schedule-creator-feedback|Conference Schedule Creator feedback]]) - create your conference schedule with hCalendar events.
;Permatime hCalendar vevent generator : [http://permatime.com/ Permatime] enables sharing of points in time as well as acting as a quick way to generate hcalendar vevents.

===Blogging and CMS tools===
;Midgard CMS : [http://www.midgard-project.org/documentation/net-nemein-calendar/ Midgard CMS - net.nemein.calendar] - as [http://bergie.iki.fi/blog/new-event-calendar-for-midcom.html blogged by Henri Bergius]

;Drupal module : [http://hybernaut.com/upcoming-hcal Drupal Upcoming.org syndication module emits hCalendar]
;MovableType and WordPress plug-ins : [http://structuredblogging.org/formats.php StructuredBlogging] is a set of plugins [http://structuredblogging.org/structuredblogging-wp-latest.zip for WordPress] and [http://structuredblogging.org/structuredblogging-wp-latest.zip for MovableType] that supports embedding hCalendar and other microformats in templates and blog posts.
;Textpattern plug-ins :
* [http://placenamehere.com/TXP/pnh_mf/ pnh_mf] is a plugin for [http://textpattern.com/ Textpattern] that supports embedding hCalendar and other microformats in templates and blog posts. Written by [http://placenamehere.com/ Chris Casciano].
* [http://euphemize.net/blog/plugins/textpattern/jmc_event_manager/ jmc_event_manager] is a plugin for [http://textpattern.com/ Textpattern] that outputs events and locations in hCalendar (and hCard) formats. Written by [http://euphemize.net/ Joel Courtney].

===Browser scripts and plug-ins===
Browser plugins that work with existing authoring tools:
; Any browser with javascript and a little bit of CSS : [http://microformats.org/code/hcalendar/creator microformats.org hCalendar creator] (see also original: [http://theryanking.com/ Ryan King] has an [http://theryanking.com/microformats/hcalendar-creator.html hCalendar creator]).
; Firefox Greasemonkey user script hCalendar creator : [http://www.decafbad.com/blog/2005/06/08/greasemonkey_magic magic_hcalendar Greasemonkey user script by Les Orchard] - allows easy form entry of an event into any textarea, e.g. into a blog post text area.
; Firefox Greasemonkey user script hCalendar to Google Calendar: [http://torrez.us Elias Torres] has created a [http://torrez.us/archives/2006/04/13/431/ simple script] that will parse hCalendar entries and create a link to add event to [http://www.google.com/calendar/ Google Calendar's] service. Based on [http://virtuelvis.com/archives/2005/11/learn-to-love-microformats George's] and [http://virtuelvis.com/archives/2005/11/learn-to-love-microformats Arve's] work.

===Desktop Authoring Tools===
;Dreamweaver Extension : [http://www.webstandards.org/action/dwtf/microformats/ Extension suite] for Dreamweaver 8 from the [http://webstandards.org/ Web Standards Project].
;xfy :
In [https://www.xfytec.com/community/ xfy Community], there are some hCalendar implementations.
* [https://www.xfytec.com/community/modules/mydownloads/singlefile.php?cid=15&lid=25 hCalendar via RSS] parses an RSS feed, retrieves XHTML documents linked from that feed, and syndicates hCalendars into a calendar view.
* [https://www.xfytec.com/community/modules/mydownloads/singlefile.php?cid=19&lid=23 hCalendar Marker XVCD] helps to mark up an event information in XHTML document with hCalendar.
* [https://www.xfytec.com/community/modules/mydownloads/singlefile.php?cid=15&lid=17 Simple RDF Calendar XVCD] is a schedule tool which uses RDF Calendar format. It also converts RDF Calendar format to iCalendar and hCalendar format.
;Windows Live Writer :
* WLW's [http://gallery.live.com/liveItemDetail.aspx?li=9751e563-1408-4fc3-8028-bd4351edb1fb&l=8 Event Plugin] formats events in blog posts with hCalendar.

==Search and Discovery==
* [http://kitchen.technorati.com/search Technorati Microformats Search] indexes [[hcard|hCard]], [[hcalendar|hCalendar]], and [[hreview|hReview]] as [http://tantek.com/log/2006/05.html#d31t1802 announced by Tantek].
* [http://leftlogic.com/info/articles/microformats_bookmarklet Microformats Bookmarklet] is a bookmarklet designed for Safari (works in Firefox and Camino) that overlays on the current page to allow users to import individual [[hcard|hCards]] or [[hcalendar|hCalendars]]. Written by [http://leftlogic.com Remy Sharp].

==Conversion and Import==
Implementations you can use to importing into a calendar application, typically by converting hCalendar to iCalendar/vCalendar.

===Web Services===
These return iCalendar (.ics) and other calendar formats for easy importing into typical calendar programs or other processing.
* [http://feeds.technorati.com/events Technorati Events Feed service] uses X2V library to parse hCalendar and return iCalendar (.ics).
**Note friendly URL, e.g. http://feeds.technorati.com/events/http%3A//microformats.org
* [http://suda.co.uk/projects/X2V/ X2V] parses hCalendar and produces a .ics (iCalendar) stream.
**Note: needs to be updated to track changes in the specification as they occur.

* [http://spanningsalesforce.com/ Spanning Salesforce] produces hCalendar-enabled RSS feeds and .ics calendars from Salesforce.com.
* [http://makedatamakesense.com/myspace/event/ MySpace Events RSS Creator] creates RSS feeds of MySpace events with hCalendar markup.

===Firefox Greasemonkey Plugins===
* [http://george.hotelling.net/90percent/ George] has built a [http://george.hotelling.net/90percent/geekery/greasemonkey_and_microformats.php Greasemonkey user script that detects hCalendar events and allows users to easily add them to their calendar application(s)].
* [http://inside.glnetworks.de/ Martin Rehfeld] has updated the work of [http://blogmatrix.blogmatrix.com/ David Janes] and produced a [[Greasemonkey]] [http://inside.glnetworks.de/2006/06/05/microformats-have-arrived-in-firefox-15-greasemonkey-06/ script] that finds many microformat elements, including hCalendar events, and [http://blog.davidjanes.com/mtarchives/2005_08.html#003379 provides a popup menu of actions]. The hCalendar to vCalendar conversion is done internally within the script. ''This will work with FireFox 1.5+/GreaseMonkey 0.6.4+ now.''

===Aggregators===
* [http://placenamehere.com/mf/nnwextract/ Extract Microformats] is a script for NetNewsWire that supports extracting hCard and hCalendar data in blog posts (via Technorati service). Written by [[User:ChrisCasciano|Chris Casciano]]
* [http://kula.jp/software/endo/screenshots/ Endo], an OS X aggregator, supports discovering hCalendar and adding those events to iCal. Look at the last screenshot at the bottom of the page.

===Converters===
* [http://www.w3.org/People/Bos/HcalProxy/ Hcalproxy] runs as an HTTP server, either standalone or under inetd(8), and converts hCalendar to iCalendar. E.g., if Hcalproxy is running on localhost port 8000 and <nowiki>http://example.org/page.html</nowiki> points is an HTML page, then <nowiki>http://localhost:8000/http://example.org/page.html</nowiki> is an iCalendar document with the events from that page.

==Browsing==
Implementations that detect, display and otherwise highlight hCalendar events in pages.

* In [http://www.xfytec.com/community/ xfy Community], there are some hCalendar implementations. "hCalendar via RSS" parses an RSS feed, retrieves XHTML documents linked from that feed, and syndicates hCalendars into a calendar view.
* [http://code.google.com/p/js-hcalendar js-hcalendar] parses hCalendar and produces a displayable HTML table/CSS-based calendar (formerly called JSCalendar).
* [http://thebitterpill.com/07-2007/a-jquery-hcal-parser/ jqueryhcal] is a jQuery-based hCalendar parser that supports multi-day events, dtend, and other features.

===Firefox extension===
*[http://www.orch8.net/ AlchemyPoint] is a Firefox extension and proxy service that can detect microformats in HTML documents and display browsing/mashup suggestions based on their contents.
*[http://blog.codeeg.com/tails-firefox-extension/ Tails is a Firefox Extension] that will display the presence of microformats ([[hcard|hCard]], [[hcalendar|hCalendar]], [[hreview|hReview]], [[xfolk|xFolk]]) on a webpage.
*[https://addons.mozilla.org/en-US/firefox/addon/4106 Operator] also displays the presence of microformats, is extensible, and allows you to add actions such as "Add hCalender to Yahoo! Calendar".

====Pending====
*[http://reminderfox.mozdev.org/ ReminderFox] have hCalendar import on their "to do " list.

===Flock extension===
*[http://www.orch8.net/ AlchemyPoint] is a Flock extension and proxy service that can detect microformats in HTML documents and display browsing/mashup suggestions based on their contents.
*[http://blog.codeeg.com/2006/03/20/flock-tails-flocktails/ Flocktails] - port of Tails extension for Flock 0.5.12 that looks for hCards, hCalendar, xFolk and hReview and tosses them into a handy topbar

==Libraries==
Open source libraries of hCalendar parsers and other related code for building hCalendar implementations. Note: it is very likely that some of the above implementations may be duplicated in this section. That's ok.
; Javascript :
* [http://virtuelvis.com/archives/2005/11/learn-to-love-microformats simple hCalendar parser] by [http://virtuelvis.com/ Arve Bersvendsen]
* [http://microformats.org/code/hcalendar/creator hCalendar creator] ([[hcalendar-creator-feedback|hCalendar creator feedback]])
; PHP :
*[http://randomchaos.com/microformats/base/ Microformat Base] is an open-source PHP microformat aggregation crawler, currently recognizing hreview, hcalendar, and hcard (Source code no longer available as of 6 Dec 06).
*[http://enarion.net/phpmicroformats/ phpMicroformats] is a PHP class library that generates microformats for calendar events (hCalendar) and vcards (hCard).
* [http://fresh.t-systems-sfr.com/unix/src/www/WebCalendar-devel-1.1.1.tar.gz:a/WebCalendar-1.1.1/includes/classes/hKit/hcal.profile.php hCalendar profile] for the [http://allinthehead.com/hkit/ hKit] parser.
; Ruby [http://rubyforge.org/projects/uformats/ uformats]: is a ruby library that can parse [[hCalendar]], [[hCard]], [[hReview]] and [[rel-tag]]
; XSLT :
* X2V is available as an XSLT library
* [http://dev.w3.org/cvsweb/2001/palmagent/ palmagent] by [[User:DanC]] includes toICal.xsl and test materials; it works much like xhtml2vcal.xsl in X2V. See also: [http://www.w3.org/2002/12/cal/ RDF Calendar workspace] with icalendar test materials.
; Python :
* [http://vobject.skyhouseconsulting.com/ vObject], part of the Chandler project, claims experimental hCalendar support.

== Related Pages ==
{{hcalendar-related-pages}}

hcalendar-implementations

2008-11-03T15:31:49Z

James Tindall: permatime vevent creator

<h1>hCalendar Implementations</h1>
{{TOC-right}}
This page is an '''informative''' section of the [[hcalendar|hCalendar specification]].

The following implementations have been developed which either generate or parse hCalendars. If you have an [[hcalendar|hCalendar]] implementation, feel free to add it to the New Implementations section. If you have a page or site which just ''publishes'' hCalendar events, please use [[hcalendar-examples-in-wild]] instead.

==New Implementations==
Add new implementations here:

* [http://www.w3.org/People/Bos/HcalProxy/ Hcalproxy] runs as an HTTP server, either standalone or under inetd(8), and converts hCalendar to iCalendar.
* The calendar of [http://TikiWiki.org TikiWiki CMS/Groupware] uses hCalendar markup for events. It's a built-in feature (no need to download separate module/plugin/etc). You can see in action over at [http://wiki-translation.com wiki-translation.com]
* [http://code.google.com/p/schoorbs Schoorbs] has bookings flavored with hCalendar in view_entry.php since revision 175 (becoming 1.0-Alpha2).
* [http://buzzword.org/cognition/ Cognition] supports [[User:TobyInk/hcalendar-1.1|hcalendar 1.1]]
* ...

==Authoring==
Implementations you can use to author, create, and publish hCalendar events.

===Web-based Creators===
;hCalendar Creator : [http://microformats.org/code/hcalendar/creator hCalendar creator] ([[hcalendar-creator-feedback|hCalendar creator feedback]]) - create your own hCalendar events.
;Conference Schedule Creator : [http://dmitry.baranovskiy.com/work/csc/ Conference Schedule Creator] ([[hcalendar-schedule-creator-feedback|Conference Schedule Creator feedback]]) - create your conference schedule with hCalendar events.
;hCalendar vevent generator : [http://permatime.com/ hCalendar vevent generator] enables sharing of points in time as well as acting as a quick way to generate hcalendar vevents.

===Blogging and CMS tools===
;Midgard CMS : [http://www.midgard-project.org/documentation/net-nemein-calendar/ Midgard CMS - net.nemein.calendar] - as [http://bergie.iki.fi/blog/new-event-calendar-for-midcom.html blogged by Henri Bergius]

;Drupal module : [http://hybernaut.com/upcoming-hcal Drupal Upcoming.org syndication module emits hCalendar]
;MovableType and WordPress plug-ins : [http://structuredblogging.org/formats.php StructuredBlogging] is a set of plugins [http://structuredblogging.org/structuredblogging-wp-latest.zip for WordPress] and [http://structuredblogging.org/structuredblogging-wp-latest.zip for MovableType] that supports embedding hCalendar and other microformats in templates and blog posts.
;Textpattern plug-ins :
* [http://placenamehere.com/TXP/pnh_mf/ pnh_mf] is a plugin for [http://textpattern.com/ Textpattern] that supports embedding hCalendar and other microformats in templates and blog posts. Written by [http://placenamehere.com/ Chris Casciano].
* [http://euphemize.net/blog/plugins/textpattern/jmc_event_manager/ jmc_event_manager] is a plugin for [http://textpattern.com/ Textpattern] that outputs events and locations in hCalendar (and hCard) formats. Written by [http://euphemize.net/ Joel Courtney].

===Browser scripts and plug-ins===
Browser plugins that work with existing authoring tools:
; Any browser with javascript and a little bit of CSS : [http://microformats.org/code/hcalendar/creator microformats.org hCalendar creator] (see also original: [http://theryanking.com/ Ryan King] has an [http://theryanking.com/microformats/hcalendar-creator.html hCalendar creator]).
; Firefox Greasemonkey user script hCalendar creator : [http://www.decafbad.com/blog/2005/06/08/greasemonkey_magic magic_hcalendar Greasemonkey user script by Les Orchard] - allows easy form entry of an event into any textarea, e.g. into a blog post text area.
; Firefox Greasemonkey user script hCalendar to Google Calendar: [http://torrez.us Elias Torres] has created a [http://torrez.us/archives/2006/04/13/431/ simple script] that will parse hCalendar entries and create a link to add event to [http://www.google.com/calendar/ Google Calendar's] service. Based on [http://virtuelvis.com/archives/2005/11/learn-to-love-microformats George's] and [http://virtuelvis.com/archives/2005/11/learn-to-love-microformats Arve's] work.

===Desktop Authoring Tools===
;Dreamweaver Extension : [http://www.webstandards.org/action/dwtf/microformats/ Extension suite] for Dreamweaver 8 from the [http://webstandards.org/ Web Standards Project].
;xfy :
In [https://www.xfytec.com/community/ xfy Community], there are some hCalendar implementations.
* [https://www.xfytec.com/community/modules/mydownloads/singlefile.php?cid=15&lid=25 hCalendar via RSS] parses an RSS feed, retrieves XHTML documents linked from that feed, and syndicates hCalendars into a calendar view.
* [https://www.xfytec.com/community/modules/mydownloads/singlefile.php?cid=19&lid=23 hCalendar Marker XVCD] helps to mark up an event information in XHTML document with hCalendar.
* [https://www.xfytec.com/community/modules/mydownloads/singlefile.php?cid=15&lid=17 Simple RDF Calendar XVCD] is a schedule tool which uses RDF Calendar format. It also converts RDF Calendar format to iCalendar and hCalendar format.
;Windows Live Writer :
* WLW's [http://gallery.live.com/liveItemDetail.aspx?li=9751e563-1408-4fc3-8028-bd4351edb1fb&l=8 Event Plugin] formats events in blog posts with hCalendar.

==Search and Discovery==
* [http://kitchen.technorati.com/search Technorati Microformats Search] indexes [[hcard|hCard]], [[hcalendar|hCalendar]], and [[hreview|hReview]] as [http://tantek.com/log/2006/05.html#d31t1802 announced by Tantek].
* [http://leftlogic.com/info/articles/microformats_bookmarklet Microformats Bookmarklet] is a bookmarklet designed for Safari (works in Firefox and Camino) that overlays on the current page to allow users to import individual [[hcard|hCards]] or [[hcalendar|hCalendars]]. Written by [http://leftlogic.com Remy Sharp].

==Conversion and Import==
Implementations you can use to importing into a calendar application, typically by converting hCalendar to iCalendar/vCalendar.

===Web Services===
These return iCalendar (.ics) and other calendar formats for easy importing into typical calendar programs or other processing.
* [http://feeds.technorati.com/events Technorati Events Feed service] uses X2V library to parse hCalendar and return iCalendar (.ics).
**Note friendly URL, e.g. http://feeds.technorati.com/events/http%3A//microformats.org
* [http://suda.co.uk/projects/X2V/ X2V] parses hCalendar and produces a .ics (iCalendar) stream.
**Note: needs to be updated to track changes in the specification as they occur.

* [http://spanningsalesforce.com/ Spanning Salesforce] produces hCalendar-enabled RSS feeds and .ics calendars from Salesforce.com.
* [http://makedatamakesense.com/myspace/event/ MySpace Events RSS Creator] creates RSS feeds of MySpace events with hCalendar markup.

===Firefox Greasemonkey Plugins===
* [http://george.hotelling.net/90percent/ George] has built a [http://george.hotelling.net/90percent/geekery/greasemonkey_and_microformats.php Greasemonkey user script that detects hCalendar events and allows users to easily add them to their calendar application(s)].
* [http://inside.glnetworks.de/ Martin Rehfeld] has updated the work of [http://blogmatrix.blogmatrix.com/ David Janes] and produced a [[Greasemonkey]] [http://inside.glnetworks.de/2006/06/05/microformats-have-arrived-in-firefox-15-greasemonkey-06/ script] that finds many microformat elements, including hCalendar events, and [http://blog.davidjanes.com/mtarchives/2005_08.html#003379 provides a popup menu of actions]. The hCalendar to vCalendar conversion is done internally within the script. ''This will work with FireFox 1.5+/GreaseMonkey 0.6.4+ now.''

===Aggregators===
* [http://placenamehere.com/mf/nnwextract/ Extract Microformats] is a script for NetNewsWire that supports extracting hCard and hCalendar data in blog posts (via Technorati service). Written by [[User:ChrisCasciano|Chris Casciano]]
* [http://kula.jp/software/endo/screenshots/ Endo], an OS X aggregator, supports discovering hCalendar and adding those events to iCal. Look at the last screenshot at the bottom of the page.

===Converters===
* [http://www.w3.org/People/Bos/HcalProxy/ Hcalproxy] runs as an HTTP server, either standalone or under inetd(8), and converts hCalendar to iCalendar. E.g., if Hcalproxy is running on localhost port 8000 and <nowiki>http://example.org/page.html</nowiki> points is an HTML page, then <nowiki>http://localhost:8000/http://example.org/page.html</nowiki> is an iCalendar document with the events from that page.

==Browsing==
Implementations that detect, display and otherwise highlight hCalendar events in pages.

* In [http://www.xfytec.com/community/ xfy Community], there are some hCalendar implementations. "hCalendar via RSS" parses an RSS feed, retrieves XHTML documents linked from that feed, and syndicates hCalendars into a calendar view.
* [http://code.google.com/p/js-hcalendar js-hcalendar] parses hCalendar and produces a displayable HTML table/CSS-based calendar (formerly called JSCalendar).
* [http://thebitterpill.com/07-2007/a-jquery-hcal-parser/ jqueryhcal] is a jQuery-based hCalendar parser that supports multi-day events, dtend, and other features.

===Firefox extension===
*[http://www.orch8.net/ AlchemyPoint] is a Firefox extension and proxy service that can detect microformats in HTML documents and display browsing/mashup suggestions based on their contents.
*[http://blog.codeeg.com/tails-firefox-extension/ Tails is a Firefox Extension] that will display the presence of microformats ([[hcard|hCard]], [[hcalendar|hCalendar]], [[hreview|hReview]], [[xfolk|xFolk]]) on a webpage.
*[https://addons.mozilla.org/en-US/firefox/addon/4106 Operator] also displays the presence of microformats, is extensible, and allows you to add actions such as "Add hCalender to Yahoo! Calendar".

====Pending====
*[http://reminderfox.mozdev.org/ ReminderFox] have hCalendar import on their "to do " list.

===Flock extension===
*[http://www.orch8.net/ AlchemyPoint] is a Flock extension and proxy service that can detect microformats in HTML documents and display browsing/mashup suggestions based on their contents.
*[http://blog.codeeg.com/2006/03/20/flock-tails-flocktails/ Flocktails] - port of Tails extension for Flock 0.5.12 that looks for hCards, hCalendar, xFolk and hReview and tosses them into a handy topbar

==Libraries==
Open source libraries of hCalendar parsers and other related code for building hCalendar implementations. Note: it is very likely that some of the above implementations may be duplicated in this section. That's ok.
; Javascript :
* [http://virtuelvis.com/archives/2005/11/learn-to-love-microformats simple hCalendar parser] by [http://virtuelvis.com/ Arve Bersvendsen]
* [http://microformats.org/code/hcalendar/creator hCalendar creator] ([[hcalendar-creator-feedback|hCalendar creator feedback]])
; PHP :
*[http://randomchaos.com/microformats/base/ Microformat Base] is an open-source PHP microformat aggregation crawler, currently recognizing hreview, hcalendar, and hcard (Source code no longer available as of 6 Dec 06).
*[http://enarion.net/phpmicroformats/ phpMicroformats] is a PHP class library that generates microformats for calendar events (hCalendar) and vcards (hCard).
* [http://fresh.t-systems-sfr.com/unix/src/www/WebCalendar-devel-1.1.1.tar.gz:a/WebCalendar-1.1.1/includes/classes/hKit/hcal.profile.php hCalendar profile] for the [http://allinthehead.com/hkit/ hKit] parser.
; Ruby [http://rubyforge.org/projects/uformats/ uformats]: is a ruby library that can parse [[hCalendar]], [[hCard]], [[hReview]] and [[rel-tag]]
; XSLT :
* X2V is available as an XSLT library
* [http://dev.w3.org/cvsweb/2001/palmagent/ palmagent] by [[User:DanC]] includes toICal.xsl and test materials; it works much like xhtml2vcal.xsl in X2V. See also: [http://www.w3.org/2002/12/cal/ RDF Calendar workspace] with icalendar test materials.
; Python :
* [http://vobject.skyhouseconsulting.com/ vObject], part of the Chandler project, claims experimental hCalendar support.

== Related Pages ==
{{hcalendar-related-pages}}

hcalendar-examples-in-wild

2008-11-03T15:30:29Z

James Tindall: edit typo in permatime entry

<h1>hCalendar Examples in the wild</h1>
{{TOC-right}}
This page is an '''informative''' section of the [[hcalendar|hCalendar specification]].

The following sites have published events using [[hcalendar|hCalendar]], and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc.

If events on your site are marked up with hCalendar, feel free to add it to the top of this list. Please be sure to include at least one URL of a page on your site that includes actual [[hcalendar|hCalendar]] markup. Examples added without the URL of a page with hCalendar markup may be removed.

Want to get started with writing an [[hcalendar|hCalendar]] event? Use the [http://microformats.org/code/hcalendar/creator hCalendar creator] to write up an event and publish it, or follow the [[hcalendar-authoring|hCalendar authoring tips]] to add hCalendar markup to your page of upcoming events or events you mention in blog posts, wikis, etc.

Don't forget that you can add one of our [[buttons#hCalendar|buttons]] to the page, to indicate the presence of hCalendar microformats. For example: http://www.boogdesign.com/images/buttons/microformat_hcalendar.png. If you can link it back to [[hcalendar|hCalendar]] (or even page on your website, about your use of the microformat), so much the better!

== examples to act on ==

===new examples===
<span id="New_Examples"></span>
Please add new examples to the '''top''' of this section.
* [http://permatime.com/ Permatime] site for sharing points in time accross times zones. It uses hcalendar and can be used as a quick way of generating hcalendar events.
* [http://www.bath.ac.uk/ University of Bath] uses hCalendar to mark up their [http://www.bath.ac.uk/semester/ semester timetable]
* [http://www.php.net/ PHP.net] uses hCalendar in their [http://www.php.net/conferences/ Conference Announcements] and [http://www.php.net/cal.php Event Calendar].
* [http://www.maine.gov/portal/help/microformats.html Maine.gov] uses microformats in their Calendar of Events and has a nice explanation page about microformats.
* [http://www.viewfilm.net/ Film on Freeview] uses hCalendar to mark up upcoming film listings on free-to-air UK television.
* [http://local.mapquest.com/ MapQuest Local] uses hCards for locations, hCalendar for events and supports the draft Geo format when lat/lng data is provided. See [http://blog.mapquest.com/2008/09/25/microformat-support-on-mapquest-local/ Microformat Support on MapQuest Local] for more information.
* [http://www.cambridgefilmfestival.org.uk/ Cambridge Film Festival] uses hCalendar to mark up the [http://www.cambridgefilmfestival.org.uk/films/list/order/date festival schedule].
* [http://www.law.georgetown.edu Georgetown Law Center] uses hCalendar to mark up faculty scholarly that take place on campus, listing them in the [http://www.law.georgetown.edu/faculty/events/ Faculty Workshops, Lectures and Symposia] system.
* [http://www.ecovian.com Ecovian] uses hCalendar to mark up green living & environmental event details, see [http://www.ecovian.com/event/sanfrancisco San Francisco Green Events] example
* [http://beta.subpop.com/ SubPop Records] features hCalendar events on its homepage and on [http://subpop.com/artists/band_of_horses individual artist pages].
* [http://laughingsquid.com/squidlist/events/ Laughing Squid Events] use hCalendar ''only'' on event detail pages (not on the overall list of events), e.g. [http://laughingsquid.com/squidlist/events/index.php?com=detail&eID=177533&year=2008&month=06 Pownce 1 Year Anniversary Party!].
* [http://www.outbackadventuretreks.com.au Outback Adventure Treks] use hCalendar for their [http://outbackadventuretreks.com.au/tours_calendar.php tours calendar] also hCard for their [http://outbackadventuretreks.com.au/contact.php contact details.]
* [http://www.dancefederation.co.uk Dance Federation Salsa Dancing & Jive Dancing Lessons and Events ] Directory for classes, lessons and events users hcalendar, hcard, geo for events and lessons.
* [http://library.christchurch.org.nz/News/ Christchurch City Libraries] news and events calendar - many but not all events.
* [http://www.villamedia.nl/agenda Villamedia] and [http://www.dejournalist.nl/agenda De Journalist] (both Dutch websites for journalists and media workers) use hCalendar to mark up their (shared) events list.
* At [http://www.ecoresearch.net/event ECOresearch.net] we export our event calendar as hCalendar.
* [http://www.firmendb.de/messetermine/index.php Fimendb Messetermine] uses hCalendar markup to add semantic meaning to the calendar of fairs and exhibitions.
* [http://www.kickstartme.co.uk KickStart Events] uses hCalendar markup to add semantic meaning to our calendar of events for forthcoming RubyOnRails workshop and courses.
* The [http://www.amentsoc.org/events/ Amateur Entomologists' Society] uses hCalendar in our calendar of events for entomologists or people with an interest in natural history.
* The [http://www.sandiegobrewersguild.org/calendar.php San Diego Brewers Guild] is using hCalendar for member brewers’ and pubs’ upcoming events.
* The [http://users.belgacom.net/gaudete Gregorian choir Gaudete] from Aalst (Belgium) uses hCalendar in their calendar of upcoming performances.
* [http://autopendium.com/events Classic Car Events] - Classic car events -- shows, auctions, race meetings -- from around the world marked up with hCalendar.
* [http://www.worldeventsguide.com World Events Guide] - Events occuring around the world marked up with hCalendar.
* [http://www.niallkennedy.com/about/ Niall Kennedy's Upcoming speeches] - hcalendar describing upcoming speeches occurs within the bounds of the parent hCard. Each vevent references said hCard using "include" method and attendee or organizer where appropriate. One vevent's description is a vcalendar itself, specifying multiple events (speeches) within the event and Niall's role in each, again with hCard include.
** The hcard include breaks one of the rules of the [[include-pattern]]: 'To prevent infinite loops, if a class="include" refers to itself or to an ancestor in the parse tree, then it is ignored and has no effect on the parser.'
* [http://competitiondiva.com/calendar.html Competition Diva's Event Calendar] is marked up with hCalendar.
* [http://www.bicyclepaper.com/calendar BicyclePaper Calendar] - Cycling event calendar marked up in hCalendar format
* [http://floatingsheep.com/userscripts/evite-hcalendar.user.js Evite hCalendar] - userscript to add hCalendar markup to eVite invitation pages
* [http://www.tripit.com/ TripIt] - uses hCalendar markup for every itinerary
* [http://www.leaguist.com Leaguist] - uses hCalendar markup sporting events
** Examples: http://www.leaguist.com/super-14-2008/games/, http://www.leaguist.com/super-14-2008/pick/1
* [http://www.areaguides.net areaguides.net] - uses hCalendar markup on all of our event pages
** Examples: http://newyorkny.areaguides.net/events.html, http://chicagoil.areaguides.net/events.html
* [http://www.keevu.com Keevu.com] - embeds hCalendar markup on all of it's events announcements
** Example here: [http://www.keevu.com/events Latest events]
* [http://www.auctionlink.com.au/ AuctionLink] uses hCalendar markup to show dates and times for [http://www.auctionlink.com.au/UpcomingAuctionSales Auction Sales in Australia]. (also uses hCard)
* [http://rosebleed.net/events/ Rosebleed] uses hCalendar markup on the Events calendar and individual Event pages.
* [http://www.hotmix.org/calendar/icalendar/icalagenda.php?Calendar=AnnMeetAgenda The National Asphalt Pavement Association] uses hCalendar on its meeting agenda pages. It features a selective iCalendar/CSV download option. The calendar data comes from an ASP web service on their exchange server. The hCalendar, iCalendar and CSV outputs are all generated with PHP.
* The [http://www.ox.ac.uk/ University of Oxford (UK)] has a locally produced institutional newsfeed system ([http://www.oucs.ox.ac.uk/oxitems/ OXITEMS]) where members of the University can create newsfeeds and add items to those newsfeeds. One of the possibilities is to use a newsfeed to represent a collection of events. This kind of newsfeed can be delivered in the Atom 1.0 notation where the content element of each entry element has [http://rss.oucs.ox.ac.uk/running/events-demo/atom10.xml some hCalendar embedded in it]. It is also possible to obtain an event in iCalendar notation or to obtain all the events of the newsfeed [http://rss.oucs.ox.ac.uk/running/events-demo/getevents.ics in iCalendar notation]. For this, it uses [http://suda.co.uk/projects/X2V/ Brian Suda's X2V] to produce the iCalendar from Atom 1.0.
*Wikipedia-EN - [[User:AndyMabbett|Andy Mabbett]]
**I have added hCalendar to the [http://en.wikipedia.org/wiki/Template:Infobox_Space_mission Infobox Space mission] template, with dates entered using the [http://en.wikipedia.org/wiki/Template:Start_date Start date] and [http://en.wikipedia.org/wiki/Template:End_date end date] templates (to counter the lack of support for the <code>abbr</code> element). Example: [http://en.wikipedia.org/wiki/Apollo_11 Apollo 11]. Work on improvements is continuing, prior to roll-out.
**Now used in templates for album (e.g. [http://en.wikipedia.org/wiki/The_Dark_Side_of_the_Moon The Dark Side of the Moon]), single (e.g. [http://en.wikipedia.org/wiki/I_Want_to_Hold_Your_Hand I Want to Hold Your Hand]) and film (e.g. [http://en.wikipedia.org/wiki/The_Piano The Piano] release dates.
**Every day from 1 July 2006 onwards has its news events rolled into a single hCalendar item, via the [http://en.wikipedia.org/wiki/Portal:Current_events current events portal]; earlier dates will be converted shortly.
**Issues: non-inclusive end date; no HH:MM:SS component as yet
* [http://my.opera.com/Kilimanjaro07/blog/ My Opera] uses hCalendar to mark-up Countdowns in blog/group sidebars.
* [http://www.nensa.net/sched&result/racing_index.php New England Nordic Ski Association's Calendar] marked up in hCalendar.
* [http://www.lshtm.ac.uk/events/ London School of Hygiene & Tropical Medicine's Events section] supports hCalendar.
* [http://hope-international.com/fundraising/07_springdinners.html HOPE International's Spring Fundraising Dinner Events] marked up in hCalendar.
* [http://www.brewerdesigngroup.com/barcamp-hcalendar.html The schedule for BarCamp San Diego] marked up in hCalendar.
* [http://2007.xtech.org/public/schedule/full The schedule for XTech 2007] uses hCalendar.
* [http://www.seemsartless.com seemsArtless daily photoblog] - embeds hCalendar markup for each photo, with GEO markup for photos with significant geographic locations ( such as with [http://www.seemsartless.com/index.php?pic=348 this photo] )
* [http://www.ischool.washington.edu/ Information School of the University of Washington] - now embeds hCalendar markup on all of it's events
** Example here: [http://www.ischool.washington.edu/events/calendar.aspx Events Calendar]
* [http://playinghere.com/ Playing Here] uses hCalendar for live music shows in America, [http://playinghere.com/2007/07/07/CA/Los_Angeles/The_Hollywood_Bowl/ e.g.]
* [http://www.thsh.co.uk THSH] uses iCalendar for events at Town Hall Birmingham and Symphony Hall Birmingham
* [http://www.anfsusa.org/ America-Nepal Friendship Society] uses hCalendar for its program events
** Example here: [http://www.anfsusa.org/news/programs-projects/ ANFS: Programs & Projects]
* [http://www.friendsofthechildrenny.org/ Friends of the Children, New York] - uses hCalendar for upcoming fundraising events
** Example here: [http://www.friendsofthechildrenny.org/events.html Events]
* [http://www.depechemode.de www.depechemode.de] - uses hCalendar for events in the party guide
** Example here: [http://www.depechemode.de/parties/show-party.php?cat=1 Depeche Mode Parties]
* [http://last.fm last.fm] - uses hCalendar on all concert announcements.
** Example here: [http://www.last.fm/event/75615 Rise Against at Arena, Wien]
* [http://www.radiotimes.com Radio Times] - now mark up all their radio and TV listings.
**The hCals on listings are good, but on pages for individual programmes, they have no date/times - for instance [http://www.radiotimes.com/ListingsServlet?event=10&channelId=56&programmeId=57876521&jspLocation=/jsp/prog_details_fullpage.jsp]
** Would benefit from using [[include-pattern]] for channel name in main listings. This would facilitate the writing of parsers to set audio or video recording software. [[User:AndyMabbett|Andy Mabbett]]
* [http://nederlandskamerkoor.nl Dutch Chamber Choir] uses hCalendar to notify visitors of their tour schedule.
* [http://cloudislands.com Cloud Islands] uses hCalendar to notify our customers about the conferences we'll be attending.
* [http://www.international.unt.edu UNT International] uses hCalendar for events (see esp. [http://www.international.unt.edu/offices/welcome/events/intlweek/calendar International Week 2007 Event Calendar])
* [http://www.rockisland.com/%7elopezmuseum/index.html The Lopez Island Historical Society and Museum] uses hCalendar for events
* [http://futureofwebapps.com/schedule.html Future of Web Apps London] lists its schedule in hcalendar.
* [http://leicesteryha.org.uk/cgi-bin/leoprog Leicester YHA Group's programme page] uses hCalendar and hCard to mark up forthcoming events and their organisers.
* [http://www.wadip.org.uk/pages/events.php Wadhurst Independent Photography events] lists forthcoming events in hCalendar format.
* [http://xlntads.com/about-xlntads/development-schedule.php XLNTads-development schedule] has their project development schedule timeline marked up in hcal (as well as contacts in hCard)
* [http://www.jaama.co.uk Jaama] have their event details as iCal downloads on their [http://www.jaama.co.uk/HS_Seminars.aspx workshops] page.
* [http://3amproductions.net 3AM Productions] has employee education ([http://3amproductions.net/jason.php Jason], [http://3amproductions.net/gilbert.php Gilbert]) marked up in hCalendar
* The [http://neatta.org New England Antique Tractor & Truck Association] (of all sites) has their 15 upcoming events marked up in hCalendar (as well as contacts in hCard and classifieds in hListing)
* [http://diarised.com Diarised] is a quick and simple online tool to help pick the best time for a meeting, uses hCalendar for meeting information.
* [http://etnies.com/ etnies.com] uses hCalendar on each sports home page ([http://etniesskate.com/ etniesskate.com]) and the [http://etnies.com/extra/calendar/ calendar of events] page.
* [http://www.mdas.org/ La maison des associations de Strasbourg] uses hCalendar on event pages.
* [http://nuggetshoops.com/schedule.php NuggetsHoops] , an NBA fansite, uses hCalendar for each remaining game in the current season.
* [http://wikevent.org WikEvent] aims to make it as easy as possible to put events on the web with semantic markup, including hCalendar for events and hCard for venues and artists.
* [http://fundyfilm.ca/calendar/ The Fundy Film Society] uses hCalendar for their calendar of upcoming film screenings.
* Psychology Press and Routledge's Behavioral Sciences' publishing division have implemented hCalendar on their conferences listings on 17 of their websites (example on the conference listing on their [http://www.clinicalpsychologyarena.com/resources/conferences.asp Clinical Psychology Arena])
* [http://jhtc.org Jewish High Tech Community] uses hCalendar on event pages.
*[http://www.gore-tex.com/remote/Satellite?c=fabrics_content_c&cid=1162322807952&pagename=goretex_en_US%2Ffabrics_content_c%2FKnowWhatsInsideDetail Gore-Tex "Know What's Inside"] tour dates in hCalendar by [http://microformats.org/wiki/User:Csarven csarven]
* [http://finetoothcog.com/site/stolen_bikes Finetoothcog] uses hCalendar to markup when bikes are stolen.
* [https://www.urbanbody.com/information/contact-us Urban Body Men's Clothing] uses hCalendar for business hours and hCard for business locations.
* [http://www.infoiasi.ro The website of the Faculty of Computer Science], "A. I. Cuza" University Iaşi, Romania, uses hCalendar to markup events.
* [http://www.crosbyheritage.co.uk/events/ Colin Crosby Heritage Tours] uses hCalendar to markup events.
* [http://www.facebook.com Facebook] use hCalendar to markup events.
**'''Example needed''' (no such microformat on this [http://www.facebook.com/event.php?eid=6494697371 public event])
* [http://www.newbury-college.ac.uk/ Newbury College UK] uses a smattering of hCalendar and hCard
* [http://07.pagesd.info/ardeche/agenda.aspx 07.pagesd.info] uses hCalendar and hCard to mark up events of the Ardèche département in France.
* [http://climbtothestars.org Stephanie Booth] announced the [http://climbtothestars.org/archives/2006/09/14/microformats-et-bloggy-friday-doctobre/ Bloggy Friday for October 2006] using hCalendar.
* The [http://www.westmidlandbirdclub.com/ West Midland Bird Club], in the English Midlands, uses hCal (with nested hCard) on its [http://www.westmidlandbirdclub.com/diary/ diary of birding events].
* [http://www.comtec-ars.com/press-releases/ ComTec audience response systems' press releases] use hCalendar as a method to organize by title and date.
* [http://webdirections.org/program/ The Web Directions Conference (Sydney Australia)] uses hCalendar for their program. It uses axis and headers for events in a table, and demonstrates how easy it is to make the whole thing downloadable using X2V.
* [http://www.thestreet.org.au/ The Street Theatre (Canberra, Australia)] now uses hCalendar for performances on its [http://www.thestreet.org.au/whats_on.htm What's On] page.
* [http://www.clacksweb.org.uk Clackmannanshire Council] uses hCalendar on its [http://www.clacksweb.org.uk/community/events/ event diary] listing pages and individual event pages.
* [http://www.markthisdate.com/ Calendarportal MarkThisDate.com] now uses hCalendar for all calendars. On our website visitors can add calendars and download calendars to Outlook, Lotus Notes, iCal, Netvibes, 30Boxes, Google Calendar and many others. Over 600 calendars were already uploaded.
* [http://mogue.jp/ mogue] uses hCalendar at [http://mogue.jp/event/1000/ event detail] pages.
* [http://www.gustavus.edu/events/nobelconference/2006/schedule.cfm 2006 Nobel Conference] uses hCalendar for the conference schedule
* [http://www.geekinthepark.co.uk Geek in the Park] uses hCalendar for the event information. -- by [[User:Trovster|trovster]]
* [http://www.besancon.fr/ official site of Besançon (France)] for its events
* [http://2006.dconstruct.org/schedule/ Conference schedule for d.Construct 2006] is published using hCalendar.
* [http://local.yahoo.com Yahoo Local] now supports hCalendar
* We used hcalendar for the [http://www.fuckparade.org/flyer/2006/ F’parade flyer 2006], a counter demonstration to the Love Parade in Berlin, alas the '''Firefox tails extension''' doesn't get a summary when it's an alt-text in an image.
* [http://www.harper-adams.ac.uk/press/events.cfm Harper Adams University College] uses hCalendar to mark up all University events on the Homepage and Events Calendar page.
* [http://www.capital.edu/ Capital University] uses hCalendar on multiple pages to provide feeds of events, relevant to page content
* [http://www.thesession.org/events/ The Session events] uses hCalendar to mark up concerts, festivals and workshops related to Irish traditional music.
* [http://rubyandrails.org/usergroups/newcastle ncl.rb] uses hCalendar to mark up new meetings.
* [http://www.webanalyticsassociation.org/en/calendarevents/search.asp Web Analytics Association] - hCalendar microformat is in place on all Tendenci sites on the calendar events search page and consolidated list page.
* [http://www.tendenci.com/en/calendarevents/search.asp Tendenci Calendar Events] with hCalendar
* [http://www.argolon.com/2006/04/17/web20-conference-in-dublin/ Web2.0 Conference in Dublin] hCalendar event
* [http://www.meetup.com/ Meetup.com] has marked up [http://www.meetup.com/cities/us/ny/new_york city event calendars], [http://photo.meetup.com/100/events/ group event lists], and [http://www.meetup.com/ signed-in homepages] with hCalendar.
* [http://ukwindsurfing.com/ ukwindsurfing.com] has marked upcoming events with hCalendar, and the [http://ukwindsurfing.com/events/ events page] in a table.
* [http://ocono.com/ ocono.com] has marked up it's "Upcoming Events" list with hCalendar.
* [http://www.austinbloggers.org/ Austin Bloggers] has marked up their "Upcoming Events" box with hCalendar ([http://www.austinbloggers.org/blog/a/001123.html announcement]).
* Ning's cloneable Group app has [[hcalendar|hCalendar]] markup on its [http://group.ning.com/index.php?controller=event&action=list event calendar] and [http://group.ning.com/index.php?controller=event&action=view&id=727220 event detail] pages.
* [http://tantek.com/microformats/2006/03-01-TechPlenAgenda.html Agenda: W3C Technical Plenary Day, March 1 2006] has [[hcard|hCard]] and [[hcalendar|hCalendar]] markup. ([http://www.w3.org/2006/03/01-TechPlenAgenda.html original here]).
* The National Arbor Day Foundation has started using hCalendars for their [http://arborday.org/programs/conferences/communityforestry/index.cfm upcoming] [http://arborday.org/programs/conferences/hazardtrees-treeplanting/ conferences].
* [http://www.stateofflux.com/ State of Flux street art site] has started adding events in hCalendar format
* The [http://barcamp.org/#BarCamps BarCamp home page lists upcoming BarCamps marked up with hCalendar] and even has a "Subscribe..." link.
* [http://www.w3.org/2005/12/allgroupoverview.html 2006 W3C Technical Plenary Week] has marked up the schedule and events for the week with hCalendar.
* [http://www.code4lib.org/2006/schedule code4lib Conference 2006 Schedule] is marked up with hCalendar as [http://www.code4lib.org/node/65 announced on their blog].
* [http://grouper.ieee.org/groups/754 IEEE 754 Working Group] - trying hCalendar for upcoming meetings.
* [http://www.pehuen.org/node/494 Elecciones 2005 Chile] - the first spanish language hCalendar event found in the wild.
* [http://www.codewitch.org/it/2005/11/17/no-creative-commons-no-party/ Giocolando » No Creative Commons? No Party!] is marked up with hCalendar
* [http://www.cmprofessionals.org/events/calendar.html CM Pros Events Calendar] by Bob Doyle
* [http://www.midgard-project.org/community/events/ Midgard CMS Event calendar] - as [http://bergie.iki.fi/blog/new-event-calendar-for-midcom.html blogged by Henri Bergius]
* [http://www.iowamilitaryveteransband.com/schedule/ Iowa Military Veterans Band Schedule] - hCalendar markup [http://weblog.randomchaos.com/archive/2005/10/24/Microformats/ added by Scott Reynen]
* [http://www.funfairgames.net/weblog/posts/00000011.html Upcoming events on Jason A.R. Moody Amusements Weblog] posted by Jason Moody on 15 Oct 2005. [http://www.funfairgames.net/weblog/index.html His weblog] in general has hCalendar events posted inside the blog posts.
* [http://tantek.com/microformats/2005/syndicate/tracks-sessions-schedule.html Syndicate - Tracks & Sessions]
* [http://tantek.com/microformats/2005/web2/program.html Web 2.0 Conference schedule page marked up with hCalendar]
* [http://www.thisiscmon.com/ C'MON] is a rock band from Canada, and their [http://www.thisiscmon.com/shows/ tour dates] have been marked up by [http://www.d2digitalmedia.com/ Ray Dickman] with hCalendar.
* [http://ifreebusy.com/ ifreebusy.com] will display freebusy information using hCalendar. See this [http://ifreebusy.com/neiljensen/freebusy/ example].
* [http://we05.com/ Web Essentials 05] has marked up their [http://we05.com/program.cfm program schedule table with hCalendar], using the 'axis' and 'headers' attributes.
* [http://www.asdvbonaparte.nl/ ASDV Bonaparte] is a Dutch debating society. Their events calendar has been marked up with the hCalendar conventions.
* [http://chocnvodka.blogware.com/blog Suw Charman] has marked up [http://suw.org.uk/archives/category/events/ her events] with hCalendar.
* [http://www.blogbusinesssummit.com/ Blog Business Summit] has published their [http://www.blogbusinesssummit.com/details.htm event details] marked up with hCalendar.
* [http://eventful.com Eventful.com] publishes all events with hCalendar and venues with [[hcard|hCard]]. Took them only 15 minutes to implement both! Their Atom feeds also contain hCalendar/hCard.
* [http://upcoming.org Upcoming.org] publishes all events and lists of events with hCalendar. Took them only an hour to add hCalendar support to the site.
** The dtend values for events with no time specified (like [http://upcoming.org/event/110145/ | Burning Man] are not exclusive. This causes problems when sending the microformats info to places like Google. They do correct the dtend when exporting to Outlook though. They have been made aware of the problem.
* The [http://laughingsquid.com/squidlist/calendar/ Laughing Squid Calendar] events, [http://laughingsquid.com/squidlist/calendar/9949/2005/5/9 e.g. this party], now supports hCalendar.
* [http://paulschreiber.com/ Paul] Schreiber's [http://concerts.shrub.ca/ Sunnyvale House Concerts] site publishes hCalendar event information for upcoming concerts. In addition the [http://concerts.shrub.ca/shows Past Shows] page contains hCalendar events for all past concerts.
* [http://www.complexspiral.com/ Complex Spiral Consulting], both in the "Events" box on left side, and the separate [http://www.complexspiral.com/events/ Events page].
* [http://tantek.com/log Tantek's Thoughts], specifically the "Events" roll in the right-most column.
* [http://suda.co.uk/projects/holidays/ Lesser Known Holidays], a list of holidays on [http://suda.co.uk suda.co.uk] that can be imported via iCal and hCal so you can compare actual transformation versus intended.
* [http://norman.walsh.name/2005/itinerary/ Norm Walsh's travel schedule] use hCalendar as well as GRDDL.
* [http://www.policyawareweb.org/2005/ftf2/paw-mtg Policy Aware Web (PAW) Project Meeting] uses hCalendar to record date-related decisions, and uses a vtodo microformat to record action items.
* The [http://lufgi4.informatik.rwth-aachen.de Laboratory for Dependable Distributed Systems] publishes it's [http://lufgi4.informatik.rwth-aachen.de/cfps list of notable CfPs on dependability and security] with hCalendar-todo elements.
* The [http://laughingsquid.com/laughing-squid-10th-anniversary-party/ Laughing Squid 10th Anniversary Party] has an hcalendar page.
* SPRACI has hcalendar versions of its nightlife/clubbing/gigs/festivals listings for many cities worldwide - eg: [http://www.spraci.com/listhcalendar.php?parea=sydney&category=all Events in Sydney] (check the [http://www.spraci.com/api/ API] pages in the faq section of [http://www.spraci.com/ SPRACI] for more info about the area/city keywords and category tags to use to get data for your city/categories
* WWF-Australia events calendars: [http://wwf.org.au/act/events/ What's on], [http://wwf.org.au/act/volunteer/ Volunteer]
* [http://rubyholic.com rubyholic] uses hCalendar to publish calendars for ruby groups.
* [http://www.bath.ac.uk/whats-on/ University of Bath What's On] uses hCalendar on individual event pages
* The [http://www.kiez-ev.de/ Kiez] is a small cinema and has published its [http://www.kiez-ev.de/programm program] marked up with hCalendar
* [http://walkwithmetours.net/ Walk With Me Tours ] provides walking tours of Seattle, WA. The selected tours on [http://walkwithmetours.net/take-a-tour.php Take a Tour] are marked up with hCalendar.
====World Cup Kick-off====
* [http://www.worldcupkickoff.com/ World Cup KickOff] where you can download and keep all the fixtures you are interested in so you will never miss a single game of the 2006 football World Cup!
** This link was on the [http://www.lifehacker.com/software/sports/world-cup-start-times-for-ical-etc-175393.php Lifehackers site] and made its way to the yahoo news site:

<blockquote>
Mon May 22, 4:00 PM ET
The World Cup, one of the world's most watched sporting events, is almost upon us. If you've ever tried to follow your favorite team through the Cup you know that it can sometimes be difficult to know when they're on. World Cup Kickoff can help.

World Cup KickOff is all you will ever need for knowing all the match details for the upcoming World Cup 2006. Whether you use your mobile phone, MS Outlook, Apple iCal or Mozilla Calendar, you can download and keep all the fixtures you are interested in so you will never miss a single game!

Next tip? We'll show you how to get up at 2 AM to watch your matches. ;0) Thanks to Tom for the tip!
</blockquote>

=== examples with some problems ===
<span id="Examples_with_some_problems"></span>
If you find a problem with any example in any other section, please move it here, and note the precise problem and cite the section of the [[hcalendar | hCalendar spec]] that appears to be violated. If the example that was moved here is yours, and you want to improve it, see the [[hcalendar-faq| hCalendar FAQ]], or raise any queries on [[hcalendar-issues| hCalendar issues]] or [[mailing-lists#microformats-discuss|the mailing list]], where people will be happy to help you.

* [http://www.tpexpress.co.uk/Liverpool08-Capital-of-Culture/ First TransPennine Express - Liverpool 08, Capital of Culture] - uses hCalendar markup for events.
**'''Suboptimal''', not using exclusive date end. [[User:AndyMabbett|Andy Mabbett]] 12:25, 17 Feb 2008 (PST)
* [http://www.konplan.com konplan.com] - uses hCalendar markup in their event container
** Examples: http://www.konplan.com/public1/_EN/index.php
**'''Suboptimal''', has wrong values in <code>dtend</code>
*** Should be fixed. Can anyone check on it -- I'd like to move it back to examples above. --[[User:AndreasLappe|AndreasLappe]] 07:32, 23 Jan 2008 (PST)
**** Better, but the new end dates are not exclusive (this is a frequently-occurring problem, requiring a rethink of the way the microformat works). [[User:AndyMabbett|Andy Mabbett]] 10:13, 23 Jan 2008 (PST)
***** Should be fixed too. Again, I'd appreciate comments... --[[User:AndreasLappe|AndreasLappe]] 05:22, 25 Jan 2008 (PST)
****** Do those events really run from midnight to midnight? [[User:AndyMabbett|Andy Mabbett]] 05:56, 25 Jan 2008 (PST)
******* They don't. They are all-day events. I was working with [http://lists.osafoundation.org/pipermail/ietf-calsify/2005-September/000769.html] -- wrong? --[[User:AndreasLappe|AndreasLappe]] 06:08, 25 Jan 2008 (PST)
******** That's not usual practice (I'd say it gives a false level of precision), but should perhaps be raised at [[hcalendar-issues]] for clarification. [[User:AndyMabbett|Andy Mabbett]] 02:47, 28 Jan 2008 (PST)
* [http://wiki-translation.com wiki-translation.com] - uses hCalendar markup for events.
**Built-in feature for [http://TikiWiki.org TikiWiki CMS/Groupware] 1.10
**'''Hidden''', data hidden using CSS. [[User:AndyMabbett|Andy Mabbett]] 06:51, 15 Jan 2008 (PST)
***Should be fixed. Can anyone check on it? -- I'd like to move it back to examples above. --[[User:MarcLaporte|MarcLaporte]] 16:58, 4 Mar 2008 (PST)

* [http://konferenciakalauz.hu konferenciakalauz.hu] uses hCalendar for events (in Hungarian).
**'''Suboptimal''', not using exclusive date end. [[User:AndyMabbett|Andy Mabbett]] 13:18, 24 Sep 2007 (PDT)
***Fixed
* [http://www.chronii.com/ chronii.com], a site for creating, searching, and cross-referencing timelines, presents events marked up in hCalendar.
**'''Suboptimal''', '''Hidden''': [http://www.chronii.com/e/line.jsp?ti=1&q=The+Internet] uses <code><nowiki><abbr class="dtstart" title="1991-01-01"></abbr> <abbr class="dtend" title="1992-01-01"></abbr></nowiki></code> for a whole-year date of "1991"
* [http://www.gretchenland.com Gretchen] has their show schedule marked up with hCalendar
** Example here: [http://www.gretchenland.com/shows Upcoming Concert Dates]
**Invalid: <code><nowiki><SPAN title="2007-04-21" class="dtstart">04.21.2007</SPAN></nowiki></code> [[User:AndyMabbett|Andy Mabbett]] 02:08, 20 Apr 2007 (PDT)
* I'd be happy if some future french Pinko-marketing meetings (CantineCamp) could require the use of hCalendar for listing some informal lunches in Paris. [http://www.wikiservice.at/fractal/wikidev.cgi?FR/PinkoMarketing/CantineCampParis10 CantineCampParis10 is an example] to include a hCalendar + hCard markup on the wiki-page. When converting to vCard, "Mendès" accent is malformed in a french outlook 2003 "address book". I've looked UTF-8 example but could not find any way to correct. Any idea ? -- [[User:ChristopheDucamp|xtof]] 01:09, 26 Mar 2007 (PDT)
* [http://www.joomlamug.com Joomla! Melbourne User Group] uses hCalendar markup for listing of all events.
** No examples on cited page. [[User:AndyMabbett|Andy Mabbett]] 15:06, 31 Jan 2007 (PST)
* [http://www.webfeet.org/events.html Webfeet events] includes hCalendar markup in its aggregated events lists.
** <s>Possibly a case where <nowiki><abbr></nowiki> won't work for dtstart/dtend as there are many events listed under a single date. [[User:Webf|Webf]] 15:19, 15 Jan 2007 (PST)</s>
**Malformed e.g <code><nowiki><span class="dtstart" title="20070120"></span></nowiki></code> [[User:AndyMabbett|Andy Mabbett]] 15:41, 15 Jan 2007 (PST)
** Continue the discussion under [[hcalendar-issues|hCalendar Issues]] perhaps. [[User:Webf|Webf]] 22:25, 15 Jan 2007 (PST)
* [http://www.theatrestudies.llc.ed.ac.uk/ Theatre Studies: European Theatre] at the University of Edinburgh uses hCalendar to markup news and events on the index page.
**<s>Uses "display:none" on image. [[User:AndyMabbett|Andy Mabbett]] 15:32, 13 Nov 2006 (PST)</s> Removed img tag from hCard
* [http://www.bokle.de/ s'Bokle] is a German music pub. Their events calendar has been marked up with hCalendar.
** improper use of rrule --[[User:RyanKing|RyanKing]] 16:04, 6 Jan 2006 (PST)
* [http://plan9.tryphon.org/nancy/list Plan9] - Uses hCalendar to mark up events !
** <s>dtstart/dtend are implemented on span element [[User:TomArmitage|Tom Armitage]] June 23, 2006</s> --[[User:Tim|Tim]] 13:34, 4 Mar 2007 (PST) Fixed now
* [http://www.socaltech.com socalTECH] is a news and information site. Their front page event listing is marked up with hCalendar.
** dtstart/dtend implemented on span element [[User:TomArmitage|Tom Armitage]] June 23, 2006
* [http://www.multipack.co.uk The Multipack] features a vevent for the next meeting information.
** dtstart/dtend are implemented on em element [[User:TomArmitage|Tom Armitage]] June 23, 2006
* [http://paulschreiber.com/ Paul] Schreiber's [http://iceoasis.shrub.ca/ unofficial schedule site] publishes hCalendar information for upcoming hockey games at [http://www.iceoasis.com/ Ice Oasis]
** dtstart/dtend are implemented on td element [[User:TomArmitage|Tom Armitage]] June 23, 2006

- whilst Tails parses the "title" attribute for dtstart/dtend on <em>any</em> element (does Tails still do this?), that is incorrect. The title attribute only provides semantics for the <code><nowiki><abbr></nowiki></code> element, while for elements in general like <code><nowiki><span></nowiki></code>, only the contents of the element are used. This is a simplification and see [[hcard-parsing|hCard parsing]] for details. Technorati Microformats Search only looks for the title attribute on <code><nowiki><abbr></nowiki></code> tags per the rules from [[hcard-parsing|hCard parsing]] which apply to [[hcalendar-parsing|hCalendar parsing]] as well.

=== reviewed examples ===
<span id="Reviewed_Examples"></span>
If you have reviewed a New Example (and you are not the author of the example) and believe it to be valid, go ahead and move it here.
* ...

== grouped examples ==
=== listings of upcoming local events ===
* ...
=== archives of local event listings ===
==== Laughing Squid Calendar ====
* The [http://laughingsquid.com/squidlist/calendar/ Laughing Squid Calendar] events listings supported [[hcalendar|hCalendar]]
** [http://laughingsquid.com/squidlist/calendar/month/2003/2 2003 February] thru [http://laughingsquid.com/squidlist/calendar/month/2006/9 2006 September]

=== conference schedules ===
* [http://adactio.com/extras/schedules/barcamplondon3/ BarCamp London 3 Schedule] - uses hCalendar in a semantic <code>table</code> with <code>id</code> and <code>headers</code> attributes. Provides "Subscribe" and "Download" links using the [http://feeds.technorati.com/events/ Technorati Events Feed service].
* [http://adactio.com/extras/schedules/web2expo-berlin/ 2007 Web 2.0 Expo Berlin Schedule] - uses hCalendar in a semantic <code>table</code> with <code>id</code> and <code>headers</code> attributes. Provides "Subscribe" and "Download" links using the [http://feeds.technorati.com/events/ Technorati Events Feed service].

== related pages ==
{{hcalendar-related-pages}}

hcalendar-examples-in-wild

2008-11-03T15:24:55Z

James Tindall: permatime.com hcalendar usage and generator

<h1>hCalendar Examples in the wild</h1>
{{TOC-right}}
This page is an '''informative''' section of the [[hcalendar|hCalendar specification]].

The following sites have published events using [[hcalendar|hCalendar]], and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc.

If events on your site are marked up with hCalendar, feel free to add it to the top of this list. Please be sure to include at least one URL of a page on your site that includes actual [[hcalendar|hCalendar]] markup. Examples added without the URL of a page with hCalendar markup may be removed.

Want to get started with writing an [[hcalendar|hCalendar]] event? Use the [http://microformats.org/code/hcalendar/creator hCalendar creator] to write up an event and publish it, or follow the [[hcalendar-authoring|hCalendar authoring tips]] to add hCalendar markup to your page of upcoming events or events you mention in blog posts, wikis, etc.

Don't forget that you can add one of our [[buttons#hCalendar|buttons]] to the page, to indicate the presence of hCalendar microformats. For example: http://www.boogdesign.com/images/buttons/microformat_hcalendar.png. If you can link it back to [[hcalendar|hCalendar]] (or even page on your website, about your use of the microformat), so much the better!

== examples to act on ==

===new examples===
<span id="New_Examples"></span>
Please add new examples to the '''top''' of this section.
* [http://permatime.com/ Permatime] site for sharing points intime accross times zones. It uses hcalendar and can be used as a quick way of generating hcalendar events.
* [http://www.bath.ac.uk/ University of Bath] uses hCalendar to mark up their [http://www.bath.ac.uk/semester/ semester timetable]
* [http://www.php.net/ PHP.net] uses hCalendar in their [http://www.php.net/conferences/ Conference Announcements] and [http://www.php.net/cal.php Event Calendar].
* [http://www.maine.gov/portal/help/microformats.html Maine.gov] uses microformats in their Calendar of Events and has a nice explanation page about microformats.
* [http://www.viewfilm.net/ Film on Freeview] uses hCalendar to mark up upcoming film listings on free-to-air UK television.
* [http://local.mapquest.com/ MapQuest Local] uses hCards for locations, hCalendar for events and supports the draft Geo format when lat/lng data is provided. See [http://blog.mapquest.com/2008/09/25/microformat-support-on-mapquest-local/ Microformat Support on MapQuest Local] for more information.
* [http://www.cambridgefilmfestival.org.uk/ Cambridge Film Festival] uses hCalendar to mark up the [http://www.cambridgefilmfestival.org.uk/films/list/order/date festival schedule].
* [http://www.law.georgetown.edu Georgetown Law Center] uses hCalendar to mark up faculty scholarly that take place on campus, listing them in the [http://www.law.georgetown.edu/faculty/events/ Faculty Workshops, Lectures and Symposia] system.
* [http://www.ecovian.com Ecovian] uses hCalendar to mark up green living & environmental event details, see [http://www.ecovian.com/event/sanfrancisco San Francisco Green Events] example
* [http://beta.subpop.com/ SubPop Records] features hCalendar events on its homepage and on [http://subpop.com/artists/band_of_horses individual artist pages].
* [http://laughingsquid.com/squidlist/events/ Laughing Squid Events] use hCalendar ''only'' on event detail pages (not on the overall list of events), e.g. [http://laughingsquid.com/squidlist/events/index.php?com=detail&eID=177533&year=2008&month=06 Pownce 1 Year Anniversary Party!].
* [http://www.outbackadventuretreks.com.au Outback Adventure Treks] use hCalendar for their [http://outbackadventuretreks.com.au/tours_calendar.php tours calendar] also hCard for their [http://outbackadventuretreks.com.au/contact.php contact details.]
* [http://www.dancefederation.co.uk Dance Federation Salsa Dancing & Jive Dancing Lessons and Events ] Directory for classes, lessons and events users hcalendar, hcard, geo for events and lessons.
* [http://library.christchurch.org.nz/News/ Christchurch City Libraries] news and events calendar - many but not all events.
* [http://www.villamedia.nl/agenda Villamedia] and [http://www.dejournalist.nl/agenda De Journalist] (both Dutch websites for journalists and media workers) use hCalendar to mark up their (shared) events list.
* At [http://www.ecoresearch.net/event ECOresearch.net] we export our event calendar as hCalendar.
* [http://www.firmendb.de/messetermine/index.php Fimendb Messetermine] uses hCalendar markup to add semantic meaning to the calendar of fairs and exhibitions.
* [http://www.kickstartme.co.uk KickStart Events] uses hCalendar markup to add semantic meaning to our calendar of events for forthcoming RubyOnRails workshop and courses.
* The [http://www.amentsoc.org/events/ Amateur Entomologists' Society] uses hCalendar in our calendar of events for entomologists or people with an interest in natural history.
* The [http://www.sandiegobrewersguild.org/calendar.php San Diego Brewers Guild] is using hCalendar for member brewers’ and pubs’ upcoming events.
* The [http://users.belgacom.net/gaudete Gregorian choir Gaudete] from Aalst (Belgium) uses hCalendar in their calendar of upcoming performances.
* [http://autopendium.com/events Classic Car Events] - Classic car events -- shows, auctions, race meetings -- from around the world marked up with hCalendar.
* [http://www.worldeventsguide.com World Events Guide] - Events occuring around the world marked up with hCalendar.
* [http://www.niallkennedy.com/about/ Niall Kennedy's Upcoming speeches] - hcalendar describing upcoming speeches occurs within the bounds of the parent hCard. Each vevent references said hCard using "include" method and attendee or organizer where appropriate. One vevent's description is a vcalendar itself, specifying multiple events (speeches) within the event and Niall's role in each, again with hCard include.
** The hcard include breaks one of the rules of the [[include-pattern]]: 'To prevent infinite loops, if a class="include" refers to itself or to an ancestor in the parse tree, then it is ignored and has no effect on the parser.'
* [http://competitiondiva.com/calendar.html Competition Diva's Event Calendar] is marked up with hCalendar.
* [http://www.bicyclepaper.com/calendar BicyclePaper Calendar] - Cycling event calendar marked up in hCalendar format
* [http://floatingsheep.com/userscripts/evite-hcalendar.user.js Evite hCalendar] - userscript to add hCalendar markup to eVite invitation pages
* [http://www.tripit.com/ TripIt] - uses hCalendar markup for every itinerary
* [http://www.leaguist.com Leaguist] - uses hCalendar markup sporting events
** Examples: http://www.leaguist.com/super-14-2008/games/, http://www.leaguist.com/super-14-2008/pick/1
* [http://www.areaguides.net areaguides.net] - uses hCalendar markup on all of our event pages
** Examples: http://newyorkny.areaguides.net/events.html, http://chicagoil.areaguides.net/events.html
* [http://www.keevu.com Keevu.com] - embeds hCalendar markup on all of it's events announcements
** Example here: [http://www.keevu.com/events Latest events]
* [http://www.auctionlink.com.au/ AuctionLink] uses hCalendar markup to show dates and times for [http://www.auctionlink.com.au/UpcomingAuctionSales Auction Sales in Australia]. (also uses hCard)
* [http://rosebleed.net/events/ Rosebleed] uses hCalendar markup on the Events calendar and individual Event pages.
* [http://www.hotmix.org/calendar/icalendar/icalagenda.php?Calendar=AnnMeetAgenda The National Asphalt Pavement Association] uses hCalendar on its meeting agenda pages. It features a selective iCalendar/CSV download option. The calendar data comes from an ASP web service on their exchange server. The hCalendar, iCalendar and CSV outputs are all generated with PHP.
* The [http://www.ox.ac.uk/ University of Oxford (UK)] has a locally produced institutional newsfeed system ([http://www.oucs.ox.ac.uk/oxitems/ OXITEMS]) where members of the University can create newsfeeds and add items to those newsfeeds. One of the possibilities is to use a newsfeed to represent a collection of events. This kind of newsfeed can be delivered in the Atom 1.0 notation where the content element of each entry element has [http://rss.oucs.ox.ac.uk/running/events-demo/atom10.xml some hCalendar embedded in it]. It is also possible to obtain an event in iCalendar notation or to obtain all the events of the newsfeed [http://rss.oucs.ox.ac.uk/running/events-demo/getevents.ics in iCalendar notation]. For this, it uses [http://suda.co.uk/projects/X2V/ Brian Suda's X2V] to produce the iCalendar from Atom 1.0.
*Wikipedia-EN - [[User:AndyMabbett|Andy Mabbett]]
**I have added hCalendar to the [http://en.wikipedia.org/wiki/Template:Infobox_Space_mission Infobox Space mission] template, with dates entered using the [http://en.wikipedia.org/wiki/Template:Start_date Start date] and [http://en.wikipedia.org/wiki/Template:End_date end date] templates (to counter the lack of support for the <code>abbr</code> element). Example: [http://en.wikipedia.org/wiki/Apollo_11 Apollo 11]. Work on improvements is continuing, prior to roll-out.
**Now used in templates for album (e.g. [http://en.wikipedia.org/wiki/The_Dark_Side_of_the_Moon The Dark Side of the Moon]), single (e.g. [http://en.wikipedia.org/wiki/I_Want_to_Hold_Your_Hand I Want to Hold Your Hand]) and film (e.g. [http://en.wikipedia.org/wiki/The_Piano The Piano] release dates.
**Every day from 1 July 2006 onwards has its news events rolled into a single hCalendar item, via the [http://en.wikipedia.org/wiki/Portal:Current_events current events portal]; earlier dates will be converted shortly.
**Issues: non-inclusive end date; no HH:MM:SS component as yet
* [http://my.opera.com/Kilimanjaro07/blog/ My Opera] uses hCalendar to mark-up Countdowns in blog/group sidebars.
* [http://www.nensa.net/sched&result/racing_index.php New England Nordic Ski Association's Calendar] marked up in hCalendar.
* [http://www.lshtm.ac.uk/events/ London School of Hygiene & Tropical Medicine's Events section] supports hCalendar.
* [http://hope-international.com/fundraising/07_springdinners.html HOPE International's Spring Fundraising Dinner Events] marked up in hCalendar.
* [http://www.brewerdesigngroup.com/barcamp-hcalendar.html The schedule for BarCamp San Diego] marked up in hCalendar.
* [http://2007.xtech.org/public/schedule/full The schedule for XTech 2007] uses hCalendar.
* [http://www.seemsartless.com seemsArtless daily photoblog] - embeds hCalendar markup for each photo, with GEO markup for photos with significant geographic locations ( such as with [http://www.seemsartless.com/index.php?pic=348 this photo] )
* [http://www.ischool.washington.edu/ Information School of the University of Washington] - now embeds hCalendar markup on all of it's events
** Example here: [http://www.ischool.washington.edu/events/calendar.aspx Events Calendar]
* [http://playinghere.com/ Playing Here] uses hCalendar for live music shows in America, [http://playinghere.com/2007/07/07/CA/Los_Angeles/The_Hollywood_Bowl/ e.g.]
* [http://www.thsh.co.uk THSH] uses iCalendar for events at Town Hall Birmingham and Symphony Hall Birmingham
* [http://www.anfsusa.org/ America-Nepal Friendship Society] uses hCalendar for its program events
** Example here: [http://www.anfsusa.org/news/programs-projects/ ANFS: Programs & Projects]
* [http://www.friendsofthechildrenny.org/ Friends of the Children, New York] - uses hCalendar for upcoming fundraising events
** Example here: [http://www.friendsofthechildrenny.org/events.html Events]
* [http://www.depechemode.de www.depechemode.de] - uses hCalendar for events in the party guide
** Example here: [http://www.depechemode.de/parties/show-party.php?cat=1 Depeche Mode Parties]
* [http://last.fm last.fm] - uses hCalendar on all concert announcements.
** Example here: [http://www.last.fm/event/75615 Rise Against at Arena, Wien]
* [http://www.radiotimes.com Radio Times] - now mark up all their radio and TV listings.
**The hCals on listings are good, but on pages for individual programmes, they have no date/times - for instance [http://www.radiotimes.com/ListingsServlet?event=10&channelId=56&programmeId=57876521&jspLocation=/jsp/prog_details_fullpage.jsp]
** Would benefit from using [[include-pattern]] for channel name in main listings. This would facilitate the writing of parsers to set audio or video recording software. [[User:AndyMabbett|Andy Mabbett]]
* [http://nederlandskamerkoor.nl Dutch Chamber Choir] uses hCalendar to notify visitors of their tour schedule.
* [http://cloudislands.com Cloud Islands] uses hCalendar to notify our customers about the conferences we'll be attending.
* [http://www.international.unt.edu UNT International] uses hCalendar for events (see esp. [http://www.international.unt.edu/offices/welcome/events/intlweek/calendar International Week 2007 Event Calendar])
* [http://www.rockisland.com/%7elopezmuseum/index.html The Lopez Island Historical Society and Museum] uses hCalendar for events
* [http://futureofwebapps.com/schedule.html Future of Web Apps London] lists its schedule in hcalendar.
* [http://leicesteryha.org.uk/cgi-bin/leoprog Leicester YHA Group's programme page] uses hCalendar and hCard to mark up forthcoming events and their organisers.
* [http://www.wadip.org.uk/pages/events.php Wadhurst Independent Photography events] lists forthcoming events in hCalendar format.
* [http://xlntads.com/about-xlntads/development-schedule.php XLNTads-development schedule] has their project development schedule timeline marked up in hcal (as well as contacts in hCard)
* [http://www.jaama.co.uk Jaama] have their event details as iCal downloads on their [http://www.jaama.co.uk/HS_Seminars.aspx workshops] page.
* [http://3amproductions.net 3AM Productions] has employee education ([http://3amproductions.net/jason.php Jason], [http://3amproductions.net/gilbert.php Gilbert]) marked up in hCalendar
* The [http://neatta.org New England Antique Tractor & Truck Association] (of all sites) has their 15 upcoming events marked up in hCalendar (as well as contacts in hCard and classifieds in hListing)
* [http://diarised.com Diarised] is a quick and simple online tool to help pick the best time for a meeting, uses hCalendar for meeting information.
* [http://etnies.com/ etnies.com] uses hCalendar on each sports home page ([http://etniesskate.com/ etniesskate.com]) and the [http://etnies.com/extra/calendar/ calendar of events] page.
* [http://www.mdas.org/ La maison des associations de Strasbourg] uses hCalendar on event pages.
* [http://nuggetshoops.com/schedule.php NuggetsHoops] , an NBA fansite, uses hCalendar for each remaining game in the current season.
* [http://wikevent.org WikEvent] aims to make it as easy as possible to put events on the web with semantic markup, including hCalendar for events and hCard for venues and artists.
* [http://fundyfilm.ca/calendar/ The Fundy Film Society] uses hCalendar for their calendar of upcoming film screenings.
* Psychology Press and Routledge's Behavioral Sciences' publishing division have implemented hCalendar on their conferences listings on 17 of their websites (example on the conference listing on their [http://www.clinicalpsychologyarena.com/resources/conferences.asp Clinical Psychology Arena])
* [http://jhtc.org Jewish High Tech Community] uses hCalendar on event pages.
*[http://www.gore-tex.com/remote/Satellite?c=fabrics_content_c&cid=1162322807952&pagename=goretex_en_US%2Ffabrics_content_c%2FKnowWhatsInsideDetail Gore-Tex "Know What's Inside"] tour dates in hCalendar by [http://microformats.org/wiki/User:Csarven csarven]
* [http://finetoothcog.com/site/stolen_bikes Finetoothcog] uses hCalendar to markup when bikes are stolen.
* [https://www.urbanbody.com/information/contact-us Urban Body Men's Clothing] uses hCalendar for business hours and hCard for business locations.
* [http://www.infoiasi.ro The website of the Faculty of Computer Science], "A. I. Cuza" University Iaşi, Romania, uses hCalendar to markup events.
* [http://www.crosbyheritage.co.uk/events/ Colin Crosby Heritage Tours] uses hCalendar to markup events.
* [http://www.facebook.com Facebook] use hCalendar to markup events.
**'''Example needed''' (no such microformat on this [http://www.facebook.com/event.php?eid=6494697371 public event])
* [http://www.newbury-college.ac.uk/ Newbury College UK] uses a smattering of hCalendar and hCard
* [http://07.pagesd.info/ardeche/agenda.aspx 07.pagesd.info] uses hCalendar and hCard to mark up events of the Ardèche département in France.
* [http://climbtothestars.org Stephanie Booth] announced the [http://climbtothestars.org/archives/2006/09/14/microformats-et-bloggy-friday-doctobre/ Bloggy Friday for October 2006] using hCalendar.
* The [http://www.westmidlandbirdclub.com/ West Midland Bird Club], in the English Midlands, uses hCal (with nested hCard) on its [http://www.westmidlandbirdclub.com/diary/ diary of birding events].
* [http://www.comtec-ars.com/press-releases/ ComTec audience response systems' press releases] use hCalendar as a method to organize by title and date.
* [http://webdirections.org/program/ The Web Directions Conference (Sydney Australia)] uses hCalendar for their program. It uses axis and headers for events in a table, and demonstrates how easy it is to make the whole thing downloadable using X2V.
* [http://www.thestreet.org.au/ The Street Theatre (Canberra, Australia)] now uses hCalendar for performances on its [http://www.thestreet.org.au/whats_on.htm What's On] page.
* [http://www.clacksweb.org.uk Clackmannanshire Council] uses hCalendar on its [http://www.clacksweb.org.uk/community/events/ event diary] listing pages and individual event pages.
* [http://www.markthisdate.com/ Calendarportal MarkThisDate.com] now uses hCalendar for all calendars. On our website visitors can add calendars and download calendars to Outlook, Lotus Notes, iCal, Netvibes, 30Boxes, Google Calendar and many others. Over 600 calendars were already uploaded.
* [http://mogue.jp/ mogue] uses hCalendar at [http://mogue.jp/event/1000/ event detail] pages.
* [http://www.gustavus.edu/events/nobelconference/2006/schedule.cfm 2006 Nobel Conference] uses hCalendar for the conference schedule
* [http://www.geekinthepark.co.uk Geek in the Park] uses hCalendar for the event information. -- by [[User:Trovster|trovster]]
* [http://www.besancon.fr/ official site of Besançon (France)] for its events
* [http://2006.dconstruct.org/schedule/ Conference schedule for d.Construct 2006] is published using hCalendar.
* [http://local.yahoo.com Yahoo Local] now supports hCalendar
* We used hcalendar for the [http://www.fuckparade.org/flyer/2006/ F’parade flyer 2006], a counter demonstration to the Love Parade in Berlin, alas the '''Firefox tails extension''' doesn't get a summary when it's an alt-text in an image.
* [http://www.harper-adams.ac.uk/press/events.cfm Harper Adams University College] uses hCalendar to mark up all University events on the Homepage and Events Calendar page.
* [http://www.capital.edu/ Capital University] uses hCalendar on multiple pages to provide feeds of events, relevant to page content
* [http://www.thesession.org/events/ The Session events] uses hCalendar to mark up concerts, festivals and workshops related to Irish traditional music.
* [http://rubyandrails.org/usergroups/newcastle ncl.rb] uses hCalendar to mark up new meetings.
* [http://www.webanalyticsassociation.org/en/calendarevents/search.asp Web Analytics Association] - hCalendar microformat is in place on all Tendenci sites on the calendar events search page and consolidated list page.
* [http://www.tendenci.com/en/calendarevents/search.asp Tendenci Calendar Events] with hCalendar
* [http://www.argolon.com/2006/04/17/web20-conference-in-dublin/ Web2.0 Conference in Dublin] hCalendar event
* [http://www.meetup.com/ Meetup.com] has marked up [http://www.meetup.com/cities/us/ny/new_york city event calendars], [http://photo.meetup.com/100/events/ group event lists], and [http://www.meetup.com/ signed-in homepages] with hCalendar.
* [http://ukwindsurfing.com/ ukwindsurfing.com] has marked upcoming events with hCalendar, and the [http://ukwindsurfing.com/events/ events page] in a table.
* [http://ocono.com/ ocono.com] has marked up it's "Upcoming Events" list with hCalendar.
* [http://www.austinbloggers.org/ Austin Bloggers] has marked up their "Upcoming Events" box with hCalendar ([http://www.austinbloggers.org/blog/a/001123.html announcement]).
* Ning's cloneable Group app has [[hcalendar|hCalendar]] markup on its [http://group.ning.com/index.php?controller=event&action=list event calendar] and [http://group.ning.com/index.php?controller=event&action=view&id=727220 event detail] pages.
* [http://tantek.com/microformats/2006/03-01-TechPlenAgenda.html Agenda: W3C Technical Plenary Day, March 1 2006] has [[hcard|hCard]] and [[hcalendar|hCalendar]] markup. ([http://www.w3.org/2006/03/01-TechPlenAgenda.html original here]).
* The National Arbor Day Foundation has started using hCalendars for their [http://arborday.org/programs/conferences/communityforestry/index.cfm upcoming] [http://arborday.org/programs/conferences/hazardtrees-treeplanting/ conferences].
* [http://www.stateofflux.com/ State of Flux street art site] has started adding events in hCalendar format
* The [http://barcamp.org/#BarCamps BarCamp home page lists upcoming BarCamps marked up with hCalendar] and even has a "Subscribe..." link.
* [http://www.w3.org/2005/12/allgroupoverview.html 2006 W3C Technical Plenary Week] has marked up the schedule and events for the week with hCalendar.
* [http://www.code4lib.org/2006/schedule code4lib Conference 2006 Schedule] is marked up with hCalendar as [http://www.code4lib.org/node/65 announced on their blog].
* [http://grouper.ieee.org/groups/754 IEEE 754 Working Group] - trying hCalendar for upcoming meetings.
* [http://www.pehuen.org/node/494 Elecciones 2005 Chile] - the first spanish language hCalendar event found in the wild.
* [http://www.codewitch.org/it/2005/11/17/no-creative-commons-no-party/ Giocolando » No Creative Commons? No Party!] is marked up with hCalendar
* [http://www.cmprofessionals.org/events/calendar.html CM Pros Events Calendar] by Bob Doyle
* [http://www.midgard-project.org/community/events/ Midgard CMS Event calendar] - as [http://bergie.iki.fi/blog/new-event-calendar-for-midcom.html blogged by Henri Bergius]
* [http://www.iowamilitaryveteransband.com/schedule/ Iowa Military Veterans Band Schedule] - hCalendar markup [http://weblog.randomchaos.com/archive/2005/10/24/Microformats/ added by Scott Reynen]
* [http://www.funfairgames.net/weblog/posts/00000011.html Upcoming events on Jason A.R. Moody Amusements Weblog] posted by Jason Moody on 15 Oct 2005. [http://www.funfairgames.net/weblog/index.html His weblog] in general has hCalendar events posted inside the blog posts.
* [http://tantek.com/microformats/2005/syndicate/tracks-sessions-schedule.html Syndicate - Tracks & Sessions]
* [http://tantek.com/microformats/2005/web2/program.html Web 2.0 Conference schedule page marked up with hCalendar]
* [http://www.thisiscmon.com/ C'MON] is a rock band from Canada, and their [http://www.thisiscmon.com/shows/ tour dates] have been marked up by [http://www.d2digitalmedia.com/ Ray Dickman] with hCalendar.
* [http://ifreebusy.com/ ifreebusy.com] will display freebusy information using hCalendar. See this [http://ifreebusy.com/neiljensen/freebusy/ example].
* [http://we05.com/ Web Essentials 05] has marked up their [http://we05.com/program.cfm program schedule table with hCalendar], using the 'axis' and 'headers' attributes.
* [http://www.asdvbonaparte.nl/ ASDV Bonaparte] is a Dutch debating society. Their events calendar has been marked up with the hCalendar conventions.
* [http://chocnvodka.blogware.com/blog Suw Charman] has marked up [http://suw.org.uk/archives/category/events/ her events] with hCalendar.
* [http://www.blogbusinesssummit.com/ Blog Business Summit] has published their [http://www.blogbusinesssummit.com/details.htm event details] marked up with hCalendar.
* [http://eventful.com Eventful.com] publishes all events with hCalendar and venues with [[hcard|hCard]]. Took them only 15 minutes to implement both! Their Atom feeds also contain hCalendar/hCard.
* [http://upcoming.org Upcoming.org] publishes all events and lists of events with hCalendar. Took them only an hour to add hCalendar support to the site.
** The dtend values for events with no time specified (like [http://upcoming.org/event/110145/ | Burning Man] are not exclusive. This causes problems when sending the microformats info to places like Google. They do correct the dtend when exporting to Outlook though. They have been made aware of the problem.
* The [http://laughingsquid.com/squidlist/calendar/ Laughing Squid Calendar] events, [http://laughingsquid.com/squidlist/calendar/9949/2005/5/9 e.g. this party], now supports hCalendar.
* [http://paulschreiber.com/ Paul] Schreiber's [http://concerts.shrub.ca/ Sunnyvale House Concerts] site publishes hCalendar event information for upcoming concerts. In addition the [http://concerts.shrub.ca/shows Past Shows] page contains hCalendar events for all past concerts.
* [http://www.complexspiral.com/ Complex Spiral Consulting], both in the "Events" box on left side, and the separate [http://www.complexspiral.com/events/ Events page].
* [http://tantek.com/log Tantek's Thoughts], specifically the "Events" roll in the right-most column.
* [http://suda.co.uk/projects/holidays/ Lesser Known Holidays], a list of holidays on [http://suda.co.uk suda.co.uk] that can be imported via iCal and hCal so you can compare actual transformation versus intended.
* [http://norman.walsh.name/2005/itinerary/ Norm Walsh's travel schedule] use hCalendar as well as GRDDL.
* [http://www.policyawareweb.org/2005/ftf2/paw-mtg Policy Aware Web (PAW) Project Meeting] uses hCalendar to record date-related decisions, and uses a vtodo microformat to record action items.
* The [http://lufgi4.informatik.rwth-aachen.de Laboratory for Dependable Distributed Systems] publishes it's [http://lufgi4.informatik.rwth-aachen.de/cfps list of notable CfPs on dependability and security] with hCalendar-todo elements.
* The [http://laughingsquid.com/laughing-squid-10th-anniversary-party/ Laughing Squid 10th Anniversary Party] has an hcalendar page.
* SPRACI has hcalendar versions of its nightlife/clubbing/gigs/festivals listings for many cities worldwide - eg: [http://www.spraci.com/listhcalendar.php?parea=sydney&category=all Events in Sydney] (check the [http://www.spraci.com/api/ API] pages in the faq section of [http://www.spraci.com/ SPRACI] for more info about the area/city keywords and category tags to use to get data for your city/categories
* WWF-Australia events calendars: [http://wwf.org.au/act/events/ What's on], [http://wwf.org.au/act/volunteer/ Volunteer]
* [http://rubyholic.com rubyholic] uses hCalendar to publish calendars for ruby groups.
* [http://www.bath.ac.uk/whats-on/ University of Bath What's On] uses hCalendar on individual event pages
* The [http://www.kiez-ev.de/ Kiez] is a small cinema and has published its [http://www.kiez-ev.de/programm program] marked up with hCalendar
* [http://walkwithmetours.net/ Walk With Me Tours ] provides walking tours of Seattle, WA. The selected tours on [http://walkwithmetours.net/take-a-tour.php Take a Tour] are marked up with hCalendar.
====World Cup Kick-off====
* [http://www.worldcupkickoff.com/ World Cup KickOff] where you can download and keep all the fixtures you are interested in so you will never miss a single game of the 2006 football World Cup!
** This link was on the [http://www.lifehacker.com/software/sports/world-cup-start-times-for-ical-etc-175393.php Lifehackers site] and made its way to the yahoo news site:

<blockquote>
Mon May 22, 4:00 PM ET
The World Cup, one of the world's most watched sporting events, is almost upon us. If you've ever tried to follow your favorite team through the Cup you know that it can sometimes be difficult to know when they're on. World Cup Kickoff can help.

World Cup KickOff is all you will ever need for knowing all the match details for the upcoming World Cup 2006. Whether you use your mobile phone, MS Outlook, Apple iCal or Mozilla Calendar, you can download and keep all the fixtures you are interested in so you will never miss a single game!

Next tip? We'll show you how to get up at 2 AM to watch your matches. ;0) Thanks to Tom for the tip!
</blockquote>

=== examples with some problems ===
<span id="Examples_with_some_problems"></span>
If you find a problem with any example in any other section, please move it here, and note the precise problem and cite the section of the [[hcalendar | hCalendar spec]] that appears to be violated. If the example that was moved here is yours, and you want to improve it, see the [[hcalendar-faq| hCalendar FAQ]], or raise any queries on [[hcalendar-issues| hCalendar issues]] or [[mailing-lists#microformats-discuss|the mailing list]], where people will be happy to help you.

* [http://www.tpexpress.co.uk/Liverpool08-Capital-of-Culture/ First TransPennine Express - Liverpool 08, Capital of Culture] - uses hCalendar markup for events.
**'''Suboptimal''', not using exclusive date end. [[User:AndyMabbett|Andy Mabbett]] 12:25, 17 Feb 2008 (PST)
* [http://www.konplan.com konplan.com] - uses hCalendar markup in their event container
** Examples: http://www.konplan.com/public1/_EN/index.php
**'''Suboptimal''', has wrong values in <code>dtend</code>
*** Should be fixed. Can anyone check on it -- I'd like to move it back to examples above. --[[User:AndreasLappe|AndreasLappe]] 07:32, 23 Jan 2008 (PST)
**** Better, but the new end dates are not exclusive (this is a frequently-occurring problem, requiring a rethink of the way the microformat works). [[User:AndyMabbett|Andy Mabbett]] 10:13, 23 Jan 2008 (PST)
***** Should be fixed too. Again, I'd appreciate comments... --[[User:AndreasLappe|AndreasLappe]] 05:22, 25 Jan 2008 (PST)
****** Do those events really run from midnight to midnight? [[User:AndyMabbett|Andy Mabbett]] 05:56, 25 Jan 2008 (PST)
******* They don't. They are all-day events. I was working with [http://lists.osafoundation.org/pipermail/ietf-calsify/2005-September/000769.html] -- wrong? --[[User:AndreasLappe|AndreasLappe]] 06:08, 25 Jan 2008 (PST)
******** That's not usual practice (I'd say it gives a false level of precision), but should perhaps be raised at [[hcalendar-issues]] for clarification. [[User:AndyMabbett|Andy Mabbett]] 02:47, 28 Jan 2008 (PST)
* [http://wiki-translation.com wiki-translation.com] - uses hCalendar markup for events.
**Built-in feature for [http://TikiWiki.org TikiWiki CMS/Groupware] 1.10
**'''Hidden''', data hidden using CSS. [[User:AndyMabbett|Andy Mabbett]] 06:51, 15 Jan 2008 (PST)
***Should be fixed. Can anyone check on it? -- I'd like to move it back to examples above. --[[User:MarcLaporte|MarcLaporte]] 16:58, 4 Mar 2008 (PST)

* [http://konferenciakalauz.hu konferenciakalauz.hu] uses hCalendar for events (in Hungarian).
**'''Suboptimal''', not using exclusive date end. [[User:AndyMabbett|Andy Mabbett]] 13:18, 24 Sep 2007 (PDT)
***Fixed
* [http://www.chronii.com/ chronii.com], a site for creating, searching, and cross-referencing timelines, presents events marked up in hCalendar.
**'''Suboptimal''', '''Hidden''': [http://www.chronii.com/e/line.jsp?ti=1&q=The+Internet] uses <code><nowiki><abbr class="dtstart" title="1991-01-01"></abbr> <abbr class="dtend" title="1992-01-01"></abbr></nowiki></code> for a whole-year date of "1991"
* [http://www.gretchenland.com Gretchen] has their show schedule marked up with hCalendar
** Example here: [http://www.gretchenland.com/shows Upcoming Concert Dates]
**Invalid: <code><nowiki><SPAN title="2007-04-21" class="dtstart">04.21.2007</SPAN></nowiki></code> [[User:AndyMabbett|Andy Mabbett]] 02:08, 20 Apr 2007 (PDT)
* I'd be happy if some future french Pinko-marketing meetings (CantineCamp) could require the use of hCalendar for listing some informal lunches in Paris. [http://www.wikiservice.at/fractal/wikidev.cgi?FR/PinkoMarketing/CantineCampParis10 CantineCampParis10 is an example] to include a hCalendar + hCard markup on the wiki-page. When converting to vCard, "Mendès" accent is malformed in a french outlook 2003 "address book". I've looked UTF-8 example but could not find any way to correct. Any idea ? -- [[User:ChristopheDucamp|xtof]] 01:09, 26 Mar 2007 (PDT)
* [http://www.joomlamug.com Joomla! Melbourne User Group] uses hCalendar markup for listing of all events.
** No examples on cited page. [[User:AndyMabbett|Andy Mabbett]] 15:06, 31 Jan 2007 (PST)
* [http://www.webfeet.org/events.html Webfeet events] includes hCalendar markup in its aggregated events lists.
** <s>Possibly a case where <nowiki><abbr></nowiki> won't work for dtstart/dtend as there are many events listed under a single date. [[User:Webf|Webf]] 15:19, 15 Jan 2007 (PST)</s>
**Malformed e.g <code><nowiki><span class="dtstart" title="20070120"></span></nowiki></code> [[User:AndyMabbett|Andy Mabbett]] 15:41, 15 Jan 2007 (PST)
** Continue the discussion under [[hcalendar-issues|hCalendar Issues]] perhaps. [[User:Webf|Webf]] 22:25, 15 Jan 2007 (PST)
* [http://www.theatrestudies.llc.ed.ac.uk/ Theatre Studies: European Theatre] at the University of Edinburgh uses hCalendar to markup news and events on the index page.
**<s>Uses "display:none" on image. [[User:AndyMabbett|Andy Mabbett]] 15:32, 13 Nov 2006 (PST)</s> Removed img tag from hCard
* [http://www.bokle.de/ s'Bokle] is a German music pub. Their events calendar has been marked up with hCalendar.
** improper use of rrule --[[User:RyanKing|RyanKing]] 16:04, 6 Jan 2006 (PST)
* [http://plan9.tryphon.org/nancy/list Plan9] - Uses hCalendar to mark up events !
** <s>dtstart/dtend are implemented on span element [[User:TomArmitage|Tom Armitage]] June 23, 2006</s> --[[User:Tim|Tim]] 13:34, 4 Mar 2007 (PST) Fixed now
* [http://www.socaltech.com socalTECH] is a news and information site. Their front page event listing is marked up with hCalendar.
** dtstart/dtend implemented on span element [[User:TomArmitage|Tom Armitage]] June 23, 2006
* [http://www.multipack.co.uk The Multipack] features a vevent for the next meeting information.
** dtstart/dtend are implemented on em element [[User:TomArmitage|Tom Armitage]] June 23, 2006
* [http://paulschreiber.com/ Paul] Schreiber's [http://iceoasis.shrub.ca/ unofficial schedule site] publishes hCalendar information for upcoming hockey games at [http://www.iceoasis.com/ Ice Oasis]
** dtstart/dtend are implemented on td element [[User:TomArmitage|Tom Armitage]] June 23, 2006

- whilst Tails parses the "title" attribute for dtstart/dtend on <em>any</em> element (does Tails still do this?), that is incorrect. The title attribute only provides semantics for the <code><nowiki><abbr></nowiki></code> element, while for elements in general like <code><nowiki><span></nowiki></code>, only the contents of the element are used. This is a simplification and see [[hcard-parsing|hCard parsing]] for details. Technorati Microformats Search only looks for the title attribute on <code><nowiki><abbr></nowiki></code> tags per the rules from [[hcard-parsing|hCard parsing]] which apply to [[hcalendar-parsing|hCalendar parsing]] as well.

=== reviewed examples ===
<span id="Reviewed_Examples"></span>
If you have reviewed a New Example (and you are not the author of the example) and believe it to be valid, go ahead and move it here.
* ...

== grouped examples ==
=== listings of upcoming local events ===
* ...
=== archives of local event listings ===
==== Laughing Squid Calendar ====
* The [http://laughingsquid.com/squidlist/calendar/ Laughing Squid Calendar] events listings supported [[hcalendar|hCalendar]]
** [http://laughingsquid.com/squidlist/calendar/month/2003/2 2003 February] thru [http://laughingsquid.com/squidlist/calendar/month/2006/9 2006 September]

=== conference schedules ===
* [http://adactio.com/extras/schedules/barcamplondon3/ BarCamp London 3 Schedule] - uses hCalendar in a semantic <code>table</code> with <code>id</code> and <code>headers</code> attributes. Provides "Subscribe" and "Download" links using the [http://feeds.technorati.com/events/ Technorati Events Feed service].
* [http://adactio.com/extras/schedules/web2expo-berlin/ 2007 Web 2.0 Expo Berlin Schedule] - uses hCalendar in a semantic <code>table</code> with <code>id</code> and <code>headers</code> attributes. Provides "Subscribe" and "Download" links using the [http://feeds.technorati.com/events/ Technorati Events Feed service].

== related pages ==
{{hcalendar-related-pages}}

xfn-brainstorming

2008-08-31T13:48:22Z

James Tindall:

<h1> XFN Brainstorming </h1>
{{TOC-right}}
This page is for brainstorming about various uses and details of [[XFN]], as well as collecting input for potential extensions.

== Required Reading ==
Before participating in any XFN brainstorming please read and understand the following:
* [http://gmpg.org/xfn/intro XFN intro]
* [http://gmpg.org/xfn/background XFN background]
* [[xfn-faq|XFN FAQ]]
* [http://gmpg.org/xfn/and XFN and other services]
* [[rel-faq]]

Note that all existing XFN values were based on research that showed real world sites that indicated such relationships explicitly via text and hyperlinks to other sites. Thus any new semantics or values will be more seriously considered if URLs demonstrating existing text labeling and hyperlinking behavior are provided.

== Contributors ==
* [http://tantek.com/ Tantek Çelik]
* [[User:CiaranMc |CiaranMc ]]
* [http://factoryjoe.com/ Chris Messina]
* [http://kevinmarks.com/ Kevin Marks]

== general ==
* [[xfn-wants]]

== Identity Consolidation ==
See [[rel-me]] and [[identity-consolidation]]. <span id="Frames"> </span>

=== Indicating non-identity ===
I think we need a way to indicate that another page should not be consolidated into your identity. - KevinMarks

==== common name disambiguation ====
If you have a common name, creating a disambiguation page or pages to indicate which ones aren't you is useful for indexers and people alike. In fact there are examples of people already creating such a page and linking to pages that are not them. Real world use cases that would benefit:
* Kevin Kelly (the former Wired editor) has put together a page to indicate [http://kevinkelly.name|other people also called "Kevin Kelly"].
* [http://vadim.com Vadim Akslerod] has created a page of [http://vadim.com/vadim/ Vadims on the Net] that link to other people called Vadim.

==== accidental or malicious rel-me links ====
If someone accidentally or maliciously links to one of my pages with rel="me" it would be good to be able to actually deny the connection, rather than just passively not link back. See [http://socialgraph-resources.googlecode.com/svn/trunk/samples/findyours.html?q=kevinmarks.com | the social graph API results for kevinmarks.com] for examples. - KevinMarks

This appears to be more of a theoretical use case (as compared to the common name disambiguation) because the real world use ''is'' to simply '''not''' link back, and I don't think we should encourage people to add links to things that are not them, nor are they likely to, especially if it is a spammer/stalker/griefer that is linking to them. - [[User:Tantek|Tantek]]

==== notme proposal ====
initial proposal: <code>rel="notme"</code>, though very open to better suggestions.

== Extending family relationships ==

=== grandparent ===
<cite>[http://www.gmpg.org/xfn/background The XFN: Background page]</cite> says:
<blockquote>
We considered adding "grandparent," but in the end dropped the term because it seemed unlikely to be used in the near future. It may appear in future versions of XFN.
</blockquote>

Presumably the assumption is that a grandparent won't have a website, but:

* I think it's important in some situations to capture the age difference in a relationship in a way that @rel="kin" doesn't seem to.
** ''follow-up'': XFN is the wrong place to represent age information (even relative). Instead, mark up each person's page with an hCard for them that has a <code>bday</code> property, with even just the year if you want - that could then be used to determine an approximate age difference, which is presumably all that is desired. Thus rel="kin" can be considered to be sufficient for now.
*** ''rel-kin'' with an age difference of, say, 45 years, might represent any of parent, grandparent, uncle, sibling, cousin or more.

To date, no real world examples have been documented, thus, per the microformats [[process]], we should not complicate a format for a theoretical need. However, anyone that cares to pursue this may find some real world examples to document in the following web searches: [http://www.google.co.uk/search?&q=%22my+grandpa%27s+website%22 "my grandpa's website"], [http://www.google.co.uk/search?&q=%22my+grandfather%27s+website%22 "my grandfather's website"], [http://www.google.co.uk/search?&q=%22my+grandma%27s+website%22 "my grandma's website"], [http://www.google.co.uk/search?&q=%22my+grandmother%27s+website%22 "my grandmother's website"]. See also [[genealogy-examples]].

=== ancestor descendant ===
Even if they don't maintain it themselves (or are deceased) there might be a URL that does a good job of representing a person.

Consider a site about one's family tree. It might have something like:

I can trace my family back to
<a href="http://en.wikipedia.org/wiki/William_I_of_England">
William the conqueror.
</a>

In these cases it would be useful to have @rel="ancestor", and perhaps a corresponding @rel="descendant".
-CiaranMc

See also: [[genealogy-brainstorming#Relationships]]

* follow-up: rel="kin" can be considered to be sufficient for now.

So far only a couple of (representative) real world examples (from just one site) have been provided, thus, per the microformats [[process]], we should not complicate a format for a need clearly outside of the 80/20. Examples from Wikipedia: [http://en.wikipedia.org/wiki/Winston_Churchill#Family_and_early_life Winston Churchill, with list if ancestors], [http://en.wikipedia.org/wiki/Elizabeth_II_of_the_United_Kingdom#Marriage Queen Elizabeth II]: refers to "Queen Victoria as [her] great-great-grandmother". See also [[genealogy-examples]].

== Simple Groups and Members ==
A very simple extension to XFN could enable decentralized group membership. E.g.
* rel="group". A person could link from their page to the page of a group that they belong to (e.g. their company, school, DJ collective etc.) and thus assert that they belong to that group.
* rel="member". The web pages of groups could link to who they consider members and thus assert that person's membership.

The relationships could be required bi-directional in order to confirm group membership, that is, both the individual must link to the group with rel="group" and the group must link to the individiual with rel="member" in order for the membership to be considered "true".

See also [[group-brainstorming]] for more on this including documentation of examples.

== fans and followers ==
It's becoming a common aspect of many social networks (see list below) that you have unreciprocated and non-friend-based connections to people. These connections are particularly noteworthy where you don't really ever expect to have your connections reciprocated, but instead are similar to the idea of "rel-muse".

=== fan follower examples ===
Sites that have the semantic / implied-schema of "fan" or "follower")
* http://crowdvine.com/ (has fans and mutual fans and want to meet)
* http://pownce.com/ (has fans vs friends)
* http://twitter.com/ (has followers vs friends)
* http://upcoming.org/ (has fans vs friends)
* http://www.sugarloot.com (has Fans vs Favorites)

=== possible inverse of fan terms ===
Brainstorm list of possible terms (for an inverse of fan/follower):
* source
** +1 I like this as a neutral term, <s>except that it would be better kept as a rel value for atom:source in [[hAtom]]</s> (on re-reading the Atom spec, atom:source should be a class on a containing element) [[User:Kevin Marks|Kevin Marks]]
* influence
* influencer
** +1 [[User:Tantek|Tantek]] - I like this one the best so far, as it seems to represent the implied semantics the best. If I follow someone, then they are an "influencer" to me.
** -1 Sounds like "influenza", and just because I follow someone, doesn't mean they influence me. [[User:Gazza|Gazza]]
** -1 - influence can be negative as well as positive: "The child only shoplifted because he was under the influence of older boys". [[User:AndyMabbett|Andy Mabbett]] 01:04, 26 Jan 2008 (PST)
** +1 This seems strong; the relationship is not meant to imply an endorsement; we have [[vote-links]] for that [[User:Kevin Marks|Kevin Marks]] 14:30, 24 Mar 2008 (PDT)
** -1 This value is assigned one of 2 ways; arbitrarily by app, or by the user. I don't trust an app to make a decision on what constitutes an ''influencer'' and I don't see a user choosing that in its current wording --[[User:Donohoe|Donohoe]] 19:55, 5 Aug 2008 (PDT)
* leader
* star
* hero
* favorite
* guider
* role-model
* idol
** -1 [[User:Tantek|Tantek]] These all seem too strong and sometimes imply more subordination than most people want.
* subscription
** +1 Tony Stubblebine
** +1 this one seems most neutral to me (a good thing) [[User:STHayden|STHayden]] 08:35, 3 Mar 2008 (PST)
** -1 this makes sense in a feed-reader context, but not necessarily in a blogroll one; it implies the content rather than the person [[User:Kevin Marks|Kevin Marks]] 14:30, 24 Mar 2008 (PDT)
** +1 Was neutral, now in favor --[[User:Donohoe|Donohoe]] 19:11, 6 Aug 2008 (PDT)
** -1 against for same reasons as Kevin Marks. And "subscription" doesn't sound like a term for a person. -- [[User:Tantek|Tantek]]
* of-interest
* interest
* followee
* focus
* <span id="following">following</span> - as the singular of "followings". If someone is one of your "followings", then you are following that someone, as opposed to if someone is one of your "followers", then that someone is following you! It may sound a bit clumsy/awkward as a term at first, but I think that's actually a sign of novel usage, which has some appeal because then it means the term may be available for us to fill it with this meaning - or I should say, amplify this meaning as it [http://search.twitter.com/search?q=followings has been given by existing Twitter users].
** +1 [[User:Tantek|Tantek]] '''following''' is the best term I have seen for the inverse of fan/follower, and paired with '''follower''', provides a good enough complementary pair of relationships to express both directions.
** Note that Google has now [http://buzz.blogger.com/2008/08/show-off-your-followers.html adopted the "follow" terminology]. -- [http://factoryjoe.com/ Chris Messina]
** ...

=== rejected fan follower terms ===
==== rel-fan ====
I would propose adding "rel-fan" or "rel-follower" to the collection of XFN values -- as being something like a "contact" or a "muse" but having a different purpose within the realm of social networking. Again, given that this is showing up in social networks like Pownce (fan), Twitter (follower), and that these words are becoming common, I wonder if it wouldn't make sense to even ditch rel-muse in favor of rel-follower and rel-fan (the former implying some kind of positive social stalking and the latter a kind of amiable appreciation for someone's work).

This fan/follower designation seems sorely lacking from Flickr where not everyone falls into either contact, friend or family... but in many cases, you just like someone's photos and want to be able to check in on them every now and again, similar to the way that people "follow" or "subscribe" to blog feeds... Someone who reads my blog feed could be considered a "follower" -- as in, "someone who follows my blog".

- Chris Messina

Chris, rel-fan or rel-follower would work for you to point to people who follow you, but the converse case is probably more useful, saying who you follow (eg blogroll case too). We need a good noun for that relationship that describes how you view them, that is less coloured than 'muse' currently is by being classified as romantic. rel-source or rel-influence maybe? Very hard to come up with a good noun.

[[User:Kevin Marks|Kevin Marks]] 12:57, 17 Aug 2007 (PDT)

* Hence the existence of the HTML "rev" attribute. [[User:TobyInk|TobyInk]] 00:12, 25 Feb 2008 (PST)
** The [[rel-faq#Should_rev_even_be_used|use of rev has been deprecated]] since authors nearly always get it wrong. [[User:Tantek|Tantek]] 10:32, 6 Aug 2008 (PDT)
*** I'm not suggesting that we create a new microformat using rev — I'm pointing out that if we define <code>rel=fan</code> (for linking to your fans) then <code>rev=fan</code> "automatically pops into meaning". (Besides which the usually quoted evidence of rev being "confusing" to authors (i.e. Google's analysis) is flaky at best.) [[User:TobyInk|TobyInk]] 15:26, 6 Aug 2008 (PDT)
**** Suggesting the use of <code>rev=fan</code> (as you just did) *is* creating a new microformat using rev, so yes, you are suggesting it. And Google's analysis backed up many years of my (and others') personal anecdotal experience with web developers where >90% did not understand the difference between rel and rev. [[User:Tantek|Tantek]] 17:53, 6 Aug 2008 (PDT)
***** My point is that as per the [http://www.w3.org/TR/REC-html40/struct/links.html#adef-rev HTML 4 definition of <code>rev</code>] any time anyone defines a new link type <code>rel=''X''</code>, the meaning of <code>rev=''X''</code> becomes defined too. This is unavoidable. We should define new link types in terms of <code>rel</code> rather than <code>rev</code> for clarity, but we can't prevent people from taking advantage of the facilities inherent in (X)HTML to mark up the inverse meaning. (e.g. [http://changelog.ca/log/2005/09/12/proposed-microformats-for-reputation-and-trust-metrics <code>rev=tag</code> mention], [http://singpolyma.net/2007/05/the-state-of-distributed-social-networking/ and again], [http://styrheim.weblogg.no/311005201154_revtags.html and again]) [[User:TobyInk|TobyInk]] 01:17, 7 Aug 2008 (PDT)

==== rel-reader ====
For blogrolls at least, what about rel-read / rel-reader? -- [[User:SteveIvy|Steve Ivy]]

Steve, "read" is still a verb (and [[rel-values]] need to be nouns), and "reader" would still imply that they are a "reader" of yours, rather than vice versa. -- [[User:Tantek|Tantek]]

==== rel-subscriber ====
What about ''subscriber'' instead - also very neutral and more akin to others in the list? --[[User:Donohoe|Donohoe]] 19:55, 5 Aug 2008 (PDT)

"subscriber" is no different from "reader" in this respect, and means the *opposite* of what we are looking for. I.e. a rel="subscriber" link to someone would mean that someone is a subscriber of my content/feed. -- [[User:Tantek|Tantek]]

== favorites ==
Another possibility is perhaps 'favorite', that is, people do link to favorite bands for example, which is similar to saying they are a fan of the band. Thus you could add <code>rel="favorite"</code> to such hyperlinks to indicate that that music band over there is a favorite of yours. [[User:Tantek|Tantek]] 17:57, 2 Oct 2007 (PDT) based on a question raised by DanBri.

== mentors and mentees ==
Though seemingly rare, I personally have found use for <code>rel="mentor"</code> and inverse <code>rel="mentee"</code> (see Wiktionary definitions: [http://en.wiktionary.org/wiki/mentor mentor], [http://en.wiktionary.org/wiki/mentee mentee]). I don't have sufficient evidence to even consider proposing adding these to XFN, but I wanted to capture them here as a brainstorm while I look into using them personally and research examples in the wild. I may just use them as [[POSH]] myself.

[[User:Tantek|Tantek]] 02:34, 8 Jul 2007 (PDT)

* +1 Erica OGrady

== advisor and advisee ==
Similarly, I have seen folks reference someone as an advisor, or note that they are advising someone. We could consider <code>rel="advisor"</code> and <code>rel="advisee"</code> to capture and represent these semantics.

Note that the relationship of advising a company or organization would be much better captured by noting "advisor" as a "role" property value in an hCard listing that organization, e.g.:
<pre><nowiki>
<span class="vcard">
<span class="fn">Tantek Çelik</span>
<span class="org">Citizen Agency</span>
<span class="role">advisor</span>
</span>
</nowiki></pre>

Again, I think [[POSH]] usage of these terms would make a good experiment to see if there is sufficient use to formalize them.

[[User:Tantek|Tantek]] 07:45, 29 Dec 2007 (PST)

== Influence out and influenced in ==

Needing to provide more options to describe the flow of influence I've been considering the following relationship terms that fall into two predicate groups, influence out(applied) and influence in(received).

Influence out:
* 'follower'
* 'student'
* 'subscriber'
* 'listener'
* 'reader'
* 'viewer'
* 'supporter'
* 'collaborator'

Influence in:
* 'inspiration'
* 'favourite'
* 'teacher'
* 'mentor'
* 'adviser'
* 'influence'
* 'source'
* 'collaborator'

Inline with xfn convention the terms are all nouns and refer to the far side of the link they are used in.

[[User:James Tindall|James Tindall]] 14:23, 31 Aug 2008 (BST)

== scholarly ==
A possibility that might be added is scholarly definitions. For example <code>rel="mentor"</code>[Student's Teacher] (similar to above), <code>rel="student"</code>[Teacher's Student] (inverse of mentor), <code>rel="classmate"</code>[Student's classmate]. Possible uses in Social Networking sites that involve adding your school, grading your teachers, etc. Teacher <-> Teacher would be specified in with <code>rel="co-worker"</code> or <code>rel="colleague"</code>.

[[User:Navarr|Navarr]] 05:56, 13 Dec 2007 (CST)

== professional ==
* [[xpn]] / [[xpn-examples]] - proposal to extend (or replicate) XFN for business (or professional - hence X'''P'''N) relationships

== see also ==
{{xfn-related-pages}}
* [[hcard|hCard]]
* [[hcard-brainstorming|hCard brainstorming]]
* [[social-network-portability]]

xfn-brainstorming

2008-08-31T13:29:44Z

James Tindall: /* Influence out and influenced in */

<h1> XFN Brainstorming </h1>
{{TOC-right}}
This page is for brainstorming about various uses and details of [[XFN]], as well as collecting input for potential extensions.

== Required Reading ==
Before participating in any XFN brainstorming please read and understand the following:
* [http://gmpg.org/xfn/intro XFN intro]
* [http://gmpg.org/xfn/background XFN background]
* [[xfn-faq|XFN FAQ]]
* [http://gmpg.org/xfn/and XFN and other services]
* [[rel-faq]]

Note that all existing XFN values were based on research that showed real world sites that indicated such relationships explicitly via text and hyperlinks to other sites. Thus any new semantics or values will be more seriously considered if URLs demonstrating existing text labeling and hyperlinking behavior are provided.

== Contributors ==
* [http://tantek.com/ Tantek Çelik]
* [[User:CiaranMc |CiaranMc ]]
* [http://factoryjoe.com/ Chris Messina]
* [http://kevinmarks.com/ Kevin Marks]

== general ==
* [[xfn-wants]]

== Identity Consolidation ==
See [[rel-me]] and [[identity-consolidation]]. <span id="Frames"> </span>

=== Indicating non-identity ===
I think we need a way to indicate that another page should not be consolidated into your identity. - KevinMarks

==== common name disambiguation ====
If you have a common name, creating a disambiguation page or pages to indicate which ones aren't you is useful for indexers and people alike. In fact there are examples of people already creating such a page and linking to pages that are not them. Real world use cases that would benefit:
* Kevin Kelly (the former Wired editor) has put together a page to indicate [http://kevinkelly.name|other people also called "Kevin Kelly"].
* [http://vadim.com Vadim Akslerod] has created a page of [http://vadim.com/vadim/ Vadims on the Net] that link to other people called Vadim.

==== accidental or malicious rel-me links ====
If someone accidentally or maliciously links to one of my pages with rel="me" it would be good to be able to actually deny the connection, rather than just passively not link back. See [http://socialgraph-resources.googlecode.com/svn/trunk/samples/findyours.html?q=kevinmarks.com | the social graph API results for kevinmarks.com] for examples. - KevinMarks

This appears to be more of a theoretical use case (as compared to the common name disambiguation) because the real world use ''is'' to simply '''not''' link back, and I don't think we should encourage people to add links to things that are not them, nor are they likely to, especially if it is a spammer/stalker/griefer that is linking to them. - [[User:Tantek|Tantek]]

==== notme proposal ====
initial proposal: <code>rel="notme"</code>, though very open to better suggestions.

== Extending family relationships ==

=== grandparent ===
<cite>[http://www.gmpg.org/xfn/background The XFN: Background page]</cite> says:
<blockquote>
We considered adding "grandparent," but in the end dropped the term because it seemed unlikely to be used in the near future. It may appear in future versions of XFN.
</blockquote>

Presumably the assumption is that a grandparent won't have a website, but:

* I think it's important in some situations to capture the age difference in a relationship in a way that @rel="kin" doesn't seem to.
** ''follow-up'': XFN is the wrong place to represent age information (even relative). Instead, mark up each person's page with an hCard for them that has a <code>bday</code> property, with even just the year if you want - that could then be used to determine an approximate age difference, which is presumably all that is desired. Thus rel="kin" can be considered to be sufficient for now.
*** ''rel-kin'' with an age difference of, say, 45 years, might represent any of parent, grandparent, uncle, sibling, cousin or more.

To date, no real world examples have been documented, thus, per the microformats [[process]], we should not complicate a format for a theoretical need. However, anyone that cares to pursue this may find some real world examples to document in the following web searches: [http://www.google.co.uk/search?&q=%22my+grandpa%27s+website%22 "my grandpa's website"], [http://www.google.co.uk/search?&q=%22my+grandfather%27s+website%22 "my grandfather's website"], [http://www.google.co.uk/search?&q=%22my+grandma%27s+website%22 "my grandma's website"], [http://www.google.co.uk/search?&q=%22my+grandmother%27s+website%22 "my grandmother's website"]. See also [[genealogy-examples]].

=== ancestor descendant ===
Even if they don't maintain it themselves (or are deceased) there might be a URL that does a good job of representing a person.

Consider a site about one's family tree. It might have something like:

I can trace my family back to
<a href="http://en.wikipedia.org/wiki/William_I_of_England">
William the conqueror.
</a>

In these cases it would be useful to have @rel="ancestor", and perhaps a corresponding @rel="descendant".
-CiaranMc

See also: [[genealogy-brainstorming#Relationships]]

* follow-up: rel="kin" can be considered to be sufficient for now.

So far only a couple of (representative) real world examples (from just one site) have been provided, thus, per the microformats [[process]], we should not complicate a format for a need clearly outside of the 80/20. Examples from Wikipedia: [http://en.wikipedia.org/wiki/Winston_Churchill#Family_and_early_life Winston Churchill, with list if ancestors], [http://en.wikipedia.org/wiki/Elizabeth_II_of_the_United_Kingdom#Marriage Queen Elizabeth II]: refers to "Queen Victoria as [her] great-great-grandmother". See also [[genealogy-examples]].

== Simple Groups and Members ==
A very simple extension to XFN could enable decentralized group membership. E.g.
* rel="group". A person could link from their page to the page of a group that they belong to (e.g. their company, school, DJ collective etc.) and thus assert that they belong to that group.
* rel="member". The web pages of groups could link to who they consider members and thus assert that person's membership.

The relationships could be required bi-directional in order to confirm group membership, that is, both the individual must link to the group with rel="group" and the group must link to the individiual with rel="member" in order for the membership to be considered "true".

See also [[group-brainstorming]] for more on this including documentation of examples.

== fans and followers ==
It's becoming a common aspect of many social networks (see list below) that you have unreciprocated and non-friend-based connections to people. These connections are particularly noteworthy where you don't really ever expect to have your connections reciprocated, but instead are similar to the idea of "rel-muse".

=== fan follower examples ===
Sites that have the semantic / implied-schema of "fan" or "follower")
* http://crowdvine.com/ (has fans and mutual fans and want to meet)
* http://pownce.com/ (has fans vs friends)
* http://twitter.com/ (has followers vs friends)
* http://upcoming.org/ (has fans vs friends)
* http://www.sugarloot.com (has Fans vs Favorites)

=== possible inverse of fan terms ===
Brainstorm list of possible terms (for an inverse of fan/follower):
* source
** +1 I like this as a neutral term, <s>except that it would be better kept as a rel value for atom:source in [[hAtom]]</s> (on re-reading the Atom spec, atom:source should be a class on a containing element) [[User:Kevin Marks|Kevin Marks]]
* influence
* influencer
** +1 [[User:Tantek|Tantek]] - I like this one the best so far, as it seems to represent the implied semantics the best. If I follow someone, then they are an "influencer" to me.
** -1 Sounds like "influenza", and just because I follow someone, doesn't mean they influence me. [[User:Gazza|Gazza]]
** -1 - influence can be negative as well as positive: "The child only shoplifted because he was under the influence of older boys". [[User:AndyMabbett|Andy Mabbett]] 01:04, 26 Jan 2008 (PST)
** +1 This seems strong; the relationship is not meant to imply an endorsement; we have [[vote-links]] for that [[User:Kevin Marks|Kevin Marks]] 14:30, 24 Mar 2008 (PDT)
** -1 This value is assigned one of 2 ways; arbitrarily by app, or by the user. I don't trust an app to make a decision on what constitutes an ''influencer'' and I don't see a user choosing that in its current wording --[[User:Donohoe|Donohoe]] 19:55, 5 Aug 2008 (PDT)
* leader
* star
* hero
* favorite
* guider
* role-model
* idol
** -1 [[User:Tantek|Tantek]] These all seem too strong and sometimes imply more subordination than most people want.
* subscription
** +1 Tony Stubblebine
** +1 this one seems most neutral to me (a good thing) [[User:STHayden|STHayden]] 08:35, 3 Mar 2008 (PST)
** -1 this makes sense in a feed-reader context, but not necessarily in a blogroll one; it implies the content rather than the person [[User:Kevin Marks|Kevin Marks]] 14:30, 24 Mar 2008 (PDT)
** +1 Was neutral, now in favor --[[User:Donohoe|Donohoe]] 19:11, 6 Aug 2008 (PDT)
** -1 against for same reasons as Kevin Marks. And "subscription" doesn't sound like a term for a person. -- [[User:Tantek|Tantek]]
* of-interest
* interest
* followee
* focus
* <span id="following">following</span> - as the singular of "followings". If someone is one of your "followings", then you are following that someone, as opposed to if someone is one of your "followers", then that someone is following you! It may sound a bit clumsy/awkward as a term at first, but I think that's actually a sign of novel usage, which has some appeal because then it means the term may be available for us to fill it with this meaning - or I should say, amplify this meaning as it [http://search.twitter.com/search?q=followings has been given by existing Twitter users].
** +1 [[User:Tantek|Tantek]] '''following''' is the best term I have seen for the inverse of fan/follower, and paired with '''follower''', provides a good enough complementary pair of relationships to express both directions.
** Note that Google has now [http://buzz.blogger.com/2008/08/show-off-your-followers.html adopted the "follow" terminology]. -- [http://factoryjoe.com/ Chris Messina]
** ...

=== rejected fan follower terms ===
==== rel-fan ====
I would propose adding "rel-fan" or "rel-follower" to the collection of XFN values -- as being something like a "contact" or a "muse" but having a different purpose within the realm of social networking. Again, given that this is showing up in social networks like Pownce (fan), Twitter (follower), and that these words are becoming common, I wonder if it wouldn't make sense to even ditch rel-muse in favor of rel-follower and rel-fan (the former implying some kind of positive social stalking and the latter a kind of amiable appreciation for someone's work).

This fan/follower designation seems sorely lacking from Flickr where not everyone falls into either contact, friend or family... but in many cases, you just like someone's photos and want to be able to check in on them every now and again, similar to the way that people "follow" or "subscribe" to blog feeds... Someone who reads my blog feed could be considered a "follower" -- as in, "someone who follows my blog".

- Chris Messina

Chris, rel-fan or rel-follower would work for you to point to people who follow you, but the converse case is probably more useful, saying who you follow (eg blogroll case too). We need a good noun for that relationship that describes how you view them, that is less coloured than 'muse' currently is by being classified as romantic. rel-source or rel-influence maybe? Very hard to come up with a good noun.

[[User:Kevin Marks|Kevin Marks]] 12:57, 17 Aug 2007 (PDT)

* Hence the existence of the HTML "rev" attribute. [[User:TobyInk|TobyInk]] 00:12, 25 Feb 2008 (PST)
** The [[rel-faq#Should_rev_even_be_used|use of rev has been deprecated]] since authors nearly always get it wrong. [[User:Tantek|Tantek]] 10:32, 6 Aug 2008 (PDT)
*** I'm not suggesting that we create a new microformat using rev — I'm pointing out that if we define <code>rel=fan</code> (for linking to your fans) then <code>rev=fan</code> "automatically pops into meaning". (Besides which the usually quoted evidence of rev being "confusing" to authors (i.e. Google's analysis) is flaky at best.) [[User:TobyInk|TobyInk]] 15:26, 6 Aug 2008 (PDT)
**** Suggesting the use of <code>rev=fan</code> (as you just did) *is* creating a new microformat using rev, so yes, you are suggesting it. And Google's analysis backed up many years of my (and others') personal anecdotal experience with web developers where >90% did not understand the difference between rel and rev. [[User:Tantek|Tantek]] 17:53, 6 Aug 2008 (PDT)
***** My point is that as per the [http://www.w3.org/TR/REC-html40/struct/links.html#adef-rev HTML 4 definition of <code>rev</code>] any time anyone defines a new link type <code>rel=''X''</code>, the meaning of <code>rev=''X''</code> becomes defined too. This is unavoidable. We should define new link types in terms of <code>rel</code> rather than <code>rev</code> for clarity, but we can't prevent people from taking advantage of the facilities inherent in (X)HTML to mark up the inverse meaning. (e.g. [http://changelog.ca/log/2005/09/12/proposed-microformats-for-reputation-and-trust-metrics <code>rev=tag</code> mention], [http://singpolyma.net/2007/05/the-state-of-distributed-social-networking/ and again], [http://styrheim.weblogg.no/311005201154_revtags.html and again]) [[User:TobyInk|TobyInk]] 01:17, 7 Aug 2008 (PDT)

==== rel-reader ====
For blogrolls at least, what about rel-read / rel-reader? -- [[User:SteveIvy|Steve Ivy]]

Steve, "read" is still a verb (and [[rel-values]] need to be nouns), and "reader" would still imply that they are a "reader" of yours, rather than vice versa. -- [[User:Tantek|Tantek]]

==== rel-subscriber ====
What about ''subscriber'' instead - also very neutral and more akin to others in the list? --[[User:Donohoe|Donohoe]] 19:55, 5 Aug 2008 (PDT)

"subscriber" is no different from "reader" in this respect, and means the *opposite* of what we are looking for. I.e. a rel="subscriber" link to someone would mean that someone is a subscriber of my content/feed. -- [[User:Tantek|Tantek]]

== favorites ==
Another possibility is perhaps 'favorite', that is, people do link to favorite bands for example, which is similar to saying they are a fan of the band. Thus you could add <code>rel="favorite"</code> to such hyperlinks to indicate that that music band over there is a favorite of yours. [[User:Tantek|Tantek]] 17:57, 2 Oct 2007 (PDT) based on a question raised by DanBri.

== mentors and mentees ==
Though seemingly rare, I personally have found use for <code>rel="mentor"</code> and inverse <code>rel="mentee"</code> (see Wiktionary definitions: [http://en.wiktionary.org/wiki/mentor mentor], [http://en.wiktionary.org/wiki/mentee mentee]). I don't have sufficient evidence to even consider proposing adding these to XFN, but I wanted to capture them here as a brainstorm while I look into using them personally and research examples in the wild. I may just use them as [[POSH]] myself.

[[User:Tantek|Tantek]] 02:34, 8 Jul 2007 (PDT)

* +1 Erica OGrady

== advisor and advisee ==
Similarly, I have seen folks reference someone as an advisor, or note that they are advising someone. We could consider <code>rel="advisor"</code> and <code>rel="advisee"</code> to capture and represent these semantics.

Note that the relationship of advising a company or organization would be much better captured by noting "advisor" as a "role" property value in an hCard listing that organization, e.g.:
<pre><nowiki>
<span class="vcard">
<span class="fn">Tantek Çelik</span>
<span class="org">Citizen Agency</span>
<span class="role">advisor</span>
</span>
</nowiki></pre>

Again, I think [[POSH]] usage of these terms would make a good experiment to see if there is sufficient use to formalize them.

[[User:Tantek|Tantek]] 07:45, 29 Dec 2007 (PST)

== Influence out and influenced in ==

Needing to provide more options to describe the flow of influence I've been considering the following relationship terms that fall into two predicate groups, influence out(applied) and influence in(received).

Influence out: 'follower', 'student', 'subscriber', 'listener',
'reader', 'viewer', 'supporter' and 'collaborator'.

Influence in: 'inspiration', 'favourite', 'teacher', 'mentor',
'adviser', 'influence', 'source' and 'collaborator'.

Inline with xfn convention the terms are all nouns and refer to the far side of the link they are used in. So for example, the 'influence in' term 'teacher' would be used on the page of a student on a link to the page of one of their teachers.

[[User:James Tindall|James Tindall]] 14:23, 31 Aug 2008 (BST)

== scholarly ==
A possibility that might be added is scholarly definitions. For example <code>rel="mentor"</code>[Student's Teacher] (similar to above), <code>rel="student"</code>[Teacher's Student] (inverse of mentor), <code>rel="classmate"</code>[Student's classmate]. Possible uses in Social Networking sites that involve adding your school, grading your teachers, etc. Teacher <-> Teacher would be specified in with <code>rel="co-worker"</code> or <code>rel="colleague"</code>.

[[User:Navarr|Navarr]] 05:56, 13 Dec 2007 (CST)

== professional ==
* [[xpn]] / [[xpn-examples]] - proposal to extend (or replicate) XFN for business (or professional - hence X'''P'''N) relationships

== see also ==
{{xfn-related-pages}}
* [[hcard|hCard]]
* [[hcard-brainstorming|hCard brainstorming]]
* [[social-network-portability]]

User:James Tindall

2008-08-31T13:26:50Z

James Tindall:

[http://jamestindall.info http://jamestindall.info]

User:James Tindall

2008-08-31T13:26:30Z

James Tindall:

[http://jamestindall.info]

xfn-brainstorming

2008-08-31T13:25:03Z

James Tindall: Terms for describing Influence

<h1> XFN Brainstorming </h1>
{{TOC-right}}
This page is for brainstorming about various uses and details of [[XFN]], as well as collecting input for potential extensions.

== Required Reading ==
Before participating in any XFN brainstorming please read and understand the following:
* [http://gmpg.org/xfn/intro XFN intro]
* [http://gmpg.org/xfn/background XFN background]
* [[xfn-faq|XFN FAQ]]
* [http://gmpg.org/xfn/and XFN and other services]
* [[rel-faq]]

Note that all existing XFN values were based on research that showed real world sites that indicated such relationships explicitly via text and hyperlinks to other sites. Thus any new semantics or values will be more seriously considered if URLs demonstrating existing text labeling and hyperlinking behavior are provided.

== Contributors ==
* [http://tantek.com/ Tantek Çelik]
* [[User:CiaranMc |CiaranMc ]]
* [http://factoryjoe.com/ Chris Messina]
* [http://kevinmarks.com/ Kevin Marks]

== general ==
* [[xfn-wants]]

== Identity Consolidation ==
See [[rel-me]] and [[identity-consolidation]]. <span id="Frames"> </span>

=== Indicating non-identity ===
I think we need a way to indicate that another page should not be consolidated into your identity. - KevinMarks

==== common name disambiguation ====
If you have a common name, creating a disambiguation page or pages to indicate which ones aren't you is useful for indexers and people alike. In fact there are examples of people already creating such a page and linking to pages that are not them. Real world use cases that would benefit:
* Kevin Kelly (the former Wired editor) has put together a page to indicate [http://kevinkelly.name|other people also called "Kevin Kelly"].
* [http://vadim.com Vadim Akslerod] has created a page of [http://vadim.com/vadim/ Vadims on the Net] that link to other people called Vadim.

==== accidental or malicious rel-me links ====
If someone accidentally or maliciously links to one of my pages with rel="me" it would be good to be able to actually deny the connection, rather than just passively not link back. See [http://socialgraph-resources.googlecode.com/svn/trunk/samples/findyours.html?q=kevinmarks.com | the social graph API results for kevinmarks.com] for examples. - KevinMarks

This appears to be more of a theoretical use case (as compared to the common name disambiguation) because the real world use ''is'' to simply '''not''' link back, and I don't think we should encourage people to add links to things that are not them, nor are they likely to, especially if it is a spammer/stalker/griefer that is linking to them. - [[User:Tantek|Tantek]]

==== notme proposal ====
initial proposal: <code>rel="notme"</code>, though very open to better suggestions.

== Extending family relationships ==

=== grandparent ===
<cite>[http://www.gmpg.org/xfn/background The XFN: Background page]</cite> says:
<blockquote>
We considered adding "grandparent," but in the end dropped the term because it seemed unlikely to be used in the near future. It may appear in future versions of XFN.
</blockquote>

Presumably the assumption is that a grandparent won't have a website, but:

* I think it's important in some situations to capture the age difference in a relationship in a way that @rel="kin" doesn't seem to.
** ''follow-up'': XFN is the wrong place to represent age information (even relative). Instead, mark up each person's page with an hCard for them that has a <code>bday</code> property, with even just the year if you want - that could then be used to determine an approximate age difference, which is presumably all that is desired. Thus rel="kin" can be considered to be sufficient for now.
*** ''rel-kin'' with an age difference of, say, 45 years, might represent any of parent, grandparent, uncle, sibling, cousin or more.

To date, no real world examples have been documented, thus, per the microformats [[process]], we should not complicate a format for a theoretical need. However, anyone that cares to pursue this may find some real world examples to document in the following web searches: [http://www.google.co.uk/search?&q=%22my+grandpa%27s+website%22 "my grandpa's website"], [http://www.google.co.uk/search?&q=%22my+grandfather%27s+website%22 "my grandfather's website"], [http://www.google.co.uk/search?&q=%22my+grandma%27s+website%22 "my grandma's website"], [http://www.google.co.uk/search?&q=%22my+grandmother%27s+website%22 "my grandmother's website"]. See also [[genealogy-examples]].

=== ancestor descendant ===
Even if they don't maintain it themselves (or are deceased) there might be a URL that does a good job of representing a person.

Consider a site about one's family tree. It might have something like:

I can trace my family back to
<a href="http://en.wikipedia.org/wiki/William_I_of_England">
William the conqueror.
</a>

In these cases it would be useful to have @rel="ancestor", and perhaps a corresponding @rel="descendant".
-CiaranMc

See also: [[genealogy-brainstorming#Relationships]]

* follow-up: rel="kin" can be considered to be sufficient for now.

So far only a couple of (representative) real world examples (from just one site) have been provided, thus, per the microformats [[process]], we should not complicate a format for a need clearly outside of the 80/20. Examples from Wikipedia: [http://en.wikipedia.org/wiki/Winston_Churchill#Family_and_early_life Winston Churchill, with list if ancestors], [http://en.wikipedia.org/wiki/Elizabeth_II_of_the_United_Kingdom#Marriage Queen Elizabeth II]: refers to "Queen Victoria as [her] great-great-grandmother". See also [[genealogy-examples]].

== Simple Groups and Members ==
A very simple extension to XFN could enable decentralized group membership. E.g.
* rel="group". A person could link from their page to the page of a group that they belong to (e.g. their company, school, DJ collective etc.) and thus assert that they belong to that group.
* rel="member". The web pages of groups could link to who they consider members and thus assert that person's membership.

The relationships could be required bi-directional in order to confirm group membership, that is, both the individual must link to the group with rel="group" and the group must link to the individiual with rel="member" in order for the membership to be considered "true".

See also [[group-brainstorming]] for more on this including documentation of examples.

== fans and followers ==
It's becoming a common aspect of many social networks (see list below) that you have unreciprocated and non-friend-based connections to people. These connections are particularly noteworthy where you don't really ever expect to have your connections reciprocated, but instead are similar to the idea of "rel-muse".

=== fan follower examples ===
Sites that have the semantic / implied-schema of "fan" or "follower")
* http://crowdvine.com/ (has fans and mutual fans and want to meet)
* http://pownce.com/ (has fans vs friends)
* http://twitter.com/ (has followers vs friends)
* http://upcoming.org/ (has fans vs friends)
* http://www.sugarloot.com (has Fans vs Favorites)

=== possible inverse of fan terms ===
Brainstorm list of possible terms (for an inverse of fan/follower):
* source
** +1 I like this as a neutral term, <s>except that it would be better kept as a rel value for atom:source in [[hAtom]]</s> (on re-reading the Atom spec, atom:source should be a class on a containing element) [[User:Kevin Marks|Kevin Marks]]
* influence
* influencer
** +1 [[User:Tantek|Tantek]] - I like this one the best so far, as it seems to represent the implied semantics the best. If I follow someone, then they are an "influencer" to me.
** -1 Sounds like "influenza", and just because I follow someone, doesn't mean they influence me. [[User:Gazza|Gazza]]
** -1 - influence can be negative as well as positive: "The child only shoplifted because he was under the influence of older boys". [[User:AndyMabbett|Andy Mabbett]] 01:04, 26 Jan 2008 (PST)
** +1 This seems strong; the relationship is not meant to imply an endorsement; we have [[vote-links]] for that [[User:Kevin Marks|Kevin Marks]] 14:30, 24 Mar 2008 (PDT)
** -1 This value is assigned one of 2 ways; arbitrarily by app, or by the user. I don't trust an app to make a decision on what constitutes an ''influencer'' and I don't see a user choosing that in its current wording --[[User:Donohoe|Donohoe]] 19:55, 5 Aug 2008 (PDT)
* leader
* star
* hero
* favorite
* guider
* role-model
* idol
** -1 [[User:Tantek|Tantek]] These all seem too strong and sometimes imply more subordination than most people want.
* subscription
** +1 Tony Stubblebine
** +1 this one seems most neutral to me (a good thing) [[User:STHayden|STHayden]] 08:35, 3 Mar 2008 (PST)
** -1 this makes sense in a feed-reader context, but not necessarily in a blogroll one; it implies the content rather than the person [[User:Kevin Marks|Kevin Marks]] 14:30, 24 Mar 2008 (PDT)
** +1 Was neutral, now in favor --[[User:Donohoe|Donohoe]] 19:11, 6 Aug 2008 (PDT)
** -1 against for same reasons as Kevin Marks. And "subscription" doesn't sound like a term for a person. -- [[User:Tantek|Tantek]]
* of-interest
* interest
* followee
* focus
* <span id="following">following</span> - as the singular of "followings". If someone is one of your "followings", then you are following that someone, as opposed to if someone is one of your "followers", then that someone is following you! It may sound a bit clumsy/awkward as a term at first, but I think that's actually a sign of novel usage, which has some appeal because then it means the term may be available for us to fill it with this meaning - or I should say, amplify this meaning as it [http://search.twitter.com/search?q=followings has been given by existing Twitter users].
** +1 [[User:Tantek|Tantek]] '''following''' is the best term I have seen for the inverse of fan/follower, and paired with '''follower''', provides a good enough complementary pair of relationships to express both directions.
** Note that Google has now [http://buzz.blogger.com/2008/08/show-off-your-followers.html adopted the "follow" terminology]. -- [http://factoryjoe.com/ Chris Messina]
** ...

=== rejected fan follower terms ===
==== rel-fan ====
I would propose adding "rel-fan" or "rel-follower" to the collection of XFN values -- as being something like a "contact" or a "muse" but having a different purpose within the realm of social networking. Again, given that this is showing up in social networks like Pownce (fan), Twitter (follower), and that these words are becoming common, I wonder if it wouldn't make sense to even ditch rel-muse in favor of rel-follower and rel-fan (the former implying some kind of positive social stalking and the latter a kind of amiable appreciation for someone's work).

This fan/follower designation seems sorely lacking from Flickr where not everyone falls into either contact, friend or family... but in many cases, you just like someone's photos and want to be able to check in on them every now and again, similar to the way that people "follow" or "subscribe" to blog feeds... Someone who reads my blog feed could be considered a "follower" -- as in, "someone who follows my blog".

- Chris Messina

Chris, rel-fan or rel-follower would work for you to point to people who follow you, but the converse case is probably more useful, saying who you follow (eg blogroll case too). We need a good noun for that relationship that describes how you view them, that is less coloured than 'muse' currently is by being classified as romantic. rel-source or rel-influence maybe? Very hard to come up with a good noun.

[[User:Kevin Marks|Kevin Marks]] 12:57, 17 Aug 2007 (PDT)

* Hence the existence of the HTML "rev" attribute. [[User:TobyInk|TobyInk]] 00:12, 25 Feb 2008 (PST)
** The [[rel-faq#Should_rev_even_be_used|use of rev has been deprecated]] since authors nearly always get it wrong. [[User:Tantek|Tantek]] 10:32, 6 Aug 2008 (PDT)
*** I'm not suggesting that we create a new microformat using rev — I'm pointing out that if we define <code>rel=fan</code> (for linking to your fans) then <code>rev=fan</code> "automatically pops into meaning". (Besides which the usually quoted evidence of rev being "confusing" to authors (i.e. Google's analysis) is flaky at best.) [[User:TobyInk|TobyInk]] 15:26, 6 Aug 2008 (PDT)
**** Suggesting the use of <code>rev=fan</code> (as you just did) *is* creating a new microformat using rev, so yes, you are suggesting it. And Google's analysis backed up many years of my (and others') personal anecdotal experience with web developers where >90% did not understand the difference between rel and rev. [[User:Tantek|Tantek]] 17:53, 6 Aug 2008 (PDT)
***** My point is that as per the [http://www.w3.org/TR/REC-html40/struct/links.html#adef-rev HTML 4 definition of <code>rev</code>] any time anyone defines a new link type <code>rel=''X''</code>, the meaning of <code>rev=''X''</code> becomes defined too. This is unavoidable. We should define new link types in terms of <code>rel</code> rather than <code>rev</code> for clarity, but we can't prevent people from taking advantage of the facilities inherent in (X)HTML to mark up the inverse meaning. (e.g. [http://changelog.ca/log/2005/09/12/proposed-microformats-for-reputation-and-trust-metrics <code>rev=tag</code> mention], [http://singpolyma.net/2007/05/the-state-of-distributed-social-networking/ and again], [http://styrheim.weblogg.no/311005201154_revtags.html and again]) [[User:TobyInk|TobyInk]] 01:17, 7 Aug 2008 (PDT)

==== rel-reader ====
For blogrolls at least, what about rel-read / rel-reader? -- [[User:SteveIvy|Steve Ivy]]

Steve, "read" is still a verb (and [[rel-values]] need to be nouns), and "reader" would still imply that they are a "reader" of yours, rather than vice versa. -- [[User:Tantek|Tantek]]

==== rel-subscriber ====
What about ''subscriber'' instead - also very neutral and more akin to others in the list? --[[User:Donohoe|Donohoe]] 19:55, 5 Aug 2008 (PDT)

"subscriber" is no different from "reader" in this respect, and means the *opposite* of what we are looking for. I.e. a rel="subscriber" link to someone would mean that someone is a subscriber of my content/feed. -- [[User:Tantek|Tantek]]

== favorites ==
Another possibility is perhaps 'favorite', that is, people do link to favorite bands for example, which is similar to saying they are a fan of the band. Thus you could add <code>rel="favorite"</code> to such hyperlinks to indicate that that music band over there is a favorite of yours. [[User:Tantek|Tantek]] 17:57, 2 Oct 2007 (PDT) based on a question raised by DanBri.

== mentors and mentees ==
Though seemingly rare, I personally have found use for <code>rel="mentor"</code> and inverse <code>rel="mentee"</code> (see Wiktionary definitions: [http://en.wiktionary.org/wiki/mentor mentor], [http://en.wiktionary.org/wiki/mentee mentee]). I don't have sufficient evidence to even consider proposing adding these to XFN, but I wanted to capture them here as a brainstorm while I look into using them personally and research examples in the wild. I may just use them as [[POSH]] myself.

[[User:Tantek|Tantek]] 02:34, 8 Jul 2007 (PDT)

* +1 Erica OGrady

== advisor and advisee ==
Similarly, I have seen folks reference someone as an advisor, or note that they are advising someone. We could consider <code>rel="advisor"</code> and <code>rel="advisee"</code> to capture and represent these semantics.

Note that the relationship of advising a company or organization would be much better captured by noting "advisor" as a "role" property value in an hCard listing that organization, e.g.:
<pre><nowiki>
<span class="vcard">
<span class="fn">Tantek Çelik</span>
<span class="org">Citizen Agency</span>
<span class="role">advisor</span>
</span>
</nowiki></pre>

Again, I think [[POSH]] usage of these terms would make a good experiment to see if there is sufficient use to formalize them.

[[User:Tantek|Tantek]] 07:45, 29 Dec 2007 (PST)

== Influence out and influenced in ==

Needing to provide more options to describe the flow of influence I've been considering the following relationship terms that fall into two predicate groups, influence out(applied) and influence in(received).

Influence out: 'follower', 'student', 'subscriber', 'listener',
'reader', 'viewer', 'supporter' and 'collaborator'.

Influence in: 'inspiration', 'favourite', 'teacher', 'mentor',
'adviser', 'influence', 'source' and 'collaborator'.

Inline with xfn convention the terms are all nouns and refer to the far side of the link they are used in. So for example, the 'influence in' term 'teacher' would be used on the page of a student on a link to the page of one of their teachers.

(All are obviously non symmetric apart from 'collaborator')

[[User:James Tindall|James Tindall]] 14:23, 31 Aug 2008 (BST)

== scholarly ==
A possibility that might be added is scholarly definitions. For example <code>rel="mentor"</code>[Student's Teacher] (similar to above), <code>rel="student"</code>[Teacher's Student] (inverse of mentor), <code>rel="classmate"</code>[Student's classmate]. Possible uses in Social Networking sites that involve adding your school, grading your teachers, etc. Teacher <-> Teacher would be specified in with <code>rel="co-worker"</code> or <code>rel="colleague"</code>.

[[User:Navarr|Navarr]] 05:56, 13 Dec 2007 (CST)

== professional ==
* [[xpn]] / [[xpn-examples]] - proposal to extend (or replicate) XFN for business (or professional - hence X'''P'''N) relationships

== see also ==
{{xfn-related-pages}}
* [[hcard|hCard]]
* [[hcard-brainstorming|hCard brainstorming]]
* [[social-network-portability]]