Template:GamesSport/doc

The GamesSport template is for usage on main multi-sport event articles only. The purpose of this template is to radically simplify the listing of sports on multi-sport event articles.

Typically, such articles will have a list of the sports held at the event and each listing comprises three or four parts:

1. a link to the main article of that sport
2. a link to the detailed summary or results of that sport at that event.
3. a figure denoting the total number of events held within that sport during the games

The GamesSport template allows you to render all these elements by simply entering the name of the sport. Its basic usage is:

• {{GamesSport|SPORT}}

Note that the template uses International Olympic Committee naming conventions, so "football" directs to association football and "hockey" directs to field hockey.

Plain example (without GamesSport)

Previously, each of these elements would need to be written out separately like the example below for the 2010 South Asian Games:

• Athletics ()
• Cycling ()

• Football ()
• Golf ()

• Hockey ()
• Squash ()

<poem> {{Col-begin}} {{Col-3}} * [[Track and field athletics|Athletics]] ({{detailslink|Athletics at the 2010 South Asian Games}}) * [[Cycling]] ({{detailslink|Cycling at the 2010 South Asian Games}}) {{col-3}} * [[Association football|Football]] ({{detailslink|Football at the 2010 South Asian Games}}) * [[Golf]] ({{detailslink|Golf at the 2010 South Asian Games}}) {{col-3}} * [[Field hockey|Hockey]] ({{detailslink|Hockey at the 2010 South Asian Games}}) * [[Squash (sport)|Squash]] ({{detailslink|Squash at the 2010 South Asian Games}}) {{col-end}} </poem>

With GamesSport

This information can be rendered much more easily with the GamesSport template as it removes the need to spend time finding the correct article for each sport and its corresponding pictogram. The link to the results works off the name of the article in which it is placed. Therefore, if you use the template here it links to "SPORT at the GamesSport/doc"; on the 2008 Summer Olympics article it would link to "SPORT at the 2008 Summer Olympics".

• Athletics ()
• Cycling ()

• Football ()
• Golf ()

• Hockey ()
• Squash ()

<poem> {{Col-begin}} {{Col-3}} * {{GamesSport|Athletics}} * {{GamesSport|Cycling}} {{col-3}} * {{GamesSport|Football}} * {{GamesSport|Golf}} {{col-3}} * {{GamesSport|Hockey}} * {{GamesSport|Squash}} {{col-end}} </poem>

Adding number of events

The number of events contested within each sport may be listed if desired. This can be done with using the "Event=<number of events>" parameter as follows: <poem> {{Col-begin}} {{Col-3}} * {{GamesSport|Athletics|Events=25}} * {{GamesSport|Cycling|Events=6}} {{col-3}} * {{GamesSport|Football|Events=1}} * {{GamesSport|Golf|Events=1}} {{col-3}} * {{GamesSport|Hockey|Events=2}} * {{GamesSport|Squash|Events=2}} {{col-end}} </poem>

Would give you the following:

• Athletics (25) ()
• Cycling (6) ()

• Football (1) ()
• Golf (1) ()

• Hockey (2) ()
• Squash (2) ()

Adding pictogram

The pictogram may be displayed if desired. This can be done with using the "Image=Yes" parameter as follows: <poem> {{Col-begin}} {{Col-3}} * {{GamesSport|Athletics|Events=25|Image=Yes}} * {{GamesSport|Cycling|Events=6|Image=Yes}} {{col-3}} * {{GamesSport|Football|Events=1|Image=Yes}} * {{GamesSport|Golf|Events=1|Image=Yes}} {{col-3}} * {{GamesSport|Hockey|Events=2|Image=Yes}} * {{GamesSport|Squash|Events=2|Image=Yes}} {{col-end}} </poem>

Would give you the following:

• Athletics (25) ()
• Cycling (6) ()

• Football (1) ()
• Golf (1) ()

• Hockey (2) ()
• Squash (2) ()

Changing listing format

The listing format may be changed if desired. Displaying only single link to the main sport may be done with using the "Format=m" parameter as follows: <poem> {{Col-begin}} {{Col-3}} * {{GamesSport|Athletics|Events=25|Image=Yes|Format=m}} * {{GamesSport|Cycling|Events=6|Image=Yes|Format=m}} {{col-3}} * {{GamesSport|Football|Events=1|Image=Yes|Format=m}} * {{GamesSport|Golf|Events=1|Image=Yes|Format=m}} {{col-3}} * {{GamesSport|Hockey|Events=2|Image=Yes|Format=m}} * {{GamesSport|Squash|Events=2|Image=Yes|Format=m}} {{col-end}} </poem>

Would give you the following:

• Athletics (25)
• Cycling (6)

• Football (1)
• Golf (1)

• Hockey (2)
• Squash (2)

Displaying only single link to the details of the sport results may be done with using the "Format=d" parameter as follows: <poem> {{Col-begin}} {{Col-3}} * {{GamesSport|Athletics|Events=25|Image=Yes|Format=d}} * {{GamesSport|Cycling|Events=6|Image=Yes|Format=d}} {{col-3}} * {{GamesSport|Football|Events=1|Image=Yes|Format=d}} * {{GamesSport|Golf|Events=1|Image=Yes|Format=d}} {{col-3}} * {{GamesSport|Hockey|Events=2|Image=Yes|Format=d}} * {{GamesSport|Squash|Events=2|Image=Yes|Format=d}} {{col-end}} </poem>

Would give you the following:

• Athletics (25)
• Cycling (6)

• Football (1)
• Golf (1)

• Hockey (2)
• Squash (2)

See also

• Template:GamesSport2 – as GamesSport template, but displays pictogram by default and uses just a single link to the details of the sport results (i.e. full analog of the GamesSport template with parameters Image=Yes|Format=d)
• Template:NoIcon – adding a blank space to align sports without relevant pictograms