Template:Calendar/doc

From OpenStreetMap Wiki
Jump to: navigation, search

How to update the calendar

The above calendar box appears in many pages (most notably the Main Page and Current Events page).

When an event is past and you remove it from this table, please add it to the Template:PastEvents table.

Two templates are used for this. Template:Calendar2 contains the framing, background colors, etc. and Template:Calendar (this one) contains the dates and events. If you click 'edit' you'll see a table following this format (rows are ordered by date):

{|
|-
| {{cal|conference}} || {{dm|Month Day}} || [URL International event] {{SmallFlag|float=none|Event name|Event-logo.png}}, [[Country]] {{SmallFlag|Country}}
|-
| {{cal|mapevent}} || {{dm|Month Day}} || [[Page name on this wiki|National event]] {{SmallFlag|Country}}
|-
| {{cal|social}} || {{dm|Month Day|Month Day}} || Local event, [[City]], [[Country]] {{SmallFlag|Country}} {{SmallFlag|City|Symbol of city.png}}
|-
| {{cal|social}} || {{dm|Month Day|Month Day}} || Local event, [//www.openstreetmap.org/#map=zoom/lat/lon City], [[Country]] {{SmallFlag|Country}}
|}

Use one of the following templates to specify the nature of the event:

Appearance Code Info
Info {{cal|info}} for information.
IRC {{cal|irc}} for IRC meetings at the OSM official IRC channel.
Mapping party {{cal|mapevent}} for mapping parties, or other surveys.
Meeting {{cal|meeting}} for meetings in meatspace
Pizza {{cal|pizza}} for hack-a-thons involving pizza at ungodly hours
Social {{cal|social}} for informal meetings, or just to have a beer with fellow OSM addicts.
Conference {{cal|conference}} for talks/panels/workshops at conferences.
Speaking {{cal|speaking}} for talks/speaking events
TV {{cal|tv}} for TV/press appearances. Turn on your TV that day!
Podcast {{cal|podcast}} for radio/podcast recordings
MISC {{cal|misc}} for anything else

Geolocating and linking events within the information column:

  • Try to geolocate your event, at least the city name.
  • If there's a page for the city on this wiki, link the city to this page using a wikilink, and make sure that this page displays a map to locate this city.
  • If there's no page on this wiki (and you don't intend to create one), avoid creating a red link to a missing page. Instead use a link to the OSM map such as: [//www.openstreetmap.org/#map=zoom/lat/lon City].
  • If the event itself has a link to a page on this wiki, use a wikilink, and please use readable non-encoded characters in the wiki page name (or in the possible anchor after the # sign).
  • If a link goes to an external site, and this site supports both HTTP and HTTPS, remove the "http:" or "https:" prefix before "//". Please avoid using link redirectors, please use the final target of the link.

Usage of flags and other icons within the information column:

  • For placing country flag icons or similar location symbols (such as coat of arms) to the right of the columns, or if the default SVG flag does not exist for this location, please look at the documentation of Template:SmallFlag. Ideally all these locations used in Calendar events should have a link to an existing page on this wiki (showing the map and a list of most active OSM projects, tools or other community pages related to that location). Order these location templates at end of line: the country first (will be the rightmost one in the display), then the symbol for the region or city.
  • For showing small icons that are only project icons or small logos related to the (big) event but not related to location, don't place them to the left but to the right using "float=right" or inline with "float=none". Avoid logos for something else than big events, and make sure the logo is appriately licenced in a way compatible with this wiki (logos stored in Wikimedia Commons are compatible, provided they also don't abuse the Wikimedia Commons rules).
  • Don't oversize these icons, they MUST remain constrained with height and width BELOW 30 pixels (the default height of icons displayed by the SmallFlag template is 15 pixels, it is largely enough for all flags).

BIG events could be written in bold. You will need to crank up the font size a notch in order for this difference to show up on the Main Page (since font size is reduced there). What is a big event? We've tended to move towards only making events big very occasionally, so we're talking big international OSM gatherings with say more than 20 OSMers attending.