Editing Template:Medal templates documentation (section)

===MedalTableTop===
{{MedalTableTop
| name = Michael Johnson
| image = Michael Johnson at London Olympic Stadium 2010-07 1.JPG
| image_size = 180px
| alt = Alternative text here
| caption = Johnson at the London Olympic Stadium
| sport = Men's [[sport of athletics|athletics]]
| country_code = USA
| medals = {{Medal|Sport}}
}}
<pre style="overflow: auto;">
{{MedalTableTop
| name = Michael Johnson
| image = Michael Johnson at London Olympic Stadium 2010-07 1.JPG
| image_size = 180px
| alt = Alternative text here
| caption = Johnson at the London Olympic Stadium
| sport = Men's [[sport of athletics|athletics]]
| country_code = USA
| medals = {{Medal|Sport}}
}}
</pre>
{{clear}}

{{MedalTableTop | name = no | sport = Women's [[basketball]] | country = {{bkw|POL}} | medals =
{{MedalCompetition | [[EuroBasket Women|European Championships]] }}
{{MedalGold | [[EuroBasket Women 1999|1999 Poland]] | Team competition }}
}}
<pre style="overflow: auto;">
{{MedalTableTop | name = no | sport = Women's [[basketball]] | country = {{bkw|POL}} | medals =
{{MedalCompetition | [[EuroBasket Women|European Championships]] }}
{{MedalGold | [[EuroBasket Women 1999|1999 Poland]] | Team competition }}
}}
</pre>
{{clear}}

; Basic usage
: <nowiki>{{MedalTableTop |name= |image= |image_size= |alt= |caption= |sport= |country_code= |medals= }}</nowiki>
: <nowiki>{{MedalTableTop |name= |image= |image_size= |alt= |caption= |sport= |country= |medals= }}</nowiki>

* '''name''' – This option adjusts the title that appears at the top of the box. This should typically be the athlete's common name. By default it will display the article title without the disambiguator, for example on [[Michael Johnson (sprinter)]] "Michael Johnson" will appear by default. To deactivate the title enter '''no''' in the field.
* '''image''' – This give you the option to place a headline image in the infobox. Use just the file name and extension, excluding the namespace prefix, for example: MyImage.jpg not ''File:MyImage.jpg''.
* '''image_size''' (or '''imagesize''') – This adjusts the size of the image and must consist of a number followed by "px" (e.g. 150px). The default is 100px. Sizes over 200px are no recommended for typical usage.
* '''alt''' – This provides a description of the image for [[WP:Accessibility|accessibility]] users or those using weak connections
* '''caption''' – This adds a short description to describe the image. Try to be brief, using just a few words.
* '''header''' – This optional field can be used to change the text in the opening "Medal record" section. This is useful when the template appears in a section of an article. See [[Michael Phelps]] for a working example.
* '''sport''' – This option includes the athlete's sport (e.g. Men's [[swimming (sport)|swimming]]) in the first line of the medal record. This replaces the need for <nowiki>{{Medal|Sport}}</nowiki> when an athlete has medalled in only one sport. In cases where an athlete has competed in multiple sports, it is still possible to use the <nowiki>{{Medal|Sport}}</nowiki> template usage to list the different sports.
* '''country_code''' – This option uses the country code (e.g. USA = United States, CHN = China, GBR2 = Great Britain) to generate the country that the athlete represents in the second line of the medal record. It will automatically include "the" in front of the country name for the following codes: BAH (the&nbsp;{{BAH}}), GAM (the&nbsp;{{GAM}}), GBR (the&nbsp;{{GBR}}), MHL (the&nbsp;{{MHL}}), NED (the&nbsp;{{NED}}), PHI (the&nbsp;{{PHI}}), SEY (the&nbsp;{{SEY}}), SOL (the&nbsp;{{SOL}}), UAE (the&nbsp;{{UAE}}), URS (the&nbsp;{{URS}}), and USA (the&nbsp;{{USA}}). This replaces the need for <nowiki>{{Medal|Country}}</nowiki> when an athlete has competed for only one country. In cases where an athlete has represented multiple countries, it is still possible to use the <nowiki>{{Medal|Country}}</nowiki> template usage to list the different countries.
* '''country''' – May be used in place of '''country_code''' to display the country name using text or templates, such as {{tl2|BRA}} which displays {{BRA}} (same output as with {{para|country_code|BRA}}), {{tl2|bkw|Poland}} which displays {{bkw|POL}} (links to [[Poland women's national basketball team]] article), or {{tl2|ih|CAN}} which displays {{ih|CAN}} (links to [[Canada men's national ice hockey team]]). Include "the" where appropriate (e.g. the {{tl|BAH}}, the {{tl|GAM}}, the {{tl|GBR}}, the {{tl|MHL}}, the {{tl|NED}}, the {{tl|PHI}}, the {{tl|SEY}}, the {{tl|SOL}}, the {{tl|UAE}}, the {{tl|URS}}, the {{tl|USA}}). This replaces the need for the <nowiki>{{Medal|Country}}</nowiki> template (e.g. <nowiki>{{Medal|Country|{{BRA}}}}</nowiki> or <nowiki>{{Medal|Country|{{bkw|POL}}}}</nowiki>).
* '''medals''' – This is the only compulsory field as this is used to place medals and descriptions within the infobox through the {{tl|Medal}} template. To work correctly it must be the last field in the main template.