paul@290 | 1 | Navigation Controls
|
paul@290 | 2 | -------------------
|
paul@290 | 3 |
|
paul@292 | 4 | Links to other views from the day view can override the default "all events"
|
paul@292 | 5 | limits, which is not necessarily beneficial.
|
paul@290 | 6 |
|
paul@290 | 7 | The "New event" link should probably not be present when only remote events
|
paul@290 | 8 | are being aggregated by a calendar.
|
paul@290 | 9 |
|
paul@218 | 10 | Points in Time
|
paul@218 | 11 | --------------
|
paul@218 | 12 |
|
paul@218 | 13 | Events which have identical start and end times might be represented by
|
paul@218 | 14 | building a calendar scale that distinguishes between times acting as start
|
paul@290 | 15 | times and times acting as end times. (The iCalendar specification appears to
|
paul@290 | 16 | state that events without end dates/times are actually points in time, but
|
paul@290 | 17 | this potentially conflicts with the expectation that merely specifying a start
|
paul@290 | 18 | date or time produces an event with an undefined end point or a "common sense"
|
paul@290 | 19 | end point.)
|
paul@218 | 20 |
|
paul@218 | 21 | Consider making dates convertible to timespans of the form (start of day,
|
paul@218 | 22 | start of next day).
|
paul@218 | 23 |
|
paul@211 | 24 | Localised Keywords
|
paul@211 | 25 | ------------------
|
paul@211 | 26 |
|
paul@211 | 27 | It should be possible to define events using localised equivalents of "start",
|
paul@211 | 28 | "end", "summary" and so on. To achieve this, the page language would be found
|
paul@211 | 29 | and regular expressions built to use the localised keywords, falling back on
|
paul@211 | 30 | the English keywords, would then search for event details.
|
paul@211 | 31 |
|
paul@211 | 32 | Recurring Events
|
paul@211 | 33 | ----------------
|
paul@211 | 34 |
|
paul@232 | 35 | Recurring event information from iCalendar sources should be considered in
|
paul@232 | 36 | order to avoid showing incomplete or incorrect event datetimes. Ultimately,
|
paul@232 | 37 | such information may need to be parsed and incorporated into the general event
|
paul@232 | 38 | recurrence processing.
|
paul@232 | 39 |
|
paul@211 | 40 | Having events recur at certain intervals would potentially involve the
|
paul@211 | 41 | expansion of events to produce multiple instances within a specified period of
|
paul@211 | 42 | interest, and such expansion could occur after an event's details have been
|
paul@211 | 43 | read. Care would need to be taken in cases where no limits are placed on a
|
paul@211 | 44 | calendar: the expanded instances should not be allowed to recede into the past
|
paul@211 | 45 | and future indefinitely; where no other events exist to provide implicit
|
paul@211 | 46 | limits, some other default limits might be required to let the expansion
|
paul@211 | 47 | occur.
|
paul@211 | 48 |
|
paul@211 | 49 | The description of recurring events could be based on the iCalendar
|
paul@211 | 50 | specification, although simpler schemes could be preferable. Recurring event
|
paul@211 | 51 | descriptions might start with "every" and then provide a time period ("day",
|
paul@211 | 52 | "week", "month", "year") for offsets from a specified date or time, perhaps
|
paul@211 | 53 | using qualifiers ("first", "second", "other", and so on), or instead provide a
|
paul@211 | 54 | more complete description using additional qualifiers that may override any
|
paul@211 | 55 | specified date or time for instances other than the primary occurrence. For
|
paul@211 | 56 | example, "every second Wednesday of every other month".
|
paul@211 | 57 |
|
paul@227 | 58 | Possible grammar:
|
paul@227 | 59 |
|
paul@227 | 60 | <recurrence> [ of <recurrence> ]...
|
paul@227 | 61 | [ from <datetime> ]
|
paul@227 | 62 | [ until <datetime> ]
|
paul@227 | 63 |
|
paul@227 | 64 | recurrence = every [ <qualifier> ] <interval>
|
paul@227 | 65 | interval = second | minute | hour | day | <weekday> | week | month | year
|
paul@227 | 66 |
|
paul@227 | 67 | The resolution of each successive <recurrence> must be lower than those it
|
paul@227 | 68 | follows. Thus, "every second day of every second week..." is valid whereas
|
paul@227 | 69 | "every second week of every second day..." is not.
|
paul@227 | 70 |
|
paul@204 | 71 | Map Views
|
paul@204 | 72 | ---------
|
paul@204 | 73 |
|
paul@218 | 74 | Other projections might be supported. This would be necessary for various
|
paul@218 | 75 | retrieved map images.
|
paul@218 | 76 |
|
paul@204 | 77 | Dynamic images obtained from other sites or generated locally might provide some
|
paul@204 | 78 | enhancements to the map view. For example, a weather/radar image might show the
|
paul@204 | 79 | cloud or rain forecast either for the current situation or, if forecasts are
|
paul@204 | 80 | available, for the times of events shown.
|
paul@204 | 81 |
|
paul@204 | 82 | Consider having day numbers down the side of a map view with highlighted days
|
paul@204 | 83 | indicating days having events, and with pop-up elements shown upon hovering over
|
paul@204 | 84 | each highlighted day.
|
paul@204 | 85 |
|
paul@204 | 86 | To Do Items
|
paul@204 | 87 | -----------
|
paul@204 | 88 |
|
paul@204 | 89 | Consider adding support for "to do" items. These might have time-related details
|
paul@204 | 90 | such as deadlines, but are more likely to have relationships with other items,
|
paul@204 | 91 | potentially forming a hierarchy of items.
|
paul@204 | 92 |
|
paul@204 | 93 | Event Section Parser
|
paul@204 | 94 | --------------------
|
paul@204 | 95 |
|
paul@204 | 96 | Events could be described using a Wiki section, potentially retaining the
|
paul@204 | 97 | definition list syntax for consistency with the current method of describing
|
paul@204 | 98 | events:
|
paul@204 | 99 |
|
paul@204 | 100 | {{{#!event
|
paul@204 | 101 | Start:: 2011-06-07
|
paul@204 | 102 | End:: 2011-06-07
|
paul@204 | 103 | Summary:: Event inside a section
|
paul@204 | 104 | }}}
|
paul@204 | 105 |
|
paul@204 | 106 | Such events could then be presented using more sophisticated methods and
|
paul@205 | 107 | potentially be editable. To support direct editing, the parser would provide
|
paul@205 | 108 | a hidden form field indicating the location of the section in the Wiki text,
|
paul@205 | 109 | and the new event action would be enhanced to read existing events from the
|
paul@205 | 110 | indicated page region, populating the form fields with the data found in the
|
paul@205 | 111 | page.
|
paul@220 | 112 |
|
paul@220 | 113 | Enhance the linkToEvent method on Event instances so that event sections can
|
paul@220 | 114 | provide anchors for events in Wiki pages.
|
paul@242 | 115 |
|
paul@242 | 116 | UID Properties
|
paul@242 | 117 | --------------
|
paul@242 | 118 |
|
paul@242 | 119 | Especially in the case of aggregation from multiple sources, the only reliable
|
paul@242 | 120 | way of avoiding repetition of the same events described in different places is
|
paul@242 | 121 | for authors to include a UID property identifying each event, using the same
|
paul@242 | 122 | value regardless of where the event is being published.
|
paul@265 | 123 |
|
paul@292 | 124 | Formatting in iCalendar Output
|
paul@292 | 125 | ------------------------------
|
paul@292 | 126 |
|
paul@292 | 127 | If there is a reasonably standard way of incorporating Wiki text in iCalendar
|
paul@292 | 128 | output alongside plain text, this would enable events aggregated from Wiki
|
paul@292 | 129 | sources to use Wiki text to describe things like the location and topics of an
|
paul@292 | 130 | event with links and other formatting that could then be reproduced in the
|
paul@292 | 131 | aggregating Wiki.
|
paul@292 | 132 |
|
paul@265 | 133 | Remote Source Timeouts
|
paul@265 | 134 | ----------------------
|
paul@265 | 135 |
|
paul@265 | 136 | Sometimes, network problems can cause delays in accessing remote sources. The
|
paul@265 | 137 | library should support either a timeout mechanism or asynchronous retrieval of
|
paul@265 | 138 | remote source data.
|