Nwuan a̱tyin ka a li Ta‌̱mpi‌̱let:MedalistTable/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->

=== Usage ===
This template is to facilitate the creation of tables of medallists in articles.

To create tables of medallists at sporting events, start a table and place the following template on the first line:

::<nowiki>{{MedalistTable |type= |location= |columns= |style= }}</nowiki>

====Parameters====
The following optional parameters allow to change the number of columns and labels for the columns:
*'''type'''          = This sets the label for the first column. The default is "Games". Common alternative labels include: "Event", "Year", "Championships", etc.
*'''location'''      = This offers the option of an additional column, labeled "Location", between the first column and the medalist columns. To add this column, set the parameter to "yes".
*'''columns'''       = This adjusts the number of columns within the medalists' fields. A value of "1" leaves one field in each of the Gold, Silver, and Bronze columns, enough for the medalists' names. A value of "2" adds a second field for each medalist, allowing to add the competitor's result, time, score, nationality, etc. The default is "1".
*'''style'''         = This sets the labels and background colors for the medalist columns. The default style is "medal".
**''medal''       – Labels "Gold", "Silver", and "Bronze" with gold, silver, and bronze background, respectively.
**''ribbon-CA''   – Labels "First", "Second", and "Third" with red, blue, and white background (CA fair ribbon colors), respectively.
**''ribbon-US''   – Labels "First", "Second", and "Third" with blue, red, and yellow background (US fair ribbon colors), respectively.
**''ordinal''     – Labels "First", "Second", and "Third" with grey background.
**[anything else] – Labels "First", "Second", and "Third" with gold, silver, and bronze background, respectively.

The following optional parameters allow to alter table style: 
*'''class'''         = This offers the option to use a user-defined table style. The default is "wikitable".
*'''fontsize'''      = This adjusts the overall font size used in the table. The default is "100" percent.
*'''labelwidth'''    = This adjusts the size of the first column. Depending on amount of information in the boxes in the first column, this may be increased or reduced for presentation purposes. The default is "120" px.
*'''locationwidth''' = This adjusts the size of the location column (if parameter "location" is set). Depending on amount of information in the boxes in the location column, this may be increased or reduced for presentation purposes. The default is "140" px.
*'''width'''         = This adjust the width of the medalist columns. Depending on amount of information in the columns, this may be increased or reduced for presentation purposes. The default is "200" px.

===Example 1===
Entering the following will give the example table below.
<div style="width: 550px; background: #dddddd; border: 1px solid black; padding:0.5em 1em 0.5em 1em;"><pre>
{| {{MedalistTable |type=Event |columns=2 |style=ribbon-US}}
|-
| [[Egg and spoon race]]
| [[Johnny Gold]] || 30 seconds
| [[Sammy Silver]] || 36 seconds
| [[Billy Bronze]] || 12 hours
|-
| [[Man versus Horse Marathon]]
| Horse || 2:01:10
| Man || 4:45:30
| Dog || Did not finish
|}
</pre></div>

{| {{MedalistTable |type=Event |columns=2 |style=ribbon-US}}
|-
| [[Egg and spoon race]]
| [[Johnny Gold]] || 30 seconds
| [[Sammy Silver]] || 36 seconds
| [[Billy Bronze]] || 12 hours
|-
| [[Man versus Horse Marathon]]
| Horse || 2:01:10
| Man || 4:45:30
| Dog || Did not finish
|}

===Example 2===
The following is another style of usage, one which documents past winners at a certain championships or Games.

<div style="width: 650px; background: #dddddd; border: 1px solid black; padding:0.5em 1em 0.5em 1em;"><pre>
{| {{MedalistTable|location=yes}}
|-
! scope=row rowspan=2 |[[Athletics at the 1896 Summer Olympics|1896]]
|rowspan=2| Athens
|rowspan=2|{{flagIOCathlete|[[Thomas Burke (athlete)|Thomas Burke]]|USA|1896 Summer}}
|rowspan=2|{{flagIOCathlete|[[Fritz Hofmann (athlete)|Fritz Hofmann]]|GER|1896 Summer}}
|{{flagIOCathlete|[[Francis Lane]]|USA|1896 Summer}}
|-
|{{flagIOCathlete|[[Alojz Sokol]]|HUN|1896 Summer}}
|-
! scope=row | [[Athletics at the 1900 Summer Olympics|1900]]
| Paris
|{{flagIOCathlete|[[Frank Jarvis]]|USA|1900 Summer}}
|{{flagIOCathlete|[[Walter Tewksbury]]|USA|1900 Summer}}
|{{flagIOCathlete|[[Stan Rowley]]|AUS|1900 Summer}}  
|-
! scope=row | [[Athletics at the 1904 Summer Olympics|1904]]
| St. Louis
|{{flagIOCathlete|[[Archie Hahn]]|USA|1904 Summer}}
|{{flagIOCathlete|[[Nate Cartmell]]|USA|1904 Summer}}
|{{flagIOCathlete|[[William Hogenson]]|USA|1904 Summer}} 
|}

</pre></div>

{| {{MedalistTable|location=yes}}
|-
! scope=row rowspan=2 |[[Athletics at the 1896 Summer Olympics|1896]]
|rowspan=2| Athens
|rowspan=2|{{flagIOCathlete|[[Thomas Burke (athlete)|Thomas Burke]]|USA|1896 Summer}}
|rowspan=2|{{flagIOCathlete|[[Fritz Hofmann (athlete)|Fritz Hofmann]]|GER|1896 Summer}}
|{{flagIOCathlete|[[Francis Lane]]|USA|1896 Summer}}
|-
|{{flagIOCathlete|[[Alojz Sokol]]|HUN|1896 Summer}}
|-
! scope=row | [[Athletics at the 1900 Summer Olympics|1900]]
| Paris
|{{flagIOCathlete|[[Frank Jarvis (athlete)|Frank Jarvis]]|USA|1900 Summer}}
|{{flagIOCathlete|[[Walter Tewksbury]]|USA|1900 Summer}}
|{{flagIOCathlete|[[Stan Rowley]]|AUS|1900 Summer}}  
|-
! scope=row | [[Athletics at the 1904 Summer Olympics|1904]]
| St. Louis
|{{flagIOCathlete|[[Archie Hahn]]|USA|1904 Summer}}
|{{flagIOCathlete|[[Nate Cartmell]]|USA|1904 Summer}}
|{{flagIOCathlete|[[William Hogenson]]|USA|1904 Summer}} 
|}

==Bu nwuan==
*[[Template:RankedMedalTable]]
*[[Template:MedalistTableParalympics]]

<includeonly>{{Sandbox other||
<!-- CATEGORIES HERE, THANKS -->
[[Category:Olympics medalist templates|Table]]
[[Category:Templates with partial table wikitext]]
}}</includeonly>