HCalendar

hCalendar (lyhenne sanoille HTML iCalendar) on mikroformaattistandardi semanttiselle (X)HTML-muotoiselle esitykselle iCalendar-muotoisesta tapahtumien kalenteritiedosta WWW-sivuilla.

Se mahdollistaa jäsennystykaluille (esimerkiksi Firefoxin Operator-laajennos) poimia yksityiskohtaisia tietoja tapahtumista ja näyttää niitä joillain www-sivuilla, indeksoida niitä ja etsiä niitä tai ladata niitä omalle koneelle kalenteriohjelmalle tai päiväkirjaan, esimerkiksi. Moniosaiset hCalendar-tiedot voidaan näyttää aikajanana.

Esimerkki

Tarkastellaan tätä fiktiivistä esimerkkiä:

   Englanninkielinen Wikipedia julkistettiin
   15. tammikuuta vuonna 2001 juhlilla
   klo 14-16
   Jimmy Walesin talossa
   (lisää tietoa).

HTML-esitys tälle olisi:

<p>
    Englanninkielinen Wikipedia julkistettiin
    15. tammikuuta vuonna 2001 juhlilla
    klo 14-16
    Jimmy Walesin talossa
    (<a href="http://en.wikipedia.org/wiki/History_of_Wikipedia">lisätietoja</a>)
</p>

Voimme lisätä hCalendariin merkkauskielen käyttämällä span HTML elementtejä ja luokkia vevent, summary, dtstart (aloituspäivä), dtend (päättymispäivä), location ja url:

<p class="vevent">
    <span class="summary">Englanninkielinen Wikipedia julkistettiin</span> 
    15. tammikuuta 2001 juhlilla 
    <abbr class="dtstart" title="2001-01-15T14:00:00+06:00">2</abbr>-
    <abbr class="dtend" title="2001-01-15T16:00:00+06:00">4</abbr>pm at 
    <span class="location">Jimmy Walesin talossa</span> 
    (<a class="url" href="http://en.wikipedia.org/wiki/History_of_Wikipedia">lisätietoja</a>)
</p>

Huomaa, että abbr-elementti mahdollistaa koneellisesti luettavan ISO8601-standardin date-time -muodolle aloitus- ja päättymispäivälle.

Poissulkevat päättymispäivät

Koko päivän kestävien tapahtumien lopetuspäivän tulee olla eksklusiivisia (t.s. seuraava päivä tapahtumapäivän jälkeen). Esimerkiksi:

 <abbr class="dtend" title="2001-02-01">31. tammikuuta 2001</abbr>

Geo

Geo mikroformaatti on osa hCalendar-määrittelyä ja sitä käytetään usein koordinaattien sisällyttämiseen tapahtumille hCalendar-muodossa.

Attribuutit

Täydellisen luettelon attribuuteista löydät osoitteesta hCalendar cheat-sheet.

Katso myös

• iCalendar

Lisätietoja

• Microformats.org hcalendar