Help:ICalendar format

From semantic-mediawiki.org
Help:ICalendar formatICalendar日历格式
ICalendar format
Exports data in iCalendar format.
Collection
Further Information
Provided by: Extension "Semantic Result Formats"
Added: 1.4.2
Removed: still supported
Requirements: none
Format name: icalendar
Enabled? Indicates whether the result format is enabled by default upon installation of the respective extension. yes
Authors: Markus Krötzsch , Denny Vrandečić , Jeroen De Dauw
Categories: export
Table of Contents

The result format icalendar, part of Extension "Semantic Result Formats", is used to produce links for downloading data from a wiki in iCalendar format.

Parameters[edit]

Format specific
Parameter Type Default Description
title text empty The title of the calendar file
description text empty The description of the calendar file
timezone text empty A comma separated list of timezones

Example[edit]

Syntax
{{#ask:
 [[Category:SMWCon]]
 [[Has conference type::SMWCon]]
 |?Has conference=summary
 |?Has planned start=start
 |?Has planned finish=end
 |?Has location=location
 |?Has description=description
 |format=icalendar
 |title=SMWCon
 |description=The dates of all SMWCons.
 |searchlabel=Export for iCalendar
}}
Result

Export for iCalendar

Data fields[edit]

Properties in printout statements should use one of the following labels, or otherwise are ignored in the resulting iCalendar. The available fields are:

  • summary: the short description shown as the label of the calendar entry (type arbitrary, but String would be common), available from version 1.7.0
  • start: the start date, must be of type Date,
  • end: the end date, must be of type Date,
  • location: the place of the event (type arbitrary, but Page would be common),
  • description: description of a single event (not suported by all tools, but useful to have more than the short page name as an event name.

Remarks[edit]

Calendars work very well on most calendar tools, with the notable exception of MS Outlook up to version 2003. Only later versions of this tool can deal with calendars that have more than one event.

Calendar downloads can be used in two ways by a calendar software. Either the calendar is downloaded and imported into a local calendar, or it is subscribed to and updated regularly. In the former case, changes in the wiki will not affect the imported dates, while in the latter case changes in the wiki will be propagated to the subscriber of the calendar.