Дидани манбаъи Шаблон:Medal templates documentation

{{Documentation subpage}}
{{TOCRIGHT}}
The [[:Category:Medal infobox templates|Medal infobox]] series of templates allow editors to list an athlete or sportsperson's major medals at the top of their respective biography article, alongside the [[Wikipedia:Manual of Style/Lead section|lead section]].

==Usage==
The medal infobox consists of two templates:
*{{tl|MedalTableTop}} – for starting the table (image optional)
*{{tl|Medal}} – for the several elements within the table

A further template ({{tl|MedalBox}}) is used for listing medals in the middle of the main article text.

==Parameters==
===MedalTableTop===
{{MedalTableTop|image=Michael Johnson at London Olympic Stadium 2010-07 1.JPG|imagesize=180px|alt=Alternative text here|caption=Johnson at the London Olympic Stadium|name=Michael Johnson|sport= Men's [[athletics (sport)|athletics]]|country_code =USA|medals={{Medal|Sport}}}}
;Basic usage: <nowiki>{{MedalTableTop|image=|imagesize=|alt=|caption=|name=|sport=|country_code=|medals=}}</nowiki>

*'''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''.
*'''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.
*'''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.
*'''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. 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.
*'''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.

===Medal===
{{MedalTableTop|name=no|country_code=USA|sport=Men's [[Athletics (sport)|athletics]]|medals=
{{Medal|Competition|[[Olympic Games]]}}
{{Medal|Gold|2012 TEST|100 m}}
{{Medal|Silver|2012 TEST|100 m}}
{{Medal|Bronze|2012 TEST|100 m}}
{{Medal|Winner|2012 TEST|100 m}}
{{Medal|Runnerup|2012 TEST|100 m}}
{{Medal|First|2012 TEST|100 m}}
{{Medal|Second|2012 TEST|100 m}}
{{Medal|Third|2012 TEST|100 m}}
{{Medal|Playoffs|2012 TEST|100 m}}
{{Medal|Disqualified|2012 TEST|100 m}}
{{Medal|Sport|Men's [[bobsled]]}}
{{Medal|Country|{{JAM}}}}
{{Medal|Comp|World Bobsled Championships}}
{{Medal|DQ|2013 TEST|Bobsled}}
}}
The Medal template is a multi-purpose one which allows for all varieties of entries within the medal table.
;Basic usage:  <nowiki>{{Medal|TYPE|FIELD1|FIELD2}}</nowiki>

There are four major types:
* '''Competition''' This states the general competition at which the following medals were achieved (e.g. [[Olympic Games]], [[Pan Pacific Swimming Championships]])
* '''Medal performances''': There are ten types of medal performances. These contain two separate fields for the year of the competition and its location (e.g. [[2008 Summer Olympics|2008 Beijing]], [[2010 Commonwealth Games|2010 Delhi]]) and the medalling event or category (e.g. pole vault, 56 kg, 50 m freestyle). The medal types are (with shortcut in brackets):
** '''Gold''' (G)
** '''Silver''' (S)
** '''Bronze''' (B)
** '''Winner''' (W)
** '''Runnerup''' (RU)
** '''First''' (1st)
** '''Second''' (2nd)
** '''Third''' (3rd)
** '''Playoffs''' (PO)
** '''Disqualified''' (DQ)

{{MedalTableTop|name=no|medals=
{{Medal|TrueSpirit|2012}}
}}

The final type ('''TrueSpirit''') is used for the [[Pierre de Coubertin medal]]. This has only one extra field for the year it was awarded.

{{MedalTableTop|name=no|medals=
{{Medal|Disqualified|2012 TEST|100 m}}<ref>Reason for disqualification</ref>
}}
For the disqualified medal template, it is possible to create a reference directly after the template to explain the reason for disqualification. This can be particularly useful in the case of relay runners disqualified through no fault of their own, due to doping by team mates for example.

{{reflist}}

;Multiple countries/sports
Where an athlete has competed for multiple countries or in multiple sports it will be necessary to use the '''Country''' or '''Sport''' Medal types, in addition to the main sport and country_code listings in the MedalTableTop template

*'''Country''' This is usually the first section showing the person's relevant country (or team). Enter the country's [[List of IOC country codes|three letter code]] in curly brackets (e.g. {{tl|CHN}} ), including "the" where appropriate (e.g. the {{tl|USA}} ). In rare cases the correct input may be something else (e.g. a team name). '''Independent''' is used for [[Independent Olympians at the Olympic Games|independent athletes]].
*'''Sport''' This states the sport that the athlete is competing in (e.g. Women's [[swimming (sport)|swimming]])

===MedalBox===
{{MedalBox|title=International medals|sport=Men's [[ice hockey]]|country={{ih|CAN}}|medals=
{{MedalCompetition|[[Ice Hockey World Championship|World Championship]]}}
{{Medal|Silver|[[1989 World Ice Hockey Championships|1989 Sweden]]|Ice hockey}}
}}
The MedalBox template has a similar output to the MedalTableTop template, but it is specifically designed for non-infobox usages (i.e. mid-article boxes).
;Basic usage:  <nowiki>{{MedalBox|color=|title=|sport=|country=|medals=}}</nowiki>

*'''color''' This option changes the color of the box header. If omitted, the default is light grey.
*'''title''' This parameter allows you to customise the box title. If omitted, the default is "Medal record".
*'''sport''' This displays the athlete's primary sport (e.g. "Men's ice hockey"). This option supersedes the "Medal|Sport" template function.
*'''country''' This displays the athlete's primary country or team (e.g. "{{tl|CAN}}"). This option supersedes the "Medal|Country" template function.
*'''medals''' This is the only compulsory field as this is used to place medals and descriptions within the box through the {{tl|Medal}} template. To work correctly it must be the last field in the main template.

== Examples ==

For competitors who have competed in the same sport for the same country, the templates should be ordered ''Sport'', ''Country'', ''Competition1'', ''Award'', ''Competition2'', ''Award'' and so on.
<pre>
{{MedalTableTop|image=Example-serious.jpg|imagesize=150px|alt=Alt text for image|name=Athlete name
|sport=Men's [[Athletics (sport)|athletics]]|country_code=AUS|medals=
{{Medal|Competition|[[Olympic Games]]}}
{{Medal|Gold|[[2000 Summer Olympics|2000 Sydney]] | [[Athletics at the 2000 Summer Olympics – Men's 100 metres|100 m]] }}
{{Medal|Competition|[[Commonwealth Games]]}}
{{Medal|Silver|[[2006 Commonwealth Games|2006 Melbourne]] | [[Athletics at the 2006 Commonwealth Games|200 m]] }}
{{Medal|Bronze|2006 Melbourne | 400 m }}
}}
</pre>
{{MedalTableTop|image=Example-serious.jpg|imagesize=150px|alt=Alt text for image|name=Athlete name|sport=Men's [[Athletics (sport)|athletics]]|country_code=AUS|medals=
{{Medal|Competition|[[Olympic Games]]}}
{{Medal|Gold  | [[2000 Summer Olympics|2000 Sydney]] | [[Athletics at the 2000 Summer Olympics – Men's 100 metres|100 m]] }}
{{Medal|Competition|[[Commonwealth Games]]}}
{{Medal|Silver | [[2006 Commonwealth Games|2006 Melbourne]] | [[Athletics at the 2006 Commonwealth Games|200 m]] }}
{{Medal|Bronze | 2006 Melbourne | 400 m }}
}}
{{-}}
{{hidden begin
| title      = Example: Competitor who has won medals in different sports, competing for the same country
| titlestyle = background: #B0C4DE; border: 1px solid #B0C4DE; text-align:center;
| bodystyle  = background: #F9F9F9; padding: 0.5em 1em 0em 1em; border: 1px solid #B0C4DE;
}}
{{MedalTableTop|country_code=GBR2|medals=
{{Medal|Sport | Women's [[Rowing (sport)|rowing]]}}
{{Medal|Competition|[[Olympic Games]]}}
{{Medal|Silver  | [[2004 Summer Olympics|2004 Athens]] | [[Rowing at the 2004 Summer Olympics - Women's quadruple sculls|Quadruple sculls]]}}
{{Medal|Sport | Women's [[track cycling]]}}
{{Medal|Competition|Olympic Games}}
{{Medal|Gold | [[2008 Summer Olympics|2008 Beijing]] | [[Cycling at the 2008 Summer Olympics - Women's individual pursuit|Individual pursuit]]}}
}}
For competitors who have won medals in different sports, competing for the same country, the templates should be ordered ''Country'', ''Sport1'', ''Competition'', ''Award'', ''Sport2'', ''Competition'', ''Award'' and so on. The example shown is based on [[Rebecca Romero]].<br clear="all" />
{{hidden end}}

{{hidden begin
| title = Example: Competitor who has won medals in the same sport, competing for different countries
| titlestyle = background: #B0C4DE; border: 1px solid #B0C4DE; text-align:center;
| bodystyle  = background: #F9F9F9; padding: 0.5em 1em 0em 1em; border: 1px solid #B0C4DE;
}}
{{MedalTableTop|sport=Women's [[badminton]]|medals=
{{Medal|Competition|[[Olympic Games]]}}
{{Medal|Country | {{INA}}}}
{{Medal|Silver| [[1996 Summer Olympics|1996 Atlanta]] | [[Badminton at the 1996 Summer Olympics|Singles]]}}
{{Medal|Country | the {{NED}}}}
{{Medal|Silver| [[2004 Summer Olympics|2004 Athens]] | [[Badminton at the 2004 Summer Olympics - Women's singles|Singles]]}}
}}
For competitors who have won medals in the same sport at the same competition, competing for different countries, the templates should be ordered ''Sport'', ''Competition'', ''Country1'',  ''Award'', ''Country2'', ''Award'' and so on. The example shown is from [[Mia Audina]].
<br clear="all" />
{{MedalTableTop|sport=Women's [[badminton]]|medals=
{{Medal|Country | {{DEN}}}}
{{Medal|Competition|[[Olympic Games]]}}
{{Medal|Silver| [[1996 Summer Olympics|1996 Atlanta]] | [[Badminton at the 1996 Summer Olympics|Singles]]}}
{{Medal|Competition|[[European Badminton Championships|European Championships]]}}
{{Medal|Bronze| [[2002 European Badminton Championships|2002 Malmö]] | Singles }}
{{Medal|Country | {{SWE}}}}
{{Medal|Competition|[[Olympic Games]]}}
{{Medal|Silver| [[2004 Summer Olympics|2004 Athens]] | [[Badminton at the 2004 Summer Olympics - Women's singles|Singles]]}}
}}
For competitors who have won medals in the same sport at different competitions, competing for different countries, the templates should be ordered ''Sport'', ''Country1'', ''Competition1'', ''Award'', ''Competition2'',  ''Award'', ''Country2'', ''Competition1'', ''Award'' and so on.<br clear="all" />
{{hidden end}}

{{hidden begin
| title = Example: Medal table embedded within an infobox
| titlestyle = background: #B0C4DE; border: 1px solid #B0C4DE; text-align:center;
| bodystyle  = background: #F9F9F9; padding: 0.5em 1em 0em 1em; border: 1px solid #B0C4DE;
}}
{{Infobox swimmer
| name           = Mary Wayte
| image          = <!-- Only free-content images are allowed for depicting living people -- see [[WP:NONFREE]]. -->
| image_size     = <!-- Only for images narrower than 220 pixels -->
| alt            =
| caption        = 
| fullname       = Mary Alice Wayte
| nicknames      = 
| national_team  = {{USA}}
| strokes        = [[Freestyle swimming|Freestyle]], [[medley swimming|Individual medley]]
| club           = Chinook Aquatic Club
| collegeteam    = [[Florida Gators swimming and diving|University of Florida]]
| birth_date     = <!-- {{Birth date and age|yyyy|mm|dd|mf=y}} --> <!-- Birth date removed per request from Mary Wayte 11/21/2014. -->
| birth_place    = [[Mercer Island, Washington]]
| death_date     =
| death_place    =
| height         = {{convert|5|ft|9|in|m|abbr=on}}
| weight         = {{convert|128|lb|kg|abbr=on}}
| medaltemplates =
{{MedalSport | Women's swimming}}
{{MedalCountry | the United States}}
{{MedalCompetition | [[Swimming at the Summer Olympics|Olympic Games]]}}
{{MedalGold | [[1984 Summer Olympics|1984 Los Angeles]] | [[Swimming at the 1984 Summer Olympics – Women's 200 metre freestyle|200 m freestyle]]}} 
{{MedalGold | 1984 Los Angeles | [[Swimming at the 1984 Summer Olympics – Women's 4 × 100 metre freestyle relay|4x100 m freestyle]]}} 
{{MedalSilver | [[1988 Summer Olympics|1988 Seoul]] | [[Swimming at the 1988 Summer Olympics – Women's 4 × 100 metre medley relay|4x100 m medley]]}} 
{{MedalBronze |1988 Seoul | [[Swimming at the 1988 Summer Olympics – Women's 4 × 100 metre freestyle relay|4x100 m freestyle]]}} 
{{MedalCompetition | [[FINA World Aquatics Championships|World Championships (LC)]]}}
{{MedalSilver | [[1986 World Aquatics Championships|1986 Madrid]] | [[Swimming at the 1986 World Aquatics Championships|4x200 m freestyle]]}}
{{MedalCompetition | [[Pan American Games]]}}
{{MedalGold | [[1983 Pan American Games|1983 Caracas]] | [[Swimming at the 1983 Pan American Games – Women's 4 × 100 metre freestyle relay|4x100 m freestyle]]}}
{{MedalSilver |1983 Caracas | [[Swimming at the 1983 Pan American Games – Women's 200 metre freestyle|200 m freestyle]]}}
{{MedalCompetition | [[Pan Pacific Swimming Championships|Pan Pacific Championships]]}}
{{MedalGold | [[1985 Pan Pacific Swimming Championships|1985 Tokyo]] | 4x200 m freestyle}}
}}
For use within Infobox basketball biography, Infobox sportsperson, Infobox swimmer, Infobox track athlete, and other infobox template that support an "embed" function for the medal table.  Formatting for the medal table embedded within an infobox generally follows the established formatting of the other examples provided, but duplicate wiki links for the sport name ("MedalSport") and represented country ("MedalCountry") may be eliminated within the embedded medal table.<br clear="all" />
{{hidden end}}

===Medalbox===
Here is a basic demonstration of the MedalBox template usage:
<pre>
{{MedalBox|title=International medals|sport=Men's [[ice hockey]]|country={{ih|CAN}}|medals=
{{Medal|Competition|[[World Junior Ice Hockey Championships|World Junior Championships]]}}
{{Medal|Gold|[[2005 World Junior Ice Hockey Championships|2005 Grand Forks]]|}}
{{Medal|Silver|[[2004 World Junior Ice Hockey Championships|2004 Helsinki]]|}}
{{Medal|Competition|[[IIHF World U18 Championships|World Junior U18 Championships]]}}
{{Medal|Gold|[[2003 IIHF World U18 Championships|2003 Yaroslavl]]|}}
{{Medal|Competition|[[Ivan Hlinka Memorial Tournament|Eight Nations Cup]]}}
{{Medal|Gold|[[2002 Ivan Hlinka Memorial Tournament|2002 Slovakia]]|}}
}}
</pre>
{{MedalBox|title=International medals|sport=Men's [[ice hockey]]|country={{ih|CAN}}|medals=
{{Medal|Competition|[[World Junior Ice Hockey Championships|World Junior Championships]]}}
{{Medal|Gold|[[2005 World Junior Ice Hockey Championships|2005 Grand Forks]]|}}
{{Medal|Silver|[[2004 World Junior Ice Hockey Championships|2004 Helsinki]]|}}
{{Medal|Competition|[[IIHF World U18 Championships|World Junior U18 Championships]]}}
{{Medal|Gold|[[2003 IIHF World U18 Championships|2003 Yaroslavl]]|}}
{{Medal|Competition|[[Ivan Hlinka Memorial Tournament|Eight Nations Cup]]}}
{{Medal|Gold|[[2002 Ivan Hlinka Memorial Tournament|2002 Slovakia]]|}}
}}
{{-}}

== Historical templates ==

;Deprecated TableTop templates:
:{{tlx|MedalTop}} and {{tlx|MedalTopPic}} – use {{tlx|MedalTableTop}} with {{tlx|Medal|Competition|[[Olympic Games]]}}
:{{tlx|MedalTop3}} – (for Paralympic Games) use {{tlx|MedalTableTop}} 
:{{tlx|MedalTableTopPic}} – use {{tlx|MedalTableTop}} with the same parameters

;Deprecated Competition templates:
:{{tlx|MedalOlympic}} – use {{tlx|Medal|Competition|[[Olympic Games]]}}
:{{tlx|MedalParalympic}} – use {{tlx|Medal|Competition|[[Paralympic Games]]}}
:{{tlx|MedalWorldChampionships}} – use {{tlx|Medal|Competition|World Championships}}
:{{tlx|MedalEuropeanChampionships}} – use {{tlx|Medal|Competition|European Championships}}

;Deprecated Medal templates
{{tlx|MedalGold}}<br />
{{tlx|MedalSilver}}<br />
{{tlx|MedalBronze}}<br />

For competitions differing from Gold, Silver and Bronze terminology
{{tlx|MedalW}}<br />
{{tlx|MedalRU}}<br />

;Deprecated closing template
{{tlx|MedalBottom}} - table now automatically closes by using the |medals= parameter and moving two curly brackets to the end of the templates.

==Tracking categories==
* [[:Category:Articles using Template:Medal with Playoffs]]
* [[:Category:Articles using Template:Medal with Runner-up]]
* [[:Category:Articles using Template:Medal with Winner]]
* [[:Category:Articles using Template:Medal with unrecognised first positional argument]]

<noinclude>
[[Category:Medal infobox templates]]
[[Category:Documentation shared content templates]]

[[az:Şablon:Medal şablonları]]
[[kk:Үлгі:MedalRelatedTemplates]]
</noinclude>