Formats

Calagator can import calendars or events (including their venues) from web pages that include microformats for the calendar/event.

Calagator can read these microformats:

Our wiki has instructions and simple examples for using hCalendar. For more examples, click on any event in Calagator, and then click Get hCalendar markup. (The examples are simplified versions of the Calagator events.)

hcal

hCalendar is an simple, open, distributed calendaring and events format, based on the iCalendar standard RFC2445, suitable for embedding in HTML or XHTML, Atom, RSS, and arbitrary XML.

Here is a sample event including hcal markup:

<div class="vevent">
 <a class="url" href="http://www.web2con.com/">http://www.web2con.com/</a>
  <span class="summary">Web 2.0 Conference</span>: 
  <abbr class="dtstart" title="2007-10-05">October 5</abbr>-
  <abbr class="dtend" title="2007-10-20">19</abbr>,
 at the <span class="location">Argent Hotel, San Francisco, CA</span>
 </div>

ical

iCalendar is an older format that is not embedded in HTML etc. Here is the ical code for the same event:

BEGIN:VCALENDAR
PRODID:-//XYZproduct//EN
VERSION:2.0
BEGIN:VEVENT
URL:http://www.web2con.com/
DTSTART:20071005
DTEND:20071020
SUMMARY:Web 2.0 Conference
LOCATION:Argent Hotel\, San Francisco\, CA
END:VEVENT
END:VCALENDAR

URLS

The import URL must be one of: http, https, or webcal.

Bookmarklet

To simplify importing, you can use the Calagator bookmarklet. On Import Events drag the "Add to Calagator" link to the Bookmarks Toolbar of your browser.

Then, to import a calendar or event, navigate to the calendar or event in your browser and click on the Bookmarklet.