Template:Infobox swimmer/doc

Dara Torres
	Torres waves to crowd after winning silver medal in 50-meter freestyle at 2008 Summer Olympics.
Personal information
Full name	Dara Grace Torres
Nickname(s)	"DT"
National team	United States
Born	April 15, 1967 (age 57); Beverly Hills, California
Height	5 ft 11 in (180 cm)
Weight	150 lb (68 kg)
Website	DaraTorres.com
Sport
Sport	Swimming
Strokes	Butterfly, freestyle
Club	Culver City Swim Club
College team	University of Florida
Medal record
Women's swimming
Representing the United States
Olympic Games
World Championships (LC)
Pan Pacific Championships
Pan American Games

{{{name}}}
	[[File:{{{image}}}\|{{{image_size}}}\|alt={{{alt}}}\|upright=1.1]] {{{caption}}}
Personal information
Native name	{{{native_name}}}
Birth name	{{{birth_name}}}
Full name	{{{full_name}}}
Nickname(s)	{{{nickname}}}
National team	{{{national_team}}}
Born	{{{birth_date}}}; {{{birth_place}}}
Died	{{{death_date}}}; {{{death_place}}}
Height	{{{height}}}
Weight	{{{weight}}}
Website	{{{website}}}
Sport
Sport	Swimming
Strokes	{{{strokes}}}
Classifications	{{{classification}}}
Club	{{{club}}}
College team	{{{collegeteam}}}
Coach	{{{coach}}}
Medal record
	{{{medaltemplates}}}

This is a documentation subpage for Template:Infobox swimmer.
It may contain usage information, categories and other content that is not part of the original template page.

This template is a customized wrapper for {{Infobox sportsperson}}. Any field from {{Infobox sportsperson}} can work so long as it is added to this template first. It will also emit the same hCard microformat as {{Infobox sportsperson}}. Questions? Just ask on Template talk:Infobox sportsperson.

This template uses Lua:

Intended uses

This infobox template is intended to be used in articles about current and former competition 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

{{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    = 
| 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)", "X m (yyyy)", or "X ft Y in (yyyy)" -->
| weight         = <!-- "X kg (yyyy)" or "X lb (yyyy)" -->
| website        = 
| strokes        = 
| classification = <!-- Only for para-swimmers; omitted otherwise -->
| club           = 
| collegeteam    = 
| coach          = 
| medaltemplates = 
| show-medals    = <!-- "yes" to display, hidden by default -->
}}

Parameter instructions

Parameter	Description
name	The common name of the swimmer.
image	A photograph of the swimmer. Type the name of the image file without adding "`Image:`" or "`File:`" before it, nor wikilinking it.
image_size	The image size. Only use this parameter if the image is less than 220 pixels in width. If so, then indicate the image's respective width in pixels, like this: "`image_size=200`".
alt	Alternative text describing the image displayed for visually impaired readers.
caption	A brief caption for the image displayed.
native_name	The swimmer's name in his or her native language, if different than name.
native_name_lang	ISO 639-2 code, e.g., "fre" or "fra" for French. If more than one, use {{lang}} in `\|native_name=` instead.
birth_name	The birth name of the swimmer, if different than name.
full_name	The full name of the swimmer, if different than name and birth_name.
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.
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.
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, "`{{USA}}`", renders a 7-pixel U.S. flag and the words "United States".
birth_date	The swimmer's birth date. Use `{{Birth date and age\|yyyy\|mm\|dd}}` for living swimmers; use `{{Birth date\|yyyy\|mm\|dd}}` for deceased swimmers.
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.
death_date	The swimmer's death date, if applicable. Use `{{Death date and age\|death year\|death month\|death day\|birth year\|birth month\|birth day}}`.
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.
height	The swimmer's height. If the swimmer is American, state measurements in feet and inches, otherwise state measurements in centimetres or metres. The infobox will automatically display the appropriate conversion within parentheses. The height parameter also accepts conversions done via the {{Convert}} template, such as "`{{convert\|6\|ft\|2\|in\|m\|abbr=on}}`" or "`{{convert\|1.70\|m\|ftin\|abbr=on}}`". For additional documentation and examples, see Template:Infobox sportsperson § height.
weight	The swimmer's weight. If the swimmer is American, state measurements in pounds, otherwise state measurements in kilograms. The infobox will automatically display the appropriate conversion within parentheses. The weight parameter also accepts conversions done via the {{Convert}} template, such as "`{{convert\|120\|lb\|kg\|abbr=on}}`" or "`{{convert\|72\|kg\|lb\|abbr=on}}`". For additional documentation and examples, see Template:Infobox sportsperson § weight.
website	Official website only. Unofficial websites should be placed under `==External links==` in the body of the article. Use {{URL}} as in {{URL\|examplesite.com\|ExampleSite.com}}.
Added parameters for swimmers
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.
classification	The swimmer's disability swimming classifications. For para-swimmers only.
club	The name of the swimming club to which the swimmer belongs.
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.
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.
Parameters for medal templates
medaltemplates	All templates from the medal record infobox except {{MedalTableTop}} and {{MedalBottom}}. Use the normal order (see the medal templates documentation): {{MedalSport \| Men's swimming}} {{MedalCountry \| Sweden}} {{MedalCompetition \| [[Swimming at the Summer Olympics\|Olympic Games]]}} {{MedalCompetition \| [[FINA World Aquatics Championships\|World Championsips (LC)]]}} {{MedalCompetition \| [[FINA World Swimming Championships (25 m)\|World Championships (SC)]]}} {{MedalCompetition \| [[LEN European Aquatics Championships\|European Championships (LC)]]}} {{MedalCompetition \| [[Pan Pacific Swimming Championships\|Pan Pacific Championships]]}} {{MedalGold \| [[2008 Summer Olympics\|2008 Beijing]] \| [[Swimming at the 2008 Summer Olympics – Men's 100 metre freestyle\|100 m freestyle]]}} {{MedalSilver \| 2008 Beijing \| [[Swimming at the 2008 Summer Olympics – Men's 4 × 100 metre freestyle relay\|4×100 m freestyle]]}} {{MedalBronze \| 2008 Beijing \| [[Swimming at the 2008 Summer Olympics – Men's 100 metre butterfly\|100 m butterfly]]}}
show-medals	If "`show-medals=yes`", 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.

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     = 220
| 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]]}}
}}

Microformat

The HTML markup produced by this template includes an hCard microformat, which makes the person's details parsable by computers, either acting automatically to catalogue articles across Wikipedia or via a browser tool operated by a reader, to (for example) add the subject to an address book or database. For more information about the use of microformats on Wikipedia, please see the microformat project on English Wikipedia.

Sub-templates

Date-of-birth ("bday") information will only be included in the microformat if {{birth date}}, or {{birth date and age}} are used in the infobox. (Do not use these if the date is before 1583). Be cautious about using these if the person is still living, per WP:DOB.

To include a URL, use {{URL}}.

Please do not remove instances of these sub-templates.

Classes

hCard uses HTML classes including:

adr
agent
bday
birthplace
category
country-name
deathdate
deathplace
extended-address
family-name
fn (required)
given-name
honorific-prefix
honorific-suffix
label
locality
n
nickname
note
org
role
url
vcard

Please do not rename or remove these classes nor collapse nested elements which use them.

Tracking categories

via Infobox sportsperson

Category:No local image but image on Wikidata – Used by this and other infoboxes (via Template:Wikidata image) to track articles where the infobox has no image but Wikidata has an image name. To exclude articles from this category, update the infobox to display an image or add |nocat_wdimage=yes.