hcalendar-authoring

[lusiana] [ew60 ii] [prestito melzo] [cuando volveras dance radio remix] [rowlandson mary white] [unibal] [hard disk extreme 250 gb] [s3 trio 3d 2x driver xp] [behringer control] [philips tv color] [eos 300 d canon] [tesauro francesco] [maroon5 lyrics tis love] [dvdrw 4 7] [shavit] [adobe encore] [store fixture parts] [ati radeon 7000] [japan girl] [www libero t] [fine settimana inglese] [dragostea din tei remix] [camere e corridoi] [giuseppe verde] [betws y coed] [lora del delitto] [chupa toda] [just walk away] [chicas calatas] [brother 9660] [franci] [dormire una notte a olbia] [radomsko] [funzioni] [lettori di smart card 7 1] [foresta nera] [totally spies com] [dual processor] [linguistic] [negozi da giardino] [contact lens] [test di preselezione per aereo] [sogno listz] [nikon 1870 af dx] [xp professional upgrade] [il colore del melograno] [kaity] [pronostico basket] [ktag5400 1g] [hard disk esterno lettore foto] [oroscopo pippo baudo] [rbay] [samsung lavatrici 1200 giri] [jbuilderx] [speed] [il gazzettino di padova] [confession usher] [riassunto il sentiero dei] [vacanza baleari] [fossil italia s r l] [incontro capri] [baldoni video] [day after tomorrow] [creature] [claudia kool] [centro benessere liguria] [iodio] [xizo] [chochas] [euro dance 11] [para vivir] [ravizza] [finanziamento san dona piave] [ufficio alba] [ceramiche minghetti] [carrozzine peg perego] [lavoro a busto arsizio] [carreta de coches] [gilles deleuze nietzsche e la filosofia] [tanz bambolina rmx] [www roadstar] [la pittura italiana del 700] [deleted] [toner brother hl1270] [jilted john] [dvd pioneer 16x] [camera forli] [matsubara] [la smorfia] [vicky covergirl] [kaiak] [sarah kane libri] [oki toner rainbow] [argo 245c] [hate that frog] [i ragazzi di scampia] [nike donna] [download programmi per bioritmo] [annunci trans napoli] [una demo per war world] [www principe alba adriatica com] [terra libera gabry ponte] [antonello de pierro erotismo] [provincia brescia] [claudio baglioni fotografie] [badesi sardegna] [hassirmel] [ag1] [bicicletta atala] [xsl] [gig d agostino silence] [radeon x800 se agp] [olympus xd card 512mb] [www negreit] [nikon obiettivi sigma] [rooms neo geo] [le campanelle] [pala cavicchi] [la fessura] [foto paris hilton] [arenaria (botanica)] [nino ippolito] [un uomo venuto da molto lontano] [midi vari] [la leggenda] [i senza paura] [musicology prince] [una petizione per halo sulla rete] [www fassina it] [sims 2 playstation 2] [amd athlon 64 3800] [kevin bigley] [deskjet 450cbi] [cebus] [sintoamplificatore home theatre] [pentium 4] [foto sesso gratis bizzarre] [hellbound eminem] [ktapbg4 512] [harry potter 53] [rosita celentano] [accessori per palm] [vanoni paolo ti ricordi] [simon paul] [percorsi autostradali europa] [sex termometer] [telecamera dvd] [happy funny] [fuchunjiang] [saggio breve esempio] [ollastra] [proxify] [freno] [diomedes] [perle di ghiaccio] [incontrare ragazze] [inizia il beta test pubblico di world of warcraft] [tagliaerba motore] [tour dei cantanti] [scheda memoria secure digital] [golf gt special] [schiller mit heppner] [mercedes 190 d] [maglieria davoli] [ati sapphire radeon x800 256mb pcie] [balli di gruppo 2004] [la preparazione fisica al ciclismo] [how came dei d12] [fax globo] [dj tommy stay] [aziente tessili lecco] [code arabesque] [olympus 300] [olimpus c480 zoom] [vgn sony portatili] [www cartoons] [samanta degre] [samsung sp2014n] [mp3 gigione] [nikon enel2] [digital receiver] [bach aria iv corda] [passo rapido] [ozoe] [macchine usate in sicilia] [fasciatoio rimini] [crack toca racer driver 2 no cd] [guernica e la gurra] [verbatim dvd r 8 5 gb] [nora roberts] [pc con monitor lcd 17] [costi oh mami] [tv sony lcd 32] [twenty centuri fox soundtrack] [wait until] [sexygirl] [renault twingo helios] [benny benasi satisfaction] [televisore 10 pollici radio] [www filosofia com]

hCalendar authoring

This page contains useful tips and guidelines for how to author hCalendar events, either from scratch, or by adding markup to existing content.

Goal: The goal of this document is to provide some good intuitive guidelines that should make it as easy and as quick as possible for any web author to create hCalendar events or add hCalendar markup to existing content.

Audience: Web authors and designers. This document is written for easy consumption and understanding by any web designer who knows at least enough (X)HTML and CSS to use HTML class names on elements and write CSS selectors that apply styles to those class names. Please help with clarifying/simplifying this document accordingly.

Author(s): Tantek Çelik

Creating new hCalendar events

Start with the hCalendar creator, and for additional fields and properties (e.g. contact, attendees, etc.), see the hCalendar examples page as well as the rest of this page.

Adding hCalendar markup to existing content

Minimal Markup Changes

The important thing to keep in mind when adding microformats to existing content, is the fact that microformats are designed so that they can be added with minimal (almost always no) changes to the existing presentation of the page. Thus keep this in mind: change as little markup as possible. If you want to fix various pages to be valid XHTML as well, that's fine goal and highly encouraged.

Find Events

Start with looking for all mentions of events on a page, such as an "Upcoming Events" or "Recent Events" listing. Those are all potential hCalendar events. Even more so if they are linked to their respective URLs (e.g. per event pages with more details).

If an event is mentioned several times on a page, consider marking up the mention which is the most persistent, detailed, definitive, or otherwise thorough as an hCalendar event. Ideally you might want to mark up all instances of a events with hCalendar, but for now, just keep it simple and markup the most representative instance. (Perhaps the most "definitive" instance, which could also then be marked up with a <dfn> element around the summary/title of the event for additional semantic XHTML goodness.)

Determine The Surrounding Element for Each

For each event that you want to add hCalendar, find the smallest element that contains all the info about that event, without overlapping with any other event on the page.

Add the class name "vevent" to that element.

If there is no such element (perhaps the nearest enclosing element contains more than one event), then add a <span class="vevent">...</span> or <div class="vevent">...</div> that wraps the info about about that event and just that event.

The rest of the markup for this hCalendar event MUST go inside that element with the class name "vevent".

In all cases, where it says to add an element with class name of "xyz", if you can find an existing element that precisely surrounds the necessary content, then re-use that element and simply add the class name "xyz" to it (by adding it to the class attribute on the existing element, or by adding a new class attribute class="xyz" to elements without a class attribute).

For instance, assuming you have the following markup:

    <div class="someFoo">
       <p> This is my wonderful markup, it contains some event information inside of it</p>
       <h6>Some Wonderful Event</h6>
       <p> From the people who brought you Great Times and Fun Lovin, 
           comes the Some Wonderful Event at the Local Sports Stadium.  
           Come at <b>A Specified Time</b>, and enjoy yourself! </p>
    </div>

If you need to add an element with the class of "vevent" around your event content, you could re-use the existing div element, and add the class "vevent" to it like so:

    <div class="someFoo vevent">

Similarly, if you decide not to re-purpose an existing container, you can just wrap the content around a new block:

    <div class="someFoo">
      <div class="vevent">
         <p> This is my wond...
         ...
         ... and enjoy yourself! </p>
      </div>
    </div>

The Importance of Time and Topic

Several properties are required in hCalendar. At a minimum, an event needs a "summary" (AKA title) and "dtstart" (starting date time), as well as either a "dtend" (ending date time) or "duration". Thus be sure to mark up the name/summary/title of the event with the class name "summary". E.g.

<div class="vevent">
 <span class="summary">An Event Apart, New York City, NY</span>,
 <abbr class="dtstart" title="20060710">July 10</abbr>-<abbr class="dtend" title="20060712">11th, 2006</abbr>
</div>

This event might be presented like:

An Event Apart, New York City, NY, July 10-11th, 2006

Note: the use of the abbr element's title attribute to markup a machine readable absolute datetime in addition to the human readable text. Note also that the machine readable ending date is the day *after* the date specified in the human readable content. The reason for this is that hCalendar still interprets an ending date without a time as an instant in time, that is midnight, the absolute beginning of that day, thus ending the event the day before. See hCalendar and hcalendar-example1-steps for more details on the use of the abbr element in this fashion.

Eliminating Default Dotted Underline

Some browsers (Camino, Firefox, Mozilla) put a dotted underline or border on each abbr. This is typically an ugly effect and distracting in most clean modern web designs. Thus be sure to use the following rule in your style sheet to eliminate this default presentation.

abbr{border:0}

In the above example, this would have the following effect (which may not look any different for some readers):

An Event Apart, New York City, NY, July 10-11th, 2006

Representative URLs

One of the most common patterns for events in web content is to link them to their definitive/preferred web site.

"Event Rolls" are a good example of this (see also XOXO for proper semantic list and outline markup).

Since the class attribute takes a space separated set of class names, one can often markup the URL on the same element as the name, e.g. by replacing the first <span> in the above example with an <a href> hyperlink:

<div class="vevent">
 <a href="http://aneventapart.com/events/2006/nyc/" class="summary url">An Event Apart, New York City, NY</a>,
 <abbr class="dtstart" title="20060710">July 10</abbr>-<abbr class="dtend" title="20060712">11th, 2006</abbr>
</div>

This event might be presented like:

An Event Apart, New York City, NY, July 10-11th, 2006

Location Location Location

As with real estate, the location of an event is quite relevant, and important to markup properly. At a minimum, identify the location related information in the event and mark it up with the class name of "location", e.g. continuing with the above example:

<div class="vevent">
 <a href="http://aneventapart.com/events/2006/nyc/" class="summary url">An Event Apart, 
  <span class="location">New York City, NY</span></a>, 
 <abbr class="dtstart" title="20060710">July 10</abbr>-<abbr class="dtend" title="20060712">11th, 2006</abbr>
</div>

This is good, but can be made even better with the addition of the adr microformat to explicitly identify the city and state:

<div class="vevent">
 <a href="http://aneventapart.com/events/2006/nyc/" class="summary url">An Event Apart, 
  <span class="location adr"><span class="locality">New York City</span>, <span class="region">NY</span></span></a>, 
 <abbr class="dtstart" title="20060710">July 10</abbr>-<abbr class="dtend" title="20060712">11th, 2006</abbr>
</div>

Even better, if the location has a name, such as a business or organization, make the location into complete hCard rather than just an adr:

<div class="vevent">
 <a href="http://aneventapart.com/events/2006/nyc/" class="summary url">An Event Apart, 
  <span class="location vcard">
   <span class="fn org">Scandinavia House</span>,
   <span class="adr"><span class="locality">New York City</span>, <span class="region">NY</span></span>
  </span></a>,
 <abbr class="dtstart" title="20060710">July 10</abbr>-<abbr class="dtend" title="20060712">11th, 2006</abbr>
</div>

More tips and guidelines

Feel free to add more tips that experience has taught you while marking up events with hCalendar, even if all you add is a brief catch phrase that reminds you.

• How to mark up the contact and organizer
• How to mark up attendees (including speakers)
• ...

Related Pages

• hCalendar - specification
• hCalendar intro - plain English introduction
• hCalendar authoring - learn how to add hCalendar markup to your existing events.
• hCalendar creator (hCalendar creator feedback) - create your own hCalendar events.
• hCalendar cheatsheet - hCalendar properties
• hCalendar examples in the wild - an on-going list of websites which use hCalendars.
• hCalendar implementations - websites or tools which either generate or parse hCalendars
• hCalendar FAQ - If you have any questions about hCalendar, check here.
• hCalendar parsing - normative details of how to parse hCalendar.
• hCalendar profile - the XMDP profile for hCalendar
• hCalendar singular properties - an explanation of the list of singular properties in hCalendar.
• hCalendar tests - a wiki page with actual embedded hCalendar events to try parsing.
• hCalendar "to do" - jobs to do
• hCalendar advocacy - encourage others to use hCalendar.
• iCalendar implementations

This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. These thoughts, issues, and questions are kept in separate pages.

• hCalendar Brainstorming - brainstorms and other explorations relating to hCalendar
• hCalendar issues - issues with the specification