Microformats Wiki - User contributions [en]

hcalendar-examples-in-wild

2007-04-04T13:21:13Z

FlorianBeer: /* New Examples */

<h1>hCalendar Examples in the wild</h1>

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!

==New Examples==

Please add new examples to the '''top''' of this section.
* [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.
* [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://gross.org.za/calendar GROSSUG Calendar] - Uses hCalendar to mark up meetings and other events.
* [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 [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

===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 ==
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.
* 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 ==
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.
* ...

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

hcalendar-examples-in-wild

2007-04-04T13:20:33Z

FlorianBeer: /* New Examples */

<h1>hCalendar Examples in the wild</h1>

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!

==New Examples==

Please add new examples to the '''top''' of this section.
* [http://last.fm] - uses hCalendar on all concert announcements.
** Example here: [http://www.last.fm/event/75615]
* [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.
* [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://gross.org.za/calendar GROSSUG Calendar] - Uses hCalendar to mark up meetings and other events.
* [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 [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

===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 ==
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.
* 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 ==
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.
* ...

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

existing-classes

2007-04-04T10:49:12Z

FlorianBeer:

= Class Names Across All Microformats =
<table>
<tr>
<th>Term</th>
<th>Parents</th>
<th>Children</th>
<th>Origin</th>
<th>Quick Definition</th>
</tr>
<tr>
<td>adr</td>
<td>vcard</td>
<td> country-name, extended-address, locality, postal-code, post-office-box, street-address,region, type, value </td>
<td>[[hcard|hCard]] </td>
<td>Address of the object. </td>
</tr>
<tr>
<td>affiliation</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Is used along with an hcard of the organization to indicate a relationship or affiliation.</td>
</tr>
<tr>
<td>author</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Author of a weblog/microcontent entry</td>
</tr>
<tr>
<td>bday </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The birth date of the object. </td>
</tr>
<tr>
<td>category </td>
<td>vcard, hreview </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Application category of the object.</td>
</tr>
<tr>
<td>class </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The access classification of the object. For example, public or private. </td>
</tr>
<tr>
<td>contact</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Current contact info of the object. The <code class="element"><address></code> with [[hCard]].</td>
</tr>
<tr>
<td>country-name </td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Name of the country for this particular address. </td>
</tr>
<tr>
<td>description</td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>Full text of the description. (Not to be confused with the much longer "summary")</td>
</tr>
<tr>
<td>dtend </td>
<td>vevent </td>
<td></td>
<td>[[hcalendar|hCalendar]] </td>
<td>Ending date of the object. </td>
</tr>
<tr>
<td>dtreviewed</td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>Date the review was written, NOT necessarily when the review took place. </td>
</tr>
<tr>
<td>dtstart</td>
<td>vevent </td>
<td></td>
<td>[[hcalendar|hCalendar]] </td>
<td>Starting date of the object. (Not to be confused with bday) </td>
</tr>
<tr>
<td>education</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Is applied to an hcalendar event to indicate time spent being educated.</td>
</tr>
<tr>
<td>entry-content</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Content of a weblog/microcontent entry</td>
</tr>
<tr>
<td>entry-summary</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Summary of a weblog/microcontent entry</td>
</tr>
<tr>
<td>entry-title</td>
<td>hatom</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Title of weblog/microcontent entry</td>
</tr>
<tr>
<td>email </td>
<td>vcard, hreview </td>
<td> type, value</td>
<td>[[hcard|hCard]] </td><td>This object's email address. </td>
</tr>
<tr>
<td>experience</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Is applied to an hcalendar event. Job titles/positions should use an hCard.</td>
</tr>
<tr>
<td>extended-address</td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Extended address for this particular address.</td>
</tr>
<tr>
<td>fn</td>
<td>vcard, hreview </td>
<td></td>
<td>[[hcard|hCard]]</td>
<td>The name of the object. </td>
</tr>
<tr>
<td>geo </td>
<td>vcard</td>
<td>latitude, longitude </td>
<td>[[hcard|hCard]] </td>
<td>Geographical coordinates of the object. </td>
</tr>
<tr>
<td>hentry</td>
<td>*webpage, hfeed</td>
<td>entry-title, entry-content, entry-summary, author, updated, published</td>
<td>[[hatom|hAtom]]</td>
<td>A weblog/microcontent entry</td>
</tr>
<tr>
<td>hfeed</td>
<td>*webpage</td>
<td>hentry</td>
<td>[[hatom|hAtom]]</td>
<td>A container for hentrys</td>
</tr>
<tr>
<td>hresume </td>
<td>*webpage</td>
<td>affiliation, contact, education, experience, publications, skill, summary </td>
<td>[[hresume|hResume]]</td>
<td>The resume of some object. </td>
</tr>
<tr>
<td>hreview </td>
<td>*webpage</td>
<td></td>
<td>[[hreview|hReview]]</td>
<td>A review of some object. </td>
</tr>
<tr>
<td>item </td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>The item that the object exists for. For example, a review about Coca-Cola would list "Coca-Cola" as the item. </td>
</tr>
<tr>
<td>key </td>
<td>vcard</td>
<td>type, value </td>
<td>[[hcard|hCard]] </td>
<td>Public key of the object</td>
</tr>
<tr>
<td>label </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Formatting to be used by a delivery address label. </td>
</tr>
<tr>
<td>latitude </td>
<td>geo</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The latitude coordinates of the object. </td>
</tr>
<tr>
<td>locality </td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Locality for this particular address. </td>
</tr>
<tr>
<td>location</td>
<td>vevent </td>
<td></td>
<td>[[hcalendar|hCalendar]] </td>
<td>Intended venue of object. (Not to be confused with adr) </td>
</tr>
<tr>
<td>logo </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Object's logo. </td>
</tr>
<tr>
<td>longitude</td>
<td>geo</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The longitude coordinates of the object. </td>
</tr>
<tr>
<td>mailer </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Email software used by the object. </td>
</tr>
<tr>
<td>n </td>
<td>vcard</td>
<td> additional-name, family-name, given-name, honorific-prefix, honorific-suffix, nickname</td>
<td>[[hcard|hCard]] </td><td>The name of the unit </td>
</tr>
<tr>
<td>note </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Supplemental information about the object. </td>
</tr>
<tr>
<td>org </td>
<td>vcard</td>
<td>organization-name, organization-unit</td>
<td>[[hcard|hCard]] </td><td>The organization or company of the object. </td>
</tr>
<tr>
<td>organization-name </td>
<td>org</td>
<td></td>
<td>[[hcard|hCard]] </td><td>The name of the organization or company of the object. </td>
</tr>
<tr>
<td>organization-unit </td>
<td>org</td>
<td></td>
<td>[[hcard|hCard]] </td><td>The unit or department of the object. </td>
</tr>
<tr>
<td>permalink </td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>A link to the object. This link should never become invalid. Used in <a> </td>
</tr>
<tr>
<td>photo </td>
<td>vcard, hreview </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>A photo of the object. Used in <img> </td>
</tr>
<tr>
<td>post-office-box </td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Post office box number of this particular address. </td>
</tr>
<tr>
<td>postal-code</td>
<td>adr, value</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Postal code for this particular address. </td>
</tr>
<tr>
<td>profile</td>
<td>*webpage</td>
<td></td>
<td>XMDP</td>
<td>Contains metadata types and definitions. Used in <dl> </td>
</tr>
<tr>
<td>publications</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Publications the object has produced. Just use <code class="element"><cite></code>. When there is a [[citation]] microformat, then that can be used in combination with the cite element to further markup the components of the citation.</td>
</tr>
<tr>
<td>published</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Publish date of a weblog/microcontent entry</td>
</tr>
<tr>
<td>rating </td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>Rating of 1-5 or 0-10 of the object. </td>
</tr>
<tr>
<td>region</td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Region of this particular address. </td>
</tr>
<tr>
<td>rev </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]]</td>
<td>Specifies revision of the [[hcard|hCard]]. </td>
</tr>
<tr>
<td>reviewer </td>
<td>hreview</td>
<td>vcard</td>
<td>[[hreview|hReview]] </td>
<td>Person that wrote the review of the object. </td>
</tr>
<tr>
<td>role </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Information regarding the role of the object. </td>
</tr>
<tr>
<td>skill</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Phrases or keywords, using the rel-tag microformat with the class name 'skill', to indicate certain skills or abilities the object posseses.</td>
</tr>
<tr>
<td>sort-string </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td><td>String used to sort this object in an alphabetical list. </td>
</tr>
<tr>
<td>sound </td>
<td>*any</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Audio reading back another element's content. By default, the "fn". </td>
</tr>
<tr>
<td>street-address </td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]]</td>
<td>Street address of this particular address. </td>
</tr>
<tr>
<td>summary </td>
<td>vevent , hreview, hresume </td>
<td></td>
<td>[[hcalendar|hCalendar]] </td>
<td>A short summary or subject for the object. </td>
</tr>
<tr>
<td>tel </td>
<td>vcard</td>
<td> type, value</td>
<td>[[hcard|hCard]] </td>
<td>Telephone number of the object </td>
</tr>
<tr>
<td>title </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Job title or functional position of the object.</td>
</tr>
<tr>
<td>type </td>
<td>adr, email, tel </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Defines a type of the parent element. For instance a type of telephone number such as home or work.. Used in conjunction with "value". </td>
</tr>
<tr>
<td>tz </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The timezone the object is in. </td>
</tr>
<tr>
<td>uid </td>
<td>*any</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Globally unique identifier associated with the object, or one of the object's properties. </td>
</tr>
<tr>
<td>updated</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Last updated date of a weblog/microcontent entry</td>
</tr>
<tr>
<td>url </td>
<td>vcard, vevent , hreview </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>A link to the this object's home page or extended profile. Used in <a> </td>
</tr>
<tr>
<td>value </td>
<td>adr, email, tel </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Used in conjunction with "type". The actual value of a particular type. For instance a telephone number of type work such as +1.415.555.1212. </td>
</tr>
<tr>
<td>vcalendar</td>
<td>*webpage</td>
<td>vevent</td>
<td>[[hcalendar|hCalendar]] </td>
<td>A list of calendar events. </td>
</tr>
<tr>
<td>vcard </td>
<td>*webpage, vevent </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Indicates that this element and all containing elements are part of the [[hcard|hCard]] microformat. </td>
</tr>
<tr>
<td> vevent </td>
<td>*webpage, vcalendar </td>
<td></td>
<td>[[hcalendar|hCalendar]]</td>
<td>Indicates that this element and all contained elements are part of the [[hcalendar|hCalendar]] format. </td>
</tr>
<tr>
<td>version</td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>Version of the format used for the object. </td>
</tr>
<tr>
<td>xoxo </td>
<td>*webpage</td>
<td></td>
<td>[[xoxo|XOXO]]</td>
<td>An outline of data. Used in <ul> and <ol>. </td>
</tr>
</table>

= See Also =

* [[naming-principles|microformats naming principles]] to understand how semantic class names are selected

existing-classes

2007-04-04T10:45:41Z

FlorianBeer: /* Class Names Across All Microformats */

= Class Names Across All Microformats =
<table>
<tr>
<th>Term</th>
<th>Parents</th>
<th>Children</th>
<th>Origin</th>
<th>Quick Definition</th>
</tr>
<tr>
<td>adr</td>
<td>vcard</td>
<td> country-name, extended-address, locality, postal-code, post-office-box, street-address,region, type, value </td>
<td>[[hcard|hCard]] </td>
<td>Address of the object. </td>
</tr>
<tr>
<td>affiliation</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Is used along with an hcard of the organization to indicate a relationship or affiliation.</td>
</tr>
<tr>
<td>author</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Author of a weblog/microcontent entry</td>
</tr>
<tr>
<td>bday </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The birth date of the object. </td>
</tr>
<tr>
<td>category </td>
<td>vcard, hreview </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Application category of the object.</td>
</tr>
<tr>
<td>class </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The access classification of the object. For example, public or private. </td>
</tr>
<tr>
<td>contact</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Current contact info of the object. The <code class="element"><address></code> with [[hCard]].</td>
</tr>
<tr>
<td>country-name </td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Name of the country for this particular address. </td>
</tr>
<tr>
<td>description</td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>Full text of the description. (Not to be confused with the much longer "summary")</td>
</tr>
<tr>
<td>dtend </td>
<td>vevent </td>
<td></td>
<td>[[hcalendar|hCalendar]] </td>
<td>Ending date of the object. </td>
</tr>
<tr>
<td>dtreviewed</td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>Date the review was written, NOT necessarily when the review took place. </td>
</tr>
<tr>
<td>dtstart</td>
<td>vevent </td>
<td></td>
<td>[[hcalendar|hCalendar]] </td>
<td>Starting date of the object. (Not to be confused with bday) </td>
</tr>
<tr>
<td>education</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Is applied to an hcalendar event to indicate time spent being educated.</td>
</tr>
<tr>
<td>entry-content</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Content of a weblog/microcontent entry</td>
</tr>
<tr>
<td>entry-summary</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Summary of a weblog/microcontent entry</td>
</tr>
<tr>
<td>entry-title</td>
<td>hatom</td>
<td></td>
<td>[[hatom|hatom]]</td>
<td>Title of weblog/microcontent entry</td>
</tr>
<tr>
<td>email </td>
<td>vcard, hreview </td>
<td> type, value</td>
<td>[[hcard|hCard]] </td><td>This object's email address. </td>
</tr>
<tr>
<td>experience</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Is applied to an hcalendar event. Job titles/positions should use an hCard.</td>
</tr>
<tr>
<td>extended-address</td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Extended address for this particular address.</td>
</tr>
<tr>
<td>fn</td>
<td>vcard, hreview </td>
<td></td>
<td>[[hcard|hCard]]</td>
<td>The name of the object. </td>
</tr>
<tr>
<td>geo </td>
<td>vcard</td>
<td>latitude, longitude </td>
<td>[[hcard|hCard]] </td>
<td>Geographical coordinates of the object. </td>
</tr>
<tr>
<td>hentry</td>
<td>*webpage, hfeed</td>
<td>entry-title, entry-content, entry-summary, author, updated, published</td>
<td>[[hatom|hAtom]]</td>
<td>A weblog/microcontent entry</td>
</tr>
<tr>
<td>hfeed</td>
<td>*webpage</td>
<td>hentry</td>
<td>[[hatom|hAtom]]</td>
<td>A container for hentrys</td>
</tr>
<tr>
<td>hresume </td>
<td>*webpage</td>
<td>affiliation, contact, education, experience, publications, skill, summary </td>
<td>[[hresume|hResume]]</td>
<td>The resume of some object. </td>
</tr>
<tr>
<td>hreview </td>
<td>*webpage</td>
<td></td>
<td>[[hreview|hReview]]</td>
<td>A review of some object. </td>
</tr>
<tr>
<td>item </td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>The item that the object exists for. For example, a review about Coca-Cola would list "Coca-Cola" as the item. </td>
</tr>
<tr>
<td>key </td>
<td>vcard</td>
<td>type, value </td>
<td>[[hcard|hCard]] </td>
<td>Public key of the object</td>
</tr>
<tr>
<td>label </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Formatting to be used by a delivery address label. </td>
</tr>
<tr>
<td>latitude </td>
<td>geo</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The latitude coordinates of the object. </td>
</tr>
<tr>
<td>locality </td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Locality for this particular address. </td>
</tr>
<tr>
<td>location</td>
<td>vevent </td>
<td></td>
<td>[[hcalendar|hCalendar]] </td>
<td>Intended venue of object. (Not to be confused with adr) </td>
</tr>
<tr>
<td>logo </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Object's logo. </td>
</tr>
<tr>
<td>longitude</td>
<td>geo</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The longitude coordinates of the object. </td>
</tr>
<tr>
<td>mailer </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Email software used by the object. </td>
</tr>
<tr>
<td>n </td>
<td>vcard</td>
<td> additional-name, family-name, given-name, honorific-prefix, honorific-suffix, nickname</td>
<td>[[hcard|hCard]] </td><td>The name of the unit </td>
</tr>
<tr>
<td>note </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Supplemental information about the object. </td>
</tr>
<tr>
<td>org </td>
<td>vcard</td>
<td>organization-name, organization-unit</td>
<td>[[hcard|hCard]] </td><td>The organization or company of the object. </td>
</tr>
<tr>
<td>organization-name </td>
<td>org</td>
<td></td>
<td>[[hcard|hCard]] </td><td>The name of the organization or company of the object. </td>
</tr>
<tr>
<td>organization-unit </td>
<td>org</td>
<td></td>
<td>[[hcard|hCard]] </td><td>The unit or department of the object. </td>
</tr>
<tr>
<td>permalink </td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>A link to the object. This link should never become invalid. Used in <a> </td>
</tr>
<tr>
<td>photo </td>
<td>vcard, hreview </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>A photo of the object. Used in <img> </td>
</tr>
<tr>
<td>post-office-box </td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Post office box number of this particular address. </td>
</tr>
<tr>
<td>postal-code</td>
<td>adr, value</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Postal code for this particular address. </td>
</tr>
<tr>
<td>profile</td>
<td>*webpage</td>
<td></td>
<td>XMDP</td>
<td>Contains metadata types and definitions. Used in <dl> </td>
</tr>
<tr>
<td>publications</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Publications the object has produced. Just use <code class="element"><cite></code>. When there is a [[citation]] microformat, then that can be used in combination with the cite element to further markup the components of the citation.</td>
</tr>
<tr>
<td>published</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Publish date of a weblog/microcontent entry</td>
</tr>
<tr>
<td>rating </td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>Rating of 1-5 or 0-10 of the object. </td>
</tr>
<tr>
<td>region</td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Region of this particular address. </td>
</tr>
<tr>
<td>rev </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]]</td>
<td>Specifies revision of the [[hcard|hCard]]. </td>
</tr>
<tr>
<td>reviewer </td>
<td>hreview</td>
<td>vcard</td>
<td>[[hreview|hReview]] </td>
<td>Person that wrote the review of the object. </td>
</tr>
<tr>
<td>role </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Information regarding the role of the object. </td>
</tr>
<tr>
<td>skill</td>
<td>hresume </td>
<td></td>
<td>[[hresume|hResume]]</td>
<td>Phrases or keywords, using the rel-tag microformat with the class name 'skill', to indicate certain skills or abilities the object posseses.</td>
</tr>
<tr>
<td>sort-string </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td><td>String used to sort this object in an alphabetical list. </td>
</tr>
<tr>
<td>sound </td>
<td>*any</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Audio reading back another element's content. By default, the "fn". </td>
</tr>
<tr>
<td>street-address </td>
<td>adr, value </td>
<td></td>
<td>[[hcard|hCard]]</td>
<td>Street address of this particular address. </td>
</tr>
<tr>
<td>summary </td>
<td>vevent , hreview, hresume </td>
<td></td>
<td>[[hcalendar|hCalendar]] </td>
<td>A short summary or subject for the object. </td>
</tr>
<tr>
<td>tel </td>
<td>vcard</td>
<td> type, value</td>
<td>[[hcard|hCard]] </td>
<td>Telephone number of the object </td>
</tr>
<tr>
<td>title </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Job title or functional position of the object.</td>
</tr>
<tr>
<td>type </td>
<td>adr, email, tel </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Defines a type of the parent element. For instance a type of telephone number such as home or work.. Used in conjunction with "value". </td>
</tr>
<tr>
<td>tz </td>
<td>vcard</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>The timezone the object is in. </td>
</tr>
<tr>
<td>uid </td>
<td>*any</td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Globally unique identifier associated with the object, or one of the object's properties. </td>
</tr>
<tr>
<td>updated</td>
<td>hentry</td>
<td></td>
<td>[[hatom|hAtom]]</td>
<td>Last updated date of a weblog/microcontent entry</td>
</tr>
<tr>
<td>url </td>
<td>vcard, vevent , hreview </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>A link to the this object's home page or extended profile. Used in <a> </td>
</tr>
<tr>
<td>value </td>
<td>adr, email, tel </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Used in conjunction with "type". The actual value of a particular type. For instance a telephone number of type work such as +1.415.555.1212. </td>
</tr>
<tr>
<td>vcalendar</td>
<td>*webpage</td>
<td>vevent</td>
<td>[[hcalendar|hCalendar]] </td>
<td>A list of calendar events. </td>
</tr>
<tr>
<td>vcard </td>
<td>*webpage, vevent </td>
<td></td>
<td>[[hcard|hCard]] </td>
<td>Indicates that this element and all containing elements are part of the [[hcard|hCard]] microformat. </td>
</tr>
<tr>
<td> vevent </td>
<td>*webpage, vcalendar </td>
<td></td>
<td>[[hcalendar|hCalendar]]</td>
<td>Indicates that this element and all contained elements are part of the [[hcalendar|hCalendar]] format. </td>
</tr>
<tr>
<td>version</td>
<td>hreview</td>
<td></td>
<td>[[hreview|hReview]] </td>
<td>Version of the format used for the object. </td>
</tr>
<tr>
<td>xoxo </td>
<td>*webpage</td>
<td></td>
<td>[[xoxo|XOXO]]</td>
<td>An outline of data. Used in <ul> and <ol>. </td>
</tr>
</table>

= See Also =

* [[naming-principles|microformats naming principles]] to understand how semantic class names are selected

hatom

2007-04-03T10:33:21Z

FlorianBeer:

<h1> hAtom 0.1 </h1>

hAtom is a microformat for content that can be syndicated, primarily but not exclusively weblog postings. hAtom is based on a subset of the [http://www.atomenabled.org/ Atom] syndication format. hAtom is one of several [[microformats]] open standards.

__TOC__
== Draft Specification ==

=== Editor/Author ===
* [http://blogmatrix.blogmatrix.com/ David Janes], [http://www.blogmatrix.com BlogMatrix, Inc.]

=== Contributors ===
* [http://members.optusnet.com.au/benjamincarlyle/benjamin/blog/ Benjamin Carlyle]
* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc.]

=== Copyright ===
{{MicroFormatCopyrightStatement2005}}

=== Patents ===
{{MicroFormatPatentStatement}}

== Introduction ==

hAtom is a [[microformat]] for identifying semantic information in weblog posts and practically any other place [http://www.atomenabled.org/ Atom] may be used, such as news articles. hAtom content is easily added to most blogs by simple modifications to the blog's template definitions.

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== Format ==
=== In General ===
The [http://atomenabled.org/developers/syndication/#person Atom Syndication Format] provides the conceptual basis for this microformat, with the following caveats:

* Atom provides a lot more functionality than we need for a "blog post" microformat, so we've taken the minimal number of elements needed.
* the "logical" model of hAtom is that of Atom. If there is a conflict, Atom should be taken as correct.
* the "physical" model of hAtom -- the actual writing of elements -- is a lot more varied than Atom provides for, due to the variety of ways weblogs are actually produced in the wild. The hAtom microformat provides a number of rules for "bridging the gap"

=== Schema ===
Schema elements are based on the Atom nomenclature and follow the microformat pattern of prefixing a unique identifier (in this case, '<code>h</code>') on the outermost container elements -- the Feed or Entry. The parts of this microformat are based on analysis of many weblog, bulletin board and media posts and can be read [[blog-post-brainstorming#Discovered_Elements]].

The hAtom schema consists of the following:

* hfeed ('''<code>hfeed</code>'''). optional.
* hentry ('''<code>hentry</code>''').
** '''<code>entry-title</code>'''. required. text.
** '''<code>entry-content</code>'''. optional (see field description). text.
** '''<code>entry-summary</code>'''. optional. text.
** '''<code>updated</code>'''. required using [[datetime-design-pattern]].
** '''<code>published</code>'''. optional using [[datetime-design-pattern]].
** '''<code>author</code>'''. required using '''[[hcard|hCard]]'''.
** '''<code>bookmark</code>''' (permalink). optional, using '''[[rel-bookmark]]'''.
** tags. optional. keywords or phrases, using '''[[rel-tag]]'''.

Some required elements have defaults if missing, see below.

=== Field and Element Details ===

===== Feed =====
* a Feed element is identified by the class name <code>hfeed</code>
* a Feed element represents the concept of an [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.1.1 Atom feed]
* the Feed element is optional and, if missing, is assumed to be the page
* hAtom documents MAY have multiple Feed elements

===== Feed Category =====
* a Feed Category element is identified by [[rel-tag]]
* a Feed MAY have a Feed Category
* a Feed Category element represents the concept of an [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.2 Atom category] inside a [http://www.atomenabled.org/developers/syndication/#optionalFeedElements feed]
* Feed Category elements MUST appear inside a Feed element but not inside an Entry element
* the [[rel-tag]] <code>href</code> encodes the atom <code>category:term</code>; the link text defines the atom <code>category:label</code>

===== Entry =====
* an Entry element is identified by class name <code>hentry</code>
* an Entry element represents the concept of an [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.1.2 Atom entry]
* any microformat content inside a <code><blockquote></code> or <code><q></code> element within the Entry should not be considered part of the Entry.
: ''This allows quoting other microformated data without worry of corrupting the model''

===== Entry Category =====
* an Entry Category element is identified by [[rel-tag]]
* an Entry MAY have an Entry Category
* an Entry Category element represents the concept of an [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.2 Atom category] inside an [http://www.atomenabled.org/developers/syndication/#optionalEntryElements entry]
* the [[rel-tag]] <code>href</code> encodes the atom <code>category:term</code>; the link text defines the atom <code>category:label</code>

===== Entry Title =====
* an Entry Title element is identified by the class name <code>entry-title</code>
* an Entry SHOULD have an Entry Title
* an Entry Title element represents the concept of an [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.14 Atom entry title]
* if the Entry Title is missing, use
** the first <code><h#></code> element in the Entry, or
** the <code><title></code> of the page, if there is no enclosing Feed element, or
** assume it is the empty string

===== Entry Content =====
* an Entry Content element is identified by class name <code>entry-content</code>
* an Entry SHOULD have Entry Content
* an Entry Content element represents the concept of an [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#atomContent Atom content]
* an Entry MAY have 0 or more Entry Content elements. The "logical Entry Content" of an Entry is the concatenation, in order of appearance, of all the Entry Contents within the Entry
: ''Many weblogs split content into multiple sections with a "Read More" link and javascript tricks. This is also needed in cases where Entry Titles are coded inline and are considered part of the content.''
* if the Entry Content is missing, assume it is the empty string

===== Entry Summary =====
* an Entry Summary element is identified by class name <code>entry-summary</code>
* an Entry Summary element represents the concept of an [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.13 Atom summary]
* an Entry MAY have 0 or more Entry Summary elements. The "logical Entry Summary" of an Entry is the concatenation, in order of appearance, of all the Entry Summarys within the Entry

===== Entry Permalink =====
* an Entry Permalink element is identified by [[rel-bookmark]]
* an Entry SHOULD have an Entry Permalink
* an Entry Permalink element represents the concept of an [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.7 Atom link in an entry]
* if the Entry Permalink is missing, use the URI of the page; if the Entry has an "id" attribute, add that as a fragment to the page URI to distinguish individual entries

===== Entry Updated =====
* an Entry Updated element is identified by class name <code>updated</code>
* an Entry Updated element represents the concept of [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.15 Atom updated]
* an Entry SHOULD have an Entry Updated element
* use the [[datetime-design-pattern]] to encode the updated datetime
* if there is no Entry Updated element,
** use the Entry Published element, if present
** otherwise the page is invalid hAtom

===== Entry Published =====
* an Entry Published element is identified by the class name <code>published</code>
* an Entry Published element represents the concept of [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.9 Atom published]
* use the [[datetime-design-pattern]] to encode the published datetime

===== Entry Author =====
* an Entry Author element is represented by class name <code>author</code>
* an Entry Author element represents the concept of an [http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.4.2.1 Atom author]
* an Entry Author element MUST be encoded in an [[hcard|hCard]]
* an Entry Author element SHOULD be encoded in an <code><address></code> element
* an Entry SHOULD have at least one Entry Author element
* an Entry MAY have more than one Entry Author elements
* if the Entry Author is missing
** find the [[algorithm-nearest-in-parent|Nearest In Parent]] <code><address></code> element(s) with class name <code>author</code> and that is/are a valid [[hcard|hCard]]
** otherwise the entry is invalid hAtom

=== XMDP Profile ===
<pre>
<dl class="profile">
<dt>class</dt>
<dd><p>
<a rel="help" href="http://www.w3.org/TR/html401/struct/global.html#adef-class">
HTML4 definition of the 'class' attribute.</a>
This meta data profile defines some 'class' attribute values (class names)
and their meanings as suggested by a
<a href="http://www.w3.org/TR/WD-htmllink-970328#profile">
draft of "Hypertext Links in HTML"</a>.
<dl>
<dt>hfeed</dt>
<dd>
The concept of atom:feed from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>hentry</dt>
<dd>
The concept of atom:entry from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>entry-title</dt>
<dd>
The concept of atom:title inside of an atom:entry from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>entry-content</dt>
<dd>
The concept of atom:content from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>entry-summary</dt>
<dd>
The concept of atom:summary from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>bookmark</dt>
<dd>
The concept of atom:link (without any "rel") with an atom:entry from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>published</dt>
<dd>
The concept of atom:published from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>updated</dt>
<dd>
The concept of atom:updated from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
<dt>author</dt>
<dd>
The concept of atom:author from
<a href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php">The Atom Syndication Format</a>,
constrained and modified as per the <a href="http://microformats.org/wiki/hatom">hAtom microformat spec</a>.
</dd>
</dl>
</dd>
</dl>
</pre>

== Examples ==

See [[hatom-examples]].

== Examples in the wild ==
This section is '''informative'''.

The following sites have implemented hAtom , and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc. If your site marked up with hAtom, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

=== 0.1 hAtom examples===
* [http://blog.no-panic.at Florian Beer] uses hAtom to mark up all the blog posts. There is also a [http://blog.no-panic.at/2006/11/16/hatom-and-wordpress/ tutorial] on how to convert Wordpress themes to include hAtom.
* [http://ficlets.com/ Ficlets] uses hAtom on the [http://ficlets.com/stories main stories page] and on [http://ficlets.com/stories/12 individual story pages].
* [http://www.international.unt.edu UNT International] uses hAtom combined with hCard on news/announcement pages (e.g., [http://www.international.unt.edu/quick/news the main news page]) in addition to providing traditional Atom feeds
* [http://www.absalom.net.au Absalom Media] uses hAtom combined with hCard for articles.
* [http://www.joomlamug.com Joomla! Melbourne User Group] uses hAtom combined with hCard for articles.
* [http://www.volume.co.uk Volume] - Main news page is marked up as hAtom 0.1
* [http://yedda.com Yedda] - Yedda support hAtom on exploration of questions where there is also support for Atom and RSS feeds. ([http://yedda.com/questions/recent/ example])
* The [http://www.westmidlandbirdclub.com/ West Midland Bird Club's] frequently-updated [http://www.westmidlandbirdclub.com/new.htm What's New] page, [http://www.westmidlandbirdclub.com/ladywalk/latest.htm news from its Ladywalk Reserve] and [http://www.westmidlandbirdclub.com/worcs/grimley/latest.htm news from Grimley Pits] — comments welcome on my talk page [[User:AndyMabbett|Andy Mabbett]]
* [http://pixelsebi.com pixelsebi's repository] uses hAtom 0.1 for blog posts (and hCard, hCalendar, XFN, xFolk and many more) based on manual WordPress template modifications
* [http://www.geekinthepark.co.uk Geek in the Park] uses hAtom for the comments. -- by [[User:Trovster|trovster]]
* [http://www.csarven.ca Sarven Capadisli] uses hAtom for the articles and comments -- by [[User:Csarven|csarven]]
* [http://www.fberriman.com fberriman.com] uses hAtom 0.1 for blog posts (WordPress loop) and hCard throughout -- by [[User:Phae|Frances Berriman]] (Also - [http://www.fberriman.com/?p=86 Implementing hAtom: The Entries Code])
* [http://www.capital.edu Capital University] uses hAtom 0.1 to mark up the feed of latest posts by student bloggers on its home page.
* [http://blog.davidjanes.com Ranting and Roaring] (David Janes)
* [http://ChunkySoup.net/ ChunkySoup.net] has redesigned using hAtom 0.1 and hCards on the entire site -- by [[User:ChrisCasciano|Chris Casciano]]
* [http://sedna.spip.org/sedna/ Sedna RSS] (a feed aggregator based on SPIP, by Fil, IZO and others; GPLd sources are available at [http://zone.spip.org/trac/spip-zone/browser/_squelettes_/sedna SPIP-Zone])
* [http://members.optusnet.com.au/benjamincarlyle/benjamin/blog/ Sound Advice] (Benjamin Carlyle)
* [http://quotedprintable.com/pages/scribbish Scribbish] is a Typo theme which uses hAtom.
* [http://rbach.priv.at/hAtom2Atom/Changelog/ hAtom2Atom.xsl's Changelog] is published as hAtom and Atom.
* [http://federali.st/ federali.st]'s webbed Federalist Papers are each marked up in hAtom.
* [http://www.plaintxt.org/themes/sandbox/ Sandbox] is a theme for [http://wordpress.org/ WordPress] that uses hAtom.
** The theme is also available to accounts on the [http://wordpress.com/ <username>.wordpress.com] hosting service. The [http://blog.coworking.info Coworking] and [http://barcamp.wordpress.com BarCamp] blogs are examples of custom Sandbox themes.
* [http://www.whump.com/dropbox/Strangelove.zip Strangelove] is a modification of the default WordPress theme (Kubrick) with hAtom support.
** It points to the hAtom2Atom proxy service as the link for syndication feeds.
* All [http://www.plaintxt.org/themes/ plaintxt.org themes] for [http://wordpress.org/ WordPress] now use hAtom. The themes are also coded for hCard compliance. The themes, by name, are:
** [http://www.plaintxt.org/themes/barthelme/ Barthelme] (two-column, fluid), [http://www.plaintxt.org/themes/blogtxt/ blog.txt] (two- or three-column, elastic), [http://www.plaintxt.org/themes/plaintxtblog/ plaintxtBlog] (three-column, fluid), [http://www.plaintxt.org/themes/simplr/ Simplr] (one column, elastic), [http://www.plaintxt.org/themes/veryplaintxt/ veryplaintxt] (two column, fluid)
* [http://archgfx.net/blog/index.php/themes/disconnected/ Disconnected], a theme for WordPress, also incorporated hAtom with version 1.2

===Examples with some problems===

Entries may be moved here if there's a problem with the way hAtom is used on the page concerned. If the page is yours, and you want to improve it, see the [[hatom-faq|hAtom FAQ]], or raise any queries on [[hatom-issues|hAtom Issues]] or [[mailing-lists#microformats-discuss|the mailing list]], where people will be happy to help you.

==== Pre 0.1 hAtom examples====
These pages conform to an older draft standard and need to be updated.

* [http://www.myelin.co.nz/post/ Second p0st] (Phil Pearson)

== Implementations ==

This section is '''informative'''.

The following implementations have been developed which either generate or parse hAtom links. If you have an hAtom implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

* [http://dichotomize.com/uf/hatom/creator.html hAtom Creator] modified from the other creators by BenWest.
* the [http://tools.blogmatrix.com/extract/ Almost Universal Microformat Parser] can extract hAtom content from webpages ([http://tools.blogmatrix.com/extract/?uri=http%3A%2F%2Fblog.davidjanes.com&microformat=hatom&submit=Submit example])
* the [http://www.trinityanne.com/tools/greasemonkey/microformat-action.user.js microformat-action] [[greasemonkey|Greasemonkey]] script detects hAtom content on webpages and will call the [http://tools.blogmatrix.com/extract/ Almost Universal Microformat Parser]
* [http://rbach.priv.at/hAtom2Atom/ hAtom2Atom.xsl] transforms hAtom to Atom (as the name suggests.)
* There is now an [http://www.lukearno.com/projects/hatom2atom/ hatom2atom proxy] that uses hAtom2Atom.xsl.
* [http://placenamehere.com/article/185/SubscribingTohAtomFeedsWithNetNewsWire Subscribe To hAtom] is a script that provides [http://ranchero.com/netnewswire/ NetNewsWire 2.x] users with the ability to subscribe to hAtom documents as they would any other feed. by [[User:ChrisCasciano|Chris Casciano]].
* [http://boxtheweb.mihopa.net/code/apis/#outlineclasses Outline Classes] - has GPL'ed PHP code for reading hAtom
* [http://boxtheweb.4x2.net/ BoxtheWeb] - supports subscribing to hAtom as a feed format

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc4287 RFC4287: The Atom Syndication Format]
* [[hcard-parsing]]

=== Informative References ===
* [http://www.atomenabled.org/ atomenabled.org]

== Work in progress ==
This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. There is a separate document where we are keeping our brainstorms and other explorations relating to hAtom:

* [[blog-post-brainstorming|blog-post Brainstorming]]

=== Version 0.1 ===

Version 0.1 was released 28 February 2006.

== Discussions ==

* See [http://www.technorati.com/cosmos/referer.html blogs discussing this page].

=== Q&A ===
* If you have any questions about hAtom, check the [[hatom-faq|hAtom FAQ]], and if you don't find answers, add your questions!

=== Issues ===
* Please add any issues with the specification to the separate [[hatom-issues|hAtom issues]] document.

==See Also==
{{hatom-related-pages}}
* [[rel-enclosure]] - how to semantically reference enclosures (e.g. podcasts) in hAtom
* [[blog-post-brainstorming]]
* [[blog-post-formats]]
* [[blog-post-examples]]
* [[blog-description-format]] - how to describe a blog (as opposed to the individual entries, which is what we're doing here)