មើលកូដរបស់ ទំព័រគំរូ:Infobox sportsperson/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{high-use|25,000+}}
{{intricate template}}

==Template==
<pre style="overflow:auto">
{{Infobox sportsperson
| name             = 
| image            = <!-- name.jpg -->
| image_size       = <!--Only for images narrower than 220 pixels.-->
| alt              = 
| caption          = 
| headercolor      = 
| native_name      = 
| native_name_lang = 
| birth_name       = 
| fullname         = 
| nickname         = 
| nationality      = 
| ethnicity        = 
| citizenship      = 
| birth_date       = <!-- {{birth date and age|yyyy|mm|dd}} -->
| birth_place      = 
| death_date       = <!-- {{death date and age|death year|death month|death day|birth year|birth month|birth day}} -->
| death_place      = 
| resting_place    = 
| monuments        = 
| residence        = 
| education        = 
| alma_mater       = 
| occupation       = 
| years_active     = 
| employer         = 
| agent            = 
| height           = <!-- {{convert|}} (yyyy) -->
| weight           = <!-- {{convert|}} (yyyy) -->
| spouse           = 
| life_partner     = 
| other_interests  = 
| website          = <!-- {{URL|www.example.com}} -->
| country          = 
| sport            = 
| position         = 
| disability       = 
| disability_class = 
| rank             = 
| event            = 
| collegeteam      = 
| universityteam   = 
| league           = 
| league_type      = 
| club             = 
| team             = 
| turnedpro        = 
| partner          = 
| former_partner   = 
| coach            = 
| retired          = 
| coaching         = 
| worlds           = 
| regionals        = 
| nationals        = 
| olympics         = 
| paralympics      = 
| commonwealth     = 
| highestranking   = 
| pb               = 
| medaltemplates   = 
| show-medals      = 
| updated          = {{subst:CURRENTDAY}} {{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}
}}
</pre>

==Parameters==
{|class=wikitable
|-
! Parameter
! Description
|-
| '''name'''
| The short or common name of the subject. If this parameter is omitted, the name of the article is used.
|-
| '''image'''
| An image of the subject. Type the name of the image file without adding <code>File:</code> before it or [[Help:Link|wikilinking]] it. If no image is available yet, [[Wikipedia:Centralized discussion/Image placeholders|do not use an image placeholder]].
|-
| '''image_size'''
| The image size. Only use this parameter if the image is less than 220 [[pixel]]s in width. If so, than indicate the image's respective width in pixels, like this: <code>image_size=200px</code>.
|-
| '''alt'''
| [[Alt text]] for the image displayed.
|-
| '''caption'''
| A caption for the image displayed.
|-
| '''headercolor'''
| To change the default color of headers, indicate a [[Web colors#X11 color names|color name]] (''e.g.'', <code>lightblue</code> or <code>orange</code>) or a [[Web colors#Hex triplet|hex triplet]] (''e.g.'', <code>#2468A0</code>). To determine the hex triplet of a color, see [[List of colors]]; or go to [[List of colors#Colors by shade]], click on the article associated with the desired color, and look up the hex triplet.
|-
|colspan="2" style="background:silver; text-align:center;"| '''Personal information'''
|-
| '''native_name'''
| The person's name in their own language, if different.
|-
| '''native_name_lang'''
| [[ISO 639-2]] code, ''e.g.'', "fre" or "fra" for French. If more than one, use {{tl|lang}} in {{para|native_name}} instead.
|-
| '''birth_name'''
| The birth name of the subject.
|-
| '''fullname'''
| The full name of the subject.
|-
| '''nickname'''
| The subject's common nickname(s). If there is more than one, list the names alphabetically and separate them with commas.
|-
| '''nationality'''
| The subject's nationality. May be used instead of citizenship (below) or vice versa in cases where any confusion could result. Should only be used {{em|with}} citizenship when they somehow differ. Should only be used if nationality cannot be inferred from the birthplace. [[Wikipedia:Manual of Style (icons)#Biographical use|Do not use a flag template]].
|-
|'''ethnicity'''
|Ethnic background. Rarely useful, and must be supported with a citation from a reliable source. [[Wikipedia:Manual of Style (icons)#Avoid flag icons in infoboxes.|Do not use a flag template]].
|-
| '''citizenship'''
| Country of legal citizenship, if different from nationality. Rarely needed. ''See usage notes for nationality above.'' Should only be used if citizenship cannot be inferred from the birthplace. [[Wikipedia:Manual of Style (icons)#Avoid flag icons in infoboxes|Do not use a flag template]].
|-
| '''birth_date'''
| The subject's birth date.  Use {{tlx|birth date and age|year|month|day}}.
|-
| '''birth_place'''
| The subject's place of birth. [[Wikipedia:Manual of Style (icons)#Do not use flags to indicate locations of birth, residence, or death|Do not use a flag template]].
|-
| '''death_date'''
| The subject's death date, if applicable. Use {{tlx|death date and age|death year|death month|death day|birth year&#124;birth month&#124;birth day}}.
|-
| '''death_place'''
| The subject's place of death, if applicable. [[Wikipedia:Manual of Style (icons)#Do not use flags to indicate locations of birth, residence, or death|Do not use a flag template]].
|-
| '''resting_place'''
| Place of burial, ash-scattering, etc. [[Wikipedia:Manual of Style (icons)#Do not use flags to indicate locations of birth, residence, or death|Do not use a flag template]].
|-
| '''monuments'''
| Significant monuments erected, buildings named, ''etc.'', in honour of the subject. If many, link to an appropriate section of the article instead.
|-
| '''residence'''
|The subject's place of residence. [[Wikipedia:Manual of Style (icons)#Do not use flags to indicate locations of birth, residence, or death|Do not use a flag template]].
|-
| '''education'''
|Education, ''e.g.'', degree, institution and graduation year, if relevant. If very little information is available or relevant, the {{para|alma_mater}} parameter may be more appropriate.
|-
| '''alma_mater'''
| The sportsperson's ''[[alma mater]]''. This parameter is a more concise alternative to {{para|education}}, and will most often simply consist of the linked name of the last-attended higher education institution. It is usually not relevant to include either parameter for non-graduates, but article talk page consensus may conclude otherwise, as at [[Bill Gates]].
|-
|'''occupation'''
|Occupation as given in the article lead, including sport and non-sport professions, ''e.g.'', <code><nowiki>Professional [[football (soccer)|footballer]], [[coach]], [[sports journalist]] and [[venture capitalist]]</nowiki></code>. Try to avoid too much redundancy with the {{para|sport}} parameter.
|-
| '''years_active'''
| Date range in years of the subject's activity in their principal occupation(s) and/or other activity for which they are notable. Use the format <code>1950–2000</code>, or <code>1970–present</code> if still active (note the use of an [[WP:ENDASH|en dash]], not hyphen).  [[Wikipedia:Manual of Style (dates and numbers)|Do not link dates or years]].
|-
| '''employer'''
| The subject's employer(s). This is a good place for noting publications that the subject writes articles for, TV shows they are commentators, sporting goods companies for whom they do endorsements, ''etc.'' Use {{tlx|ubl}} or {{tlx|pl}} to format multiple entries, and use common sense explanatory notes if needed, ''e.g.'', to distinguish between multiple sports or disciplines.
|-
| '''agent'''
| The subject's agent (individual and/or agency).
|-
| '''height'''
| The subject's [[Human height|height]], if relevant.
*To satisfy [[Wikipedia:Manual_of_Style#National_varieties_of_English|international variations of English]], if the subject is American or British (or primarily notable in English for playing on an American or British team, or for participating in American or British sports) put measurements in feet and inches first, and use a template to convert to centimeters in parentheses, for example: 
*:{{tlx|convert|6|ft|3|in|cm|abbr=on}} — giving "{{convert|6|ft|3|in|cm|abbr=on}}"
*Conversely, if he or she is not American or British, place measurements in centimetres first, then use template to convert to feet and inches in parentheses, for example:
*:<code><nowiki>{{convert|191|cm|ftin|abbr=on}}</nowiki></code> — giving "{{convert|191|cm|ftin|abbr=on}}"
*If the subject's height stated in a source is the ''converted measurement'', tweak the parameters of the {{tlx|convert}} template if required to ensure that this measurement is accurately stated. For example, if a source states that an American or British athlete is 192 cm tall, type <code><nowiki>{{convert|6|ft|3.6|in|cm|abbr=on}}</nowiki></code> to get the result "{{convert|6|ft|3.6|in|cm|abbr=on}}" (some experimentation using the "Show preview" button may be required). Indicating <code><nowiki>{{convert|6|ft|4|in|cm|abbr=on}}</nowiki></code>, which would yield "{{convert|6|ft|4|in|cm|abbr=on}}", would be inaccurate.
*For sportspersons who have not reached their adult height, it is very important to add the year when the height was measured, in parentheses (round brackets) after the height.
*Provide a reference for the information after the year, in parentheses, indicating in the footnote both the source and the original units, like this: "[<var>source of information</var>] (original measurement in feet and inches)"; ''see [[Wikipedia:Manual of Style (dates and numbers)#Unit conversions]]''.
|-
| '''weight'''
| The subject's weight, if relevant. 
*If he or she is American (or primarily notable in English for playing for an American team, of for participating in U.S. sports), put measurements in pounds first, then in kilograms in parentheses, for example:
*: {{tlx|convert|120|lb|kg}} — giving "{{convert|120|lb|kg}}"
*If he or she is not American, place measurements in kilograms first, then in pounds in parentheses, for example:
*: {{tlx|convert|62|kg|lb|0}} — giving "{{convert|62|kg|lb|0}}"
* Note that the final zero is necessary for correct rounding of kilogram-to-pound conversions.
* After the weight, add the year when the weight was measured, in parentheses.  Please supply a reference in the same manner as for the subject's height.
|-
| '''spouse'''
| Name of spouse(s), followed by years of marriage. Use the format Name (1950–present) for current spouse and Name (1970–1999) for former spouse(s); for convenience, consider using {{tl|marriage}}. Separate entries using {{tl|Plainlist}} or {{tl|Unbulleted list}}. For deceased persons still married at time of death, close the date range with death year.
|-
| '''life_partner'''
|For unmarried life partners (of any gender or sexual preference), not business partners. Use the format Name (1950–present) for current partner and Name (1970–1999) for former partner(s).
|-
| '''other-interests'''
| Significant interests other than sports that the subject has. Please use this parameter sparingly.
|-
| '''website'''
| Official website only. Unofficial websites should be placed under <code><nowiki>==External links==</nowiki></code> in the body of the article. Use {{tl|URL}} as in <nowiki>{{URL|examplesite.com|ExampleSite.com}}</nowiki>. Do not include the <code>www.</code> part unless the server is misconfigured and requires it. Use [[camel case]] capitalization to make multiword domain names easier to read.
|-
|colspan="2" style="background:silver; text-align:center;"| '''Sport'''
|-
| '''country'''
| The country or countries {{em|that the subject represents in sport}}, if any (not all sports involve nationalistic representation). [[Wikipedia:Manual of Style (icons)#Use of flags for sportspersons|Do not use a flag template]]. Wikilink the country name only if doing so would not be redundant with links already present in prior parameters. Use {{tlx|ubl}} or {{tlx|pl}} to format multiple entries, and use common sense explanatory notes if needed: <code><nowiki>{{ubl|United Kingdom (assoc. football, rugby league)|[[New Zealand]] (rugby union)}}</nowiki></code>.
|-
| '''sport'''
| The sport(s) that the subject has {{em|notably}} participated in (basketballers dabbling in tournament poker, or cricketers doing celebrity golf fundraisers does {{em|not}} count as notable participation in those sports).  Use {{tlx|ubl}} or {{tlx|PL}} to format multiple entries; list the events chronologically, alphabetically or by depth of participation, as best suits the article; and give date ranges and other clarifications where appropriate. Link the name of the sport to a suitable Wikipedia article if one is available. Using the footballer example given under {{para|occupation}} above, the {{para|sport}} value might be <code><nowiki>{{ubl}}[[Rugby league]] (1991–1992)|[[Association football]] (1992–2001)|[[Rugby union]] (coach, 2001–present)</nowiki></code>.
|-
| '''position'''
| Primary position (e.g., goalkeeper, forward, quarterback, ...)
|-
| '''disability'''
| A [[disability]] that the subject has.
|-
| '''disability_class'''
| The [[disability sport classification]](s) that the subject competes under.
|-
| '''rank'''
| The rank of the subject in their sport. Use {{tlx|colorbox}} to indicate belt colour for martial artists.
|-
| '''event'''
| The event(s) or discipline(s) within the sport that the subject specializes in, wikilinked to suitable article(s). Use {{tlx|ubl}} or {{tlx|PL}} to format multiple entries, and list the events alphabetically, chronologically or by depth of participation, as best suits the article<code><nowiki>{{ubl|[[Breaststroke]]|[[Freestyle swimming|Freestyle]]}}</nowiki></code>. This parameter should be removed when not useful, as in the case of the footballer example given in {{para|occupation}} and {{para|sport}}, above.
|-
| '''universityteam'''<br />'''collegeteam'''
| The team (squad) that the subject plays or played on at his or her [[university]] or [[College#United States|college in the US sense]]. Note: you cannot use both of these parameters at once. Use {{tlx|ubl}} or {{tlx|PL}} to format multiple entries, and use common sense explanatory notes if needed, ''e.g.'', to distinguish between multiple sports or disciplines.
|-
| '''league'''
| The name of the sport league(s), federation(s) or other sanctioning system(s) under which the sportsperson plays/played. It is not necessary to add this parameter if the sport in question has only one such notable organization. For play under/membership in a regional (''e.g.'', continental) federation, it may be useful to name that body and the parent organization, ''e.g.'', <code><nowiki>[[European Pocket Billiard Federation]] ([[World Pool-Billiard Association|WPA]])</nowiki></code>.
|-
| '''league_type'''
| Change the "League" heading to another word, such as "Federation", "Association", ''etc.'', to match the terminology used in the sport.
|-
| '''club'''<br />'''team'''
| The name of the sport club(s) or team(s) that the subject belongs/belonged to, if any, with the years in parentheses. Use {{tlx|ubl}} or {{tlx|PL}} to format multiple entries. Do not use both, unless the terms have distinct meanings in the sport in question (which is not the case with [[football (soccer)]] &ndash; "club", "team" and "squad" are syonymous (but this template does not support a {{para|squad}} parameter).
|-
| '''turnedpro'''
| The date or year that the subject turned professional. [[Wikipedia:Manual of Style (dates and numbers)|Do not link dates or years]].
|-
| '''partner'''
|rowspan="2"| Other sportpeople with whom the subject regularly plays, or used to play, doubles matches.
|-
| '''formerpartner'''
|-
| '''coach'''
| The name of a [[WP:N|notable]] person who is [[coach (sport)|coaching]] or once coached the subject, and the years in parentheses after the name.
|-
| '''retired'''
| The date or year ([[Wikipedia:Manual of Style (dates and numbers)|not wikilinked]]) that the subject retired from sports., if applicable. If the subject died before formal retirement, do not add the death date to this parameter, just remove it entirely.  [[Wikipedia:Manual of Style (dates and numbers)|Do not link dates or years]].
|-
| '''coaching'''
| The names of [[WP:N|notable]] other sportspeople that the subject is now coaching. Only add the names of persons who have Wikipedia articles about them (no red links). If there is more than one person, arrange the names alphabetically by last name and separate them with commas.
|-
|colspan="2" style="background:silver; text-align:center;"| '''Achievements and titles'''
|-
| '''worlds'''
|rowspan="6"| Significant titles the subject has earned at world or international, regional and national competitions, and at the [[Olympic Games|Olympic]] or [[Paralympic Games]], for example:

<pre style="width:500px;overflow:auto">
{{ubl
 |'''[[Athletics at the 2008 Summer Paralympics|2008 Summer Paralympics]]''': 200&amp;nbsp;m &amp;ndash; Gold
 |'''2008 Summer Paralympics''': 400&amp;nbsp;m &amp;ndash; Silver
}}</pre>

or:

<pre style="width:500px;overflow:auto">
{{pl|
* '''[[Athletics at the 2008 Summer Paralympics|2008 Summer Paralympics]]''': 200&amp;nbsp;m &amp;ndash; Gold
* '''2008 Summer Paralympics''': 400&amp;nbsp;m &amp;ndash; Silver
}}</pre>

The string <code>&amp;nbsp;</code> creates a [[non-breaking space]] between the number and the unit ''(see [[Wikipedia:Manual of Style (dates and numbers)#Non-breaking spaces]])''. And <code>&amp;ndash;</code> creates an [[en dash]]; alternatively, insert an en dash using the symbol table that appears below the edit window. {{tlx|Ubl}} ({{tlx|unbulleted list}}) and {{tlx|pl}} ({{tlx|plainlist}}) format lists with each item on its own line, with semantic and accessible HTML list mark-up, but no bullets.

{{strong|Regional}} means {{em|multi}}-national, not {{em|sub}}-national; sub-national competition is not notable enough for an infobox.

If the sport is not {{strong|Olympic}}, then remove the {{para|olympics}} parameter.

If the subject does not have a {{strong|disability}}, then remove the {{para|paralympics}} parameter.
|-
| '''regionals'''
|-
| '''nationals'''
|-
| '''olympics'''
|-
| '''paralympics'''
|-
| '''commonwealth'''
|-
| '''highestranking'''
| The subject's highest world ranking (as a cardinal numeral) with the year(s) when this was achieved in parentheses, like this: <code>1st (2005)</code>. Add the discipline/event or other clarifiers if needed: <code>1st (freestyle, 2005)</code>, or use a longer prose description of the title <code><nowiki>[[2009 WPA Men's World Nine-ball Championship|WPA World Nine-ball Champion (Men's Div., 2009)]]</nowiki></code>.
|-
| '''pb'''
| If applicable, the personal best times the subject has achieved with the years when these were achieved in parentheses, using {{tlx|ubl}} or {{tlx|PL}} to format list items:

<pre style="width:500px;overflow:auto">
{{ubl|'''100&amp;nbsp;m backstroke''': 1:03.17 (2001, '''WR''') |'''200&amp;nbsp;m butterfly''': 2:12.63 (2003) }}</pre>

The following abbreviations may be used in parentheses after the year:<br />'''CR''' – competition record, '''NR''' – national record, '''OR''' – Olympic record, '''PR''' – Paralympic record, '''WR''' – world record.
|-
|colspan="2" style="background:silver; text-align:center;"| '''Medal record'''
|-
| '''medaltemplates'''
| All templates from the medal record infobox except {{tlx|MedalTableTop}} and {{tlx|MedalBottom}}.
Set out the medal templates in the order stated in the [[Template:Medal templates documentation|medal templates documentation]], and arrange the competitions alphabetically by name.<p>
<pre style="width:500px;overflow:auto">
{{MedalSport|[[Swimming#competitive swimming|Men's swimming]]}}
{{MedalCountry|{{SWE}}}}
{{MedalCompetition|[[FINA World Aquatics Championships]]}}
{{MedalSilver|[[2005 World Aquatics Championships|2005 Montreal]]|200&amp;nbsp;m [[breaststroke]]}}
{{MedalCompetition|[[Olympic Games]]}}
{{MedalGold|[[2008 Summer Olympics|2008 Beijing]]|[[Swimming at the 2008 Summer Olympics|100&amp;nbsp;m freestyle]]}}
{{MedalCompetition|[[Pan Pacific Swimming Championships|Pan Pacific Championships]]}}
{{MedalBronze|[[2006 Pan Pacific Swimming Championships|2006 Victoria]]|100&amp;nbsp;m [[butterfly stroke|butterfly]]}}
</pre>
|-
| '''show-medals'''
|If <code>show-medals=no</code>, the medal table is collapsed. By default, it is expanded and will only be collapsed if the "hide" link is clicked. The default should be left as is unless there are more than three medals.
|-
|colspan="2" style="background:silver; text-align:center;"| '''Modules'''
|-
| '''module'''<br />'''module2'''
| Used for embedding other infoboxes into this one. These parameters are not usually used directly in articles, and are mainly for creating other infoboxes based on this one with additional parameters. To see how these parameters are used, have a look at how {{tl|Infobox swimmer}} is built. Note: '''module''' displays above the ''Sport'' heading and '''module2''' displays above the ''Achievements and titles'' heading.
|}

==Example==
{{Infobox sportsperson
| name           = Laurentia Tan
| image          = LaurentiaTan-portrait-20080920.jpg
| image_size     = 130px
| caption        = Tan at a Paralympics celebration ceremony at [[Cathay Cineleisure Orchard]] on 20 September 2008
| headercolor    = chocolate
| fullname       = Laurentia '''Tan''' Yen Yi
| nationality    = [[Singapore]]an
| birth_date     = {{birth date and age|1979|4|24|df=yes}}
| birth_place    = [[Singapore]]
| residence      = [[United Kingdom]]
| education      = [[Oxford Brookes University]]
| country        = [[Singapore]]
| sport          = [[Equestrianism]]
| event          = [[Dressage]]
| paralympics    = '''[[2008 Summer Paralympics]]''': Individual Championship Dressage (IA) – Bronze; Individual Freestyle to Music Dressage (IA) – Bronze
| medaltemplates = 
{{MedalSport       |[[Dressage]]}}
{{MedalCountry     |{{SGP}}}}
{{MedalCompetition |[[Paralympic Games]]}}
{{MedalBronze      |[[Equestrian at the 2008 Summer Paralympics|2008 Beijing]] |Individual Championship Dressage (class IA)}}
{{MedalBronze      |[[Equestrian at the 2008 Summer Paralympics|2008 Beijing]] |Individual Freestyle to Music Dressage (class&nbsp;IA)}}
| updated        = 17 September 2008
}}
<pre style="overflow:auto">
{{Infobox sportsperson
| name           = Laurentia Tan
| image          = LaurentiaTan-portrait-20080920.jpg
| image_size     = 130px
| caption        = Tan at a Paralympics celebration ceremony at [[Cathay Cineleisure Orchard]] on 20 September 2008
| headercolor    = chocolate
| fullname       = Laurentia '''Tan''' Yen Yi
| nationality    = [[Singapore]]an
| birth_date     = {{birth date and age|1979|4|24|df=yes}}
| birth_place    = [[Singapore]]
| residence      = [[United Kingdom]]
| education      = [[Oxford Brookes University]]
| country        = [[Singapore]]
| sport          = [[Equestrianism]]
| event          = [[Dressage]]
| paralympics    = '''[[2008 Summer Paralympics]]''': Individual Championship Dressage (IA) – Bronze; Individual Freestyle to Music Dressage (IA) – Bronze
| medaltemplates = 
{{MedalSport       |[[Dressage]]}}
{{MedalCountry     |{{SGP}}}}
{{MedalCompetition |[[Paralympic Games]]}}
{{MedalBronze      |[[Equestrian at the 2008 Summer Paralympics|2008 Beijing]] |Individual Championship Dressage (class IA)}}
{{MedalBronze      |[[Equestrian at the 2008 Summer Paralympics|2008 Beijing]] |Individual Freestyle to Music Dressage (class&nbsp;IA)}}
| updated        = 17 September 2008
}}
</pre>
{{clear}}

==Microformat==
{{UF-hcard-person}}

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
{{Basepage subpage|
[[Category:Sportsperson infobox templates|Sportsperson]]
}}
</includeonly>