From Tetherless World Wiki
A calendar is an easy way to maintein events.
Example Calendar
The calendar is created using the syntax
<calendar name="Calendar Example" startyear="2008" yearsahead="0" template="Calendar Example"></calendar>
Template:
Calendar_Example.
Create Event Title
The tile of the first section of the event page is the title shown in the calendar for the event, and you can use semantic tags in it, e.g.,
==[[has title::event title]]==
Redirects and Cross Link
If an event page redirects to another page, the content of the redirected page will be used for the event (including title). Examples:
The calendar supports chain redirection. It is a good idea to rename (i.e. redirect) your event page, as the default page name is automatically generated and look not quite informative in queries.
'Attn: Do NOT delete the automatically generated event page even you renamed it; its existence is required by the calendar to find the renamed event.
Cross Link: a good practice is that multiple people can share the same event on their calendars. This is simply by redirect events on different calendars to the same event page.
Calendar Template
A default template can be used for a calendar, check out the example template of this calendar.
Query Events
If you properly define semantic tags of events on your calendar, you may easily query them. Below are some typical query tasks
- List all events of your calendar: if you have "part of" semantic tag on your event template, you may query them as in the example: Calendar Example.
- Query by topic tags: find all events on this calendar that are related to "Calendar". Go to Special:Ask and type "[[part of::Calendar Example]][[has topic::Calendar]]".
- Query by participants: find all events on this calendar that are attended by Alice. Go to Special:Ask and type "[[part of::Calendar Example]][[Has participant::Alice]]".
You may save your query in a page using the "ask" syntax. Please check the source of the example page: Help:Calendar/Query. To design more powerful queries, check semantic wiki query manual [1] and [2].
Query can be posed across multiple calendars, here is a real world example: find all events that are in Li and Jies' calendar and is attended by Li (click here).
