Difference between revisions of "Template:HCalendar event/Office Hours"
(wiki-syntax is evil) |
m (appears to be missing opening noinclude) |
||
(28 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<includeonly>{{hCalendar event | <onlyinclude><includeonly>{{hCalendar event/Office Hours/{{{mode|default}}} | ||
|dtstart={{{dtstart|}}} | |dtstart={{{dtstart|}}} | ||
|dtend={{{dtend|}}} | |dtend={{{dtend|}}} | ||
| | |Resident={{{Resident}}} | ||
|description={{{description | |namespace={{{namespace|User}}} | ||
|description={{{description}}} | |||
|location={{{location|}}} | |location={{{location|}}} | ||
| | |start={{{start|}}} | ||
|end={{{end|}}} | |||
| | |weekday={{{weekday|}}} | ||
| | }} | ||
| | {{#ifeq:{{NAMESPACE}}|User|{{#switch:{{SUBPAGENAME}} | ||
| | |Office Hours=[[Category:Office Hours|{{{Resident}}}]] | ||
| | |Teen Office Hours=[[Category:Office Hours|{{{Resident}}}]]}}{{#switch:{{{voice|}}} | ||
| | |*=[[Category:Voice-Enabled Office Hours|{{{Resident}}}]] | ||
| | |teen=[[Category:Voice-Enabled Office Hours|{{{Resident}}}]]}}|}}</includeonly></onlyinclude><noinclude> | ||
| | {{hCalendar subscribe}} | ||
}}</ | == Convenience == | ||
The previous generation of Office Hours templates where created to improve productivity. Office Hours were being listed in multiple places- and as duplication of data increases, so does the effort to keep it all up to date. | |||
The problem then developed that Residents and Lindens alike wanted to be able to keep track of the events on Google Calendars, iCal and other calendar services/programs. There used to be an official calendar maintained by a Linden, which fell behind in updates, and there is now a calendar maintained by a Resident. The problem with maintaining a separate resource is that it needs to be kept up-to-date with any changes made. | |||
Which is where the hCalendar event templates come in- the ability to automate the generation of a calendar without relying on a Linden Lab employee or Resident to set aside some time/resources to maintain a calendar. | |||
== hCalendar == | |||
hCalendar is a [http://microformats.org/wiki/hcalendar microformat]- a series of class attributes and other standard HTML tricks that replicate the functionality of the pre-existing iCalendar standard (aka [http://www.ietf.org/rfc/rfc2445.txt RFC 2445]). | |||
hCalendar allows calendar data to be embedded in a web page without breaking the HTML standard, and also allows for the web page to be transposed easily into an iCalendar feed, via such 3rd party services as [http://technorati.com/events/ Technorati], or the W3C's own [http://www.w3.org/People/Bos/Hcalproxy/ hCal Proxy]. | |||
== Usage == | |||
[[Image:Office Hours in Thunderbird.png|thumb|right|Embedded calendar data in Office Hours article being displayed in Thunderbird]] | |||
The general behaviour that emerged from the Office Hours is that most office hours are done every week on the same day at the same time of day. This template acts as a wrapper which takes that behaviour into mind, simplifying the process of declaring the Office Hours as a recurring event. | |||
If an article lists events that use the hCalendar event series of templates, it is a good idea to include the [[Template:hCalendar subscribe|<nowiki>{{hCalendar subscribe}}</nowiki> template ]] at the top of the page so that Residents can easily add the embedded calendar to their Calendar service/program. | |||
=== Variables === | |||
* '''Resident'''- The name of the Resident that is hosting the Office Hours | |||
* '''description'''- A good place to let the other Residents know what'll be covered at your Office Hours | |||
* '''weekday'''- What day of the week the Office Hours take place ''multiple templates will be required for each day Office Hours are held''. | |||
* '''start'''- What time of day the Office Hours start '''''make sure to include the timezone!''''' (PST and PDT will be auto-replaced to SLT for the convenience of Residents) | |||
* '''end'''- What time of day the Office Hours finish '''''make sure to include the timezone!''''' (PST and PDT will be auto-replaced to SLT for the convenience of Residents) | |||
* '''location'''- a SLurl to the location the Office Hours are held. | |||
* '''voice'''- Whether or not the Office Hours will be voice-enabled. | |||
** Use a single asterisk- "*" for the Main Grid, | |||
** Use "teen" for the Teen Grid. | |||
=== Example === | |||
==== Default ==== | |||
<pre><nowiki>{{hCalendar event/Office Hours | |||
|Resident=Amber Linden | |||
|description=Topics: General | |||
|weekday=Monday | |||
|start=9am PST | |||
|end=10am PST | |||
|location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] | |||
}}{{hCalendar event/Office Hours | |||
|Resident=Amber Linden | |||
|description=Topics: General | |||
|weekday=Tuesday | |||
|start=2pm PST | |||
|end=3pm PST | |||
|location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] | |||
}}</nowiki></pre> | |||
{{hCalendar event/Office Hours | |||
|Resident=Amber Linden | |||
|description=Topics: General | |||
|weekday=Monday | |||
|start=9am PST | |||
|end=10am PST | |||
|location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] | |||
}}{{hCalendar event/Office Hours | |||
|Resident=Amber Linden | |||
|description=Topics: General | |||
|weekday=Tuesday | |||
|start=2pm PST | |||
|end=3pm PST | |||
|location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] | |||
}} | |||
=== tr === | |||
<pre><nowiki><table class="sortable"> | |||
<tr><th>Host</th><th>Description</th><th>Start Time</th><th>End Time</th><th>Location</th></tr> | |||
{{hCalendar event/Office Hours | {{hCalendar event/Office Hours | ||
|mode=tr | |||
|Resident=Amber Linden | |Resident=Amber Linden | ||
|description=Topics: | |description=Topics: General | ||
|weekday=Monday | |weekday=Monday | ||
|start= | |start=9am PST | ||
|end= | |end=10am PST | ||
|location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] | |||
}}{{hCalendar event/Office Hours | |||
|mode=tr | |||
|Resident=Amber Linden | |||
|description=Topics: General | |||
|weekday=Tuesday | |||
|start=2pm PST | |||
|end=3pm PST | |||
|location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] | |||
}} | |||
</table></nowiki></pre> | |||
<table class="sortable"> | |||
<tr><th>Host</th><th>Description</th><th>Start Time</th><th>End Time</th><th>Location</th></tr> | |||
{{hCalendar event/Office Hours | |||
|mode=tr | |||
|Resident=Amber Linden | |||
|description=Topics: General | |||
|weekday=Monday | |||
|start=9am PST | |||
|end=10am PST | |||
|location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] | |||
}}{{hCalendar event/Office Hours | |||
|mode=tr | |||
|Resident=Amber Linden | |||
|description=Topics: General | |||
|weekday=Tuesday | |||
|start=2pm PST | |||
|end=3pm PST | |||
|location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] | |location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] | ||
}} | }} | ||
</table> | |||
[[Category:hCalendar Templates|Office Hours]] | |||
</noinclude> | </noinclude> |
Latest revision as of 13:32, 20 December 2010
![]() |
HCalendar event/Office Hours includes embedded calendar data! Subscribe to it with a calendar program, or copy and paste this URL into a Google Calendar! |
Convenience
The previous generation of Office Hours templates where created to improve productivity. Office Hours were being listed in multiple places- and as duplication of data increases, so does the effort to keep it all up to date.
The problem then developed that Residents and Lindens alike wanted to be able to keep track of the events on Google Calendars, iCal and other calendar services/programs. There used to be an official calendar maintained by a Linden, which fell behind in updates, and there is now a calendar maintained by a Resident. The problem with maintaining a separate resource is that it needs to be kept up-to-date with any changes made.
Which is where the hCalendar event templates come in- the ability to automate the generation of a calendar without relying on a Linden Lab employee or Resident to set aside some time/resources to maintain a calendar.
hCalendar
hCalendar is a microformat- a series of class attributes and other standard HTML tricks that replicate the functionality of the pre-existing iCalendar standard (aka RFC 2445).
hCalendar allows calendar data to be embedded in a web page without breaking the HTML standard, and also allows for the web page to be transposed easily into an iCalendar feed, via such 3rd party services as Technorati, or the W3C's own hCal Proxy.
Usage
The general behaviour that emerged from the Office Hours is that most office hours are done every week on the same day at the same time of day. This template acts as a wrapper which takes that behaviour into mind, simplifying the process of declaring the Office Hours as a recurring event.
If an article lists events that use the hCalendar event series of templates, it is a good idea to include the {{hCalendar subscribe}} template at the top of the page so that Residents can easily add the embedded calendar to their Calendar service/program.
Variables
- Resident- The name of the Resident that is hosting the Office Hours
- description- A good place to let the other Residents know what'll be covered at your Office Hours
- weekday- What day of the week the Office Hours take place multiple templates will be required for each day Office Hours are held.
- start- What time of day the Office Hours start make sure to include the timezone! (PST and PDT will be auto-replaced to SLT for the convenience of Residents)
- end- What time of day the Office Hours finish make sure to include the timezone! (PST and PDT will be auto-replaced to SLT for the convenience of Residents)
- location- a SLurl to the location the Office Hours are held.
- voice- Whether or not the Office Hours will be voice-enabled.
- Use a single asterisk- "*" for the Main Grid,
- Use "teen" for the Teen Grid.
Example
Default
{{hCalendar event/Office Hours |Resident=Amber Linden |description=Topics: General |weekday=Monday |start=9am PST |end=10am PST |location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] }}{{hCalendar event/Office Hours |Resident=Amber Linden |description=Topics: General |weekday=Tuesday |start=2pm PST |end=3pm PST |location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] }}
tr
<table class="sortable"> <tr><th>Host</th><th>Description</th><th>Start Time</th><th>End Time</th><th>Location</th></tr> {{hCalendar event/Office Hours |mode=tr |Resident=Amber Linden |description=Topics: General |weekday=Monday |start=9am PST |end=10am PST |location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] }}{{hCalendar event/Office Hours |mode=tr |Resident=Amber Linden |description=Topics: General |weekday=Tuesday |start=2pm PST |end=3pm PST |location=[http://slurl.com/secondlife/Portage/14/154/98/?title=Second%20Life%20Helper%27s%20Lyceum Second Life Helper's Lyceum] }} </table>
Host | Description | Start Time | End Time | Location |
---|---|---|---|---|
Amber Linden | Topics: General | Mondays from 9am | 10am PST | Second Life Helper's Lyceum |
Amber Linden | Topics: General | Tuesdays from 2pm | 3pm PST | Second Life Helper's Lyceum |