Bản mẫu:Medal templates documentation

Hộp thông tin huy chương series of templates allow editors to list an athlete or sportsperson's major medals at the top of their respective biography article, alongside the lead section.

**Cách sử dụng**
The medal infobox consists of two templates:
*MedalTableTop – for starting the table (image optional)
*Medal – for the several elements within the table
A further template (MedalBox) is used for listing medals in the middle of the main article text.

**Thông số**

**MedalTableTop**
Cách sử dụng đơn giản: 
*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 Tập tin: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 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 "Thành tích huy chương" 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. Nam của bơi lội) in the first line of the medal record. This replaces the need for  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  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  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  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 Medal template. To work correctly it must be the last field in the main template.

**Medal**
The Medal template is a multi-purpose one which allows for all varieties of entries within the medal table.
Cách sử dụng đơn giản:  
There are four major types:- Competition This states the general competition at which the following medals were achieved (e.g. Thế vận hội, 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. Bắc Kinh 2008, Delhi 2010) and the medalling event or category (e.g. pole vault, 56 kg, 50 m freestyle). The medal types are (with shortcut in brackets):
** Vàng (G)
** Bạc (S)
** Đồng (B)
** Vô địch (W)
** Á quân (RU)
** Hạng nhất (1st)
** Hạng nhì (2nd)
** Hạng ba (3rd)
** Playoffs (PO)
** Bị loại (DQ)
The final type (TrueSpirit) is used for the Pierre de Coubertin medal. This has only one extra field for the year it was awarded.
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.
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 three letter code in curly brackets (e.g. CHN), including "the" where appropriate (e.g. the USA). In rare cases the correct input may be something else (e.g. a team name). Independent is used for independent athletes.
*Sport This states the sport that the athlete is competing in (e.g. Nữ của bơi lội)

**MedalBox**
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).
Cách sử dụng đơn giản:  
*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 "Thành tích huy chương".
*sport This displays the athlete's primary sport (e.g. "Nam của Khúc côn cầu trên băng"). This option supersedes the "Medal|Sport" template function.
*country This displays the athlete's primary country or team (e.g. "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 Medal template. To work correctly it must be the last field in the main template.

**Ví dụ**
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.
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.
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.
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.
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.

**Medalbox**
Here is a basic demonstration of the MedalBox template usage:

**Lịch sử các bản mẫu**
Deprecated TableTop templates:
MedalTop và MedalTopPic – sử dụng MedalTableTop with tlx|Medal|Competition|Thế vận hội
MedalTop3 – (for Paralympic Games) sử dụng MedalTableTop 
MedalTableTopPic – sử dụng MedalTableTop with the same parameters
Deprecated Competition templates:
MedalOlympic – sử dụng Olympic Games
MedalParalympic – sử dụng tlx|Medal|Competition|Paralympic Games
MedalWorldChampionships – sử dụng World Championships
MedalEuropeanChampionships – sử dụng European Championships
Deprecated Medal templates
For competitions differing from Gold, Silver and Bronze terminology
Deprecated closing template
- table now automatically closes by using the |medals= parameter and moving two curly brackets to the end of the templates.

**Theo dõi chuyên mục**
 :Thể loại:Các bài viết sử dụng mẫu:Huy chương với Playoffs- :Thể loại:Các bài viết sử dụng mẫu:Huy chương với á quân- :Thể loại:Các bài viết sử dụng mẫu:Huy chương với vô địch- :Thể loại:Các bài viết sử dụng mẫu:Huy chương với không được công nhận vị trí đối số đầu tiên
Thể loại:Bản mẫu hộp thông tin huy chương