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 muokkaa
Kuvitteellinen esimerkkitapaus:
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 ISO 8601-standardin date-time -muodolle aloitus- ja päättymispäivälle.
Poissulkevat päättymispäivät muokkaa
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 muokkaa
Geo mikroformaatti on osa hCalendar-määrittelyä ja sitä käytetään usein koordinaattien sisällyttämiseen tapahtumille hCalendar-muodossa.
Attribuutit muokkaa
Täydellisen luettelon attribuuteista löydät osoitteesta hCalendar cheat-sheet.