ਫਰਮਾ:Infobox swimmer/doc ਲਈ ਸਰੋਤ ਵੇਖੋ

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{#ifeq:{{SUBPAGENAME}}|sandbox||{{High-use}}}}
{{Person infobox header}}
{{Uses Infobox sportsperson|wrapped=1}}
{{Lua|Module:Template wrapper|Module:Check for clobbered parameters}}
{{Tracks Wikidata|P18|cat=No local image but image on Wikidata}}

== Intended uses ==

This infobox template is intended to be used in articles about current and former competition [[swimming (sport)|swimmers]].  This infobox template is ''not'' intended to be used for articles about former competition swimmers who are primarily notable as competition swimming coaches.  Articles about American college swimming coaches use [[:Template:Infobox college coach]], the uniform template for college coaches in all American college sports.  Infobox college coach may be adapted for swimming coaches of other nationalities; if it is inappropriate for other coaches for any reason, consider using [[:Template:Infobox person]].

==Template==

{{Parameter names example
| name
| image
| image_size
| alt
| caption
| native_name
| <!--native_name_lang-->
| birth_name
| full_name
| nickname
| nationality
| national_team
| birth_date
| birth_place
| death_date
| death_place
| height
| weight
| spouse
| website
| strokes
| classification
| club
| collegeteam
| coach
| module
| <!-- show-medals -->
| medaltemplates
| module2
| <!-- nocat_wdimage -->
}}

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox swimmer
| name           = 
| 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        = 
| native_name    = 
| native_name_lang = 
| birth_name     = <!-- if different than name -->
| full_name      = <!-- if different than name/birth_name -->
| nickname       = 
| nationality    = <!-- use only when necessary per [[WP:INFONAT]] -->
| national_team  = <!-- Only for country represented in international competition -->
| birth_date     = {{Birth date and age|yyyy|mm|dd}}
| birth_place    = 
| death_date     = 
| death_place    = 
| height         = <!-- "X cm (yyyy)" or "X ft Y in (yyyy)" -->
| weight         = <!-- "X kg (yyyy)" or "X lb (yyyy)" -->
| spouse         =
| website        = 
| strokes        = 
| classification = <!-- Only for para-swimmers; omitted otherwise -->
| club           = 
| collegeteam    = 
| coach          = 
| module         = 
| show-medals    = <!-- "yes" to display, hidden by default -->
| medaltemplates = 
| module2        = 
}}
</syntaxhighlight>
{{clear}}

==Parameter instructions==
This template accepts all parameters that {{tl|Infobox sportsperson}} does. See [[Template:Infobox sportsperson/doc#Parameters|here]] for a complete list. For commonly-used and swimmer-specific parameters, see below:
{| class="wikitable"
|-
! width="20%" | Parameter
! width="80%" | Description
|-
| style="text-align:center;" | '''name'''
| The [[WP:COMMONNAME|common name]] of the swimmer.
|-
| style="text-align:center;" | '''image'''
| A photograph of the swimmer.  Type the name of the image file without adding "<code>Image:</code>" or "<code>File:</code>" before it, nor [[Help:Link|wikilinking]] it.
|-
| style="text-align:center;" | '''image_size'''
| The image size.  Only use this parameter if the image is less than 220 [[pixel]]s in width.  If so, then indicate the image's respective width in pixels, like this: "<code>image_size=200</code>".
|-
| style="text-align:center;" | '''alt'''
| [[Wikipedia:Alternative text for images|Alternative text]] describing the image displayed for visually impaired readers.
|-
| style="text-align:center;" | '''caption'''
| A brief caption for the image displayed.
|-
| style="text-align:center;" | '''native_name'''
| The swimmer's name in their [[native language]], if different than '''name'''.
|-
| style="text-align:center;" | '''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.
|-
| style="text-align:center;" | '''birth_name'''
| The birth name of the swimmer, if different than '''name'''.
|-
| style="text-align:center;" | '''full_name'''
| The full name of the swimmer, if different than '''name''' and '''birth_name'''.
|-
| style="text-align:center;" | '''nickname'''
| The swimmer's common nickname(s) set off with quote marks.  If there is more than one nickname, list the names alphabetically and separate them with commas.  All nicknames must be verified by reliable sources per [[WP:V]], [[WP:RS]] and [[WP:BLP]]; otherwise, they should be removed.
|-
| style="text-align:center;" | '''nationality'''
| The swimmer's nationality.  Complicated situations of nationality and multiple citizenship should be explained in the main body text of the article, if relevant, not in the infobox.  If the swimmer has competed in international championships such as the Olympics, FINA world championships, Commonwealth Games, Pan American Games, and Pan Pacific Championships, use the "national team" parameter instead of the "nationality" parameter.
|-
| style="text-align:center;" | '''national_team'''
| The national swimming team for which the swimmer competes in international events.  If the "national team" parameter is invoked, the "nationality" parameter is excluded.  This parameter is only used for swimmers who have represented their country as a member of their national team in international competition such as the Olympic Games, FINA world championships, Commonwealth Games, Pan American Games, and Pan Pacific Championships.  A flag icon, representing the swimmer's national team, is used in this parameter; for example, "{{tlx|USA}}", renders a 7-pixel U.S. flag and the words "United States".
|-
| style="text-align:center;" | '''birth_date'''
| The swimmer's birth date.  Use {{tlx|Birth date and age|yyyy|mm|dd}} for living swimmers; use {{tlx|Birth date|yyyy|mm|dd}} for deceased swimmers.
|-
| style="text-align:center;" | '''birth_place'''
| The swimmer's place of birth.  Note that this is not necessarily the same as the swimmer's "hometown."  Birth place should be wiki-linked to the Wikipedia article about the town or city where the swimmer was born.
|-
| style="text-align:center;" | '''death_date'''
| The swimmer's death date, if applicable.  Use {{tlx|Death date and age|death year|death month|death day|birth year|birth month|birth day}}.
|-
| style="text-align:center;" | '''death_place'''
| The swimmer's place of death, if applicable.  Death place should be wiki-linked to the Wikipedia article about the town or city where the swimmer died.
|-
| style="text-align:center;" | '''height'''
| The swimmer's [[human height|height]]. If the swimmer is American, state measurements in [[foot (unit)|feet]] and [[inch]]es, otherwise state measurements in [[centimetre]]s or [[metre]]s. The infobox will automatically display the appropriate conversion within parentheses. The height parameter also accepts conversions done via the {{tl|Convert}} template, such as "{{tlx|convert|6|ft|2|in|m|abbr{{=}}on}}" or "{{tlx|convert|1.70|m|ftin|abbr{{=}}on}}". For additional documentation and examples, see {{section link|Template:Infobox sportsperson|height}}.
|-
| style="text-align:center;" | '''weight'''
| The swimmer's [[human body weight|weight]]. If the swimmer is American, state measurements in [[pound (mass)|pounds]], otherwise state measurements in [[kilogram]]s. The infobox will automatically display the appropriate conversion within parentheses. The weight parameter also accepts conversions done via the {{tl|Convert}} template, such as "{{tlx|convert|120|lb|kg|abbr{{=}}on}}" or "{{tlx|convert|72|kg|lb|abbr{{=}}on}}". For additional documentation and examples, see {{section link|Template:Infobox sportsperson|weight}}.
|-
| style="text-align:center;" | '''spouse'''
| The swimmer's spouse.
|-
| style="text-align:center;" | '''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>.
|-
! colspan="2" | Added parameters for swimmers
|-
| style="text-align:center;" | '''strokes'''
| The swimmer's primary competitive stroke.  If there is more than one stroke, list them alphabetically and separate them by commas.  Strokes should be wiki-linked to the relevant Wikipedia articles.
|-
| style="text-align:center;" | '''classification'''
| The swimmer's [[para-swimming classification|disability swimming classifications]].  For para-swimmers only.
|-
| style="text-align:center;" | '''club'''
| The name of the swimming club to which the swimmer belongs.
|-
| style="text-align:center;" | '''collegeteam'''
| The name of the college team to which the swimmer belongs or belonged.  The college team should be wiki-linked to the Wikipedia article about the college team or sports program.
|-
| style="text-align:center;" | '''coach'''
| The name of the swimmer's current coach, if the coach is notable per [[WP:N]] or otherwise noteworthy within the national or international swimming community.  The swimmer's coach may be wiki-linked ''if'' a Wikipedia article about the coach exists.
|-
! colspan="2" | Parameters for medal templates
|-
| style="text-align:center;" | '''medaltemplates'''
| All templates from the medal record infobox except {{tl|MedalTableTop}} and {{tl|MedalBottom}}.
Use the normal order (see the [[Template:Medal templates documentation|medal templates documentation]]):<br/>
<code><nowiki>{{MedalSport | Men's swimming}}</nowiki><br/>
<nowiki>{{MedalCountry | Sweden}}</nowiki><br/>
<nowiki>{{MedalCompetition | [[Swimming at the Summer Olympics|Olympic Games]]}}</nowiki><br/>
<nowiki>{{MedalCompetition | [[FINA World Aquatics Championships|World Championships (LC)]]}}</nowiki><br/>
<nowiki>{{MedalCompetition | [[FINA World Swimming Championships (25 m)|World Championships (SC)]]}}</nowiki><br/>
<nowiki>{{MedalCompetition | [[LEN European Aquatics Championships|European Championships (LC)]]}}</nowiki><br/>
<nowiki>{{MedalCompetition | [[Pan Pacific Swimming Championships|Pan Pacific Championships]]}}</nowiki><br/>
<nowiki>{{MedalGold | [[2008 Summer Olympics|2008 Beijing]] | [[Swimming at the 2008 Summer Olympics – Men's 100 metre freestyle|100 m freestyle]]}}</nowiki><br />
<nowiki>{{MedalSilver | 2008 Beijing | [[Swimming at the 2008 Summer Olympics – Men's 4 × 100 metre freestyle relay|4×100 m freestyle]]}}</nowiki><br />
<nowiki>{{MedalBronze | 2008 Beijing | [[Swimming at the 2008 Summer Olympics – Men's 100 metre butterfly|100 m butterfly]]}}</nowiki></code>
|-
| style="text-align:center;" | '''show-medals'''
| If "<code>show-medals=yes</code>", the medal table is displayed.  Otherwise, it is hidden and will only be shown if the "show" link is used.  It is recommended for swimmers with large numbers of medals that this parameter should be toggled "no" because of the disproportionate amount of article space the extended infobox will require.
|-
! colspan="2" | Modules
|-
| style="text-align:center;" | '''module'''<br />'''module2'''
| Used for embedding other infoboxes or templates: '''module''' displays above the ''Sport'' heading and '''module2''' displays below the medal templates.
|}

==Example==
The following example is taken from the Good Article for [[Dara Torres]], and employs most of the available optional parameters for a living swimmer.

{{Infobox swimmer
| name           = Dara Torres
| image          = Dara Torres 2crop.jpg
| image_size     =
| alt            = Color photo of smiling Torres in navy blue bathing suit with white stars, waving to crowd.
| caption        = ''Torres waves to crowd after winning silver medal in [[Swimming at the 2008 Summer Olympics – Women's 50 metre freestyle|50-meter freestyle]] at [[2008 Summer Olympics]].''
| full_name      = Dara Grace Torres
| nickname       = "DT"
| national_team  = {{USA}}
| birth_date     = {{Birth date and age|1967|4|15|mf=y}}
| birth_place    = [[Beverly Hills, California]]
| height         = 5 ft 11 in 
| weight         = 150 lb
| website        = {{URL|daratorres.com|DaraTorres.com}}
| strokes        = [[Butterfly stroke|Butterfly]], [[Freestyle swimming|freestyle]]
| club           = Culver City Swim Club
| collegeteam    = [[Florida Gators swimming and diving|University of Florida]]
| 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 4 × 100 metre freestyle relay|4×100 m freestyle]]}} 
{{MedalGold | [[1992 Summer Olympics|1992 Barcelona]] | [[Swimming at the 1992 Summer Olympics – Women's 4 × 100 metre freestyle relay|4×100 m freestyle]]}} 
{{MedalGold | [[2000 Summer Olympics|2000 Sydney]] | [[Swimming at the 2000 Summer Olympics – Women's 4 × 100 metre freestyle relay|4×100 m freestyle]]}} 
{{MedalGold | 2000 Sydney | [[Swimming at the 2000 Summer Olympics – Women's 4 × 100 metre medley relay|4×100 m medley]]}} 
{{MedalSilver | [[1988 Summer Olympics|1988 Seoul]] | [[Swimming at the 1988 Summer Olympics – Women's 4 × 100 metre medley relay|4×100 m medley]]}} 
{{MedalSilver | [[2008 Summer Olympics|2008 Beijing]] | [[Swimming at the 2008 Summer Olympics – Women's 50 metre freestyle|50 m freestyle]]}}
{{MedalSilver | 2008 Beijing | [[Swimming at the 2008 Summer Olympics – Women's 4 × 100 metre freestyle relay|4×100 m freestyle]]}}
{{MedalSilver | 2008 Beijing | [[Swimming at the 2008 Summer Olympics – Women's 4 × 100 metre medley relay|4×100 m medley]]}}
{{MedalBronze | 1988 Seoul | [[Swimming at the 1988 Summer Olympics – Women's 4 × 100 metre freestyle relay|4×100 m freestyle]]}} 
{{MedalBronze | 2000 Sydney | [[Swimming at the 2000 Summer Olympics – Women's 50 metre freestyle|50 m freestyle]]}} 
{{MedalBronze | 2000 Sydney | [[Swimming at the 2000 Summer Olympics – Women's 100 metre freestyle|100 m freestyle]]}} 
{{MedalBronze | 2000 Sydney | [[Swimming at the 2000 Summer Olympics – Women's 100 metre butterfly|100 m butterfly]]}}
{{MedalCompetition | [[FINA World Aquatics Championships|World Championships (LC)]]}}
{{MedalSilver | [[1986 World Aquatics Championships|1986 Madrid]]|[[Swimming at the 1986 World Aquatics Championships|4×100 m freestyle]]}}
{{MedalCompetition | [[Pan Pacific Swimming Championships|Pan Pacific Championships]]}}
{{MedalGold | [[1987 Pan Pacific Swimming Championships|1987 Brisbane]] | 100 m freestyle}}
{{MedalGold | 1987 Brisbane | 4×100 m freestyle}}
{{MedalGold | 1987 Brisbane | 4×100 m medley}}
{{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|4×100 m freestyle]]}}
}}

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox swimmer
| name           = Dara Torres
| image          = Dara Torres 2crop.jpg
| image_size     =
| alt            = Color photo of smiling Torres in navy blue bathing suit with white stars, waving to crowd.
| caption        = ''Torres waves to crowd after winning silver medal in [[Swimming at the 2008 Summer Olympics – Women's 50 metre freestyle|50-meter freestyle]] at [[2008 Summer Olympics]].''
| full_name      = Dara Grace Torres
| nickname       = "DT"
| national_team  = {{USA}}
| birth_date     = {{Birth date and age|1967|4|15|mf=y}}
| birth_place    = [[Beverly Hills, California]]
| height         = 5 ft 11 in 
| weight         = 150 lb
| website        = {{URL|daratorres.com|DaraTorres.com}}
| strokes        = [[Butterfly stroke|Butterfly]], [[Freestyle swimming|freestyle]]
| club           = Culver City Swim Club
| collegeteam    = [[Florida Gators swimming and diving|University of Florida]]
| 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 4 × 100 metre freestyle relay|4×100 m freestyle]]}} 
{{MedalGold | [[1992 Summer Olympics|1992 Barcelona]] | [[Swimming at the 1992 Summer Olympics – Women's 4 × 100 metre freestyle relay|4×100 m freestyle]]}} 
{{MedalGold | [[2000 Summer Olympics|2000 Sydney]] | [[Swimming at the 2000 Summer Olympics – Women's 4 × 100 metre freestyle relay|4×100 m freestyle]]}} 
{{MedalGold | 2000 Sydney | [[Swimming at the 2000 Summer Olympics – Women's 4 × 100 metre medley relay|4×100 m medley]]}} 
{{MedalSilver | [[1988 Summer Olympics|1988 Seoul]] | [[Swimming at the 1988 Summer Olympics – Women's 4 × 100 metre medley relay|4×100 m medley]]}} 
{{MedalSilver | [[2008 Summer Olympics|2008 Beijing]] | [[Swimming at the 2008 Summer Olympics – Women's 50 metre freestyle|50 m freestyle]]}}
{{MedalSilver | 2008 Beijing | [[Swimming at the 2008 Summer Olympics – Women's 4 × 100 metre freestyle relay|4×100 m freestyle]]}}
{{MedalSilver | 2008 Beijing | [[Swimming at the 2008 Summer Olympics – Women's 4 × 100 metre medley relay|4×100 m medley]]}}
{{MedalBronze | 1988 Seoul | [[Swimming at the 1988 Summer Olympics – Women's 4 × 100 metre freestyle relay|4×100 m freestyle]]}} 
{{MedalBronze | 2000 Sydney | [[Swimming at the 2000 Summer Olympics – Women's 50 metre freestyle|50 m freestyle]]}} 
{{MedalBronze | 2000 Sydney | [[Swimming at the 2000 Summer Olympics – Women's 100 metre freestyle|100 m freestyle]]}} 
{{MedalBronze | 2000 Sydney | [[Swimming at the 2000 Summer Olympics – Women's 100 metre butterfly|100 m butterfly]]}}
{{MedalCompetition | [[FINA World Aquatics Championships|World Championships (LC)]]}}
{{MedalSilver | [[1986 World Aquatics Championships|1986 Madrid]]|[[Swimming at the 1986 World Aquatics Championships|4×100 m freestyle]]}}
{{MedalCompetition | [[Pan Pacific Swimming Championships|Pan Pacific Championships]]}}
{{MedalGold | [[1987 Pan Pacific Swimming Championships|1987 Brisbane]] | 100 m freestyle}}
{{MedalGold | 1987 Brisbane | 4×100 m freestyle}}
{{MedalGold | 1987 Brisbane | 4×100 m medley}}
{{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|4×100 m freestyle]]}}
}}
</syntaxhighlight>
{{clear}}

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

== Tracking categories ==
* {{clc|Pages using Infobox swimmer with unknown parameters}}
* {{clc|Pages using Infobox swimmer with conflicting parameters}}
* {{clc|Pages using infobox swimmer with national team parameter}}
* {{clc|Pages using infobox swimmer with nationality parameter}}
* {{clc|Pages using infobox swimmer with USA nationality}}
* {{clc|Pages using infobox swimmer with show-medals enabled}}
* {{clc|No local image but image on Wikidata}} – Used by [[Template:Wikidata image]] to track articles where an infobox has no image but [[Wikidata]] has an image name. To exclude articles from this category, add an image or {{para|nocat_wdimage|yes}} to the infobox.

==Template data==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"child": {},
		"embed": {},
        "honorific_prefix": {},
		"name": {},
        "honorific_suffix": {},
		"image": {},
		"image_size": {},
		"imagesize": {},
		"alt": {},
		"caption": {},
		"native_name": {},
		"native_name_lang": {},
		"full_name": {},
		"fullname": {},
		"nickname": {},
		"nicknames": {},
		"nationality": {},
		"national_team": {},
		"birth_name": {},
		"birth_date": {},
		"birth_place": {},
		"death_date": {},
		"death_place": {},
		"height": {},
		"weight": {},
		"spouse": {},
		"website": {},
		"strokes": {},
		"classification": {},
		"club": {},
		"collegeteam": {},
		"coach": {},
		"module": {},
		"module2": {},
		"medaltemplates": {},
		"show-medals": {},
		"nocat_wdimage": {}
	}
}
</templatedata>

== See also ==
* [[Template:Infobox sportsperson]]

<includeonly>
<!-- CATEGORIES HERE, THANKS -->
{{Basepage subpage|
[[Category:Sportsperson infobox templates|Swimmer]]
[[Category:Swimming infobox templates|Swimmer]]
[[Category:Biographical templates usable as a module|Swimmer]]
[[Category:Infobox templates with module parameter|Swimmer]]
[[Category:Templates that add a tracking category|{{PAGENAME}}]]
[[Category:Swimmers]]
}}
</includeonly>