Template:Infobox swimmer/doc

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

{{{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}}}
Spouse(s)	{{{spouse}}}
Website	{{{website}}}
{{{module}}}
Sport
Sport	Swimming
Strokes	{{{strokes}}}
Classifications	{{{classification}}}
Club	{{{club}}}
College team	{{{collegeteam}}}
Coach	{{{coach}}}
Medal record {{{medaltemplates}}}
{{{module2}}}

{{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)" 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        = 
}}

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 their 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.
spouse	The swimmer's spouse.
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.
Modules
module 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.

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	(1967-04-15) April 15, 1967 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 1984 Los Angeles 4×100 m freestyle 1992 Barcelona 4×100 m freestyle 2000 Sydney 4×100 m freestyle 2000 Sydney 4×100 m medley 1988 Seoul 4×100 m medley 2008 Beijing 50 m freestyle 2008 Beijing 4×100 m freestyle 2008 Beijing 4×100 m medley 1988 Seoul 4×100 m freestyle 2000 Sydney 50 m freestyle 2000 Sydney 100 m freestyle 2000 Sydney 100 m butterfly World Championships (LC) 1986 Madrid 4×100 m freestyle Pan Pacific Championships 1987 Brisbane 100 m freestyle 1987 Brisbane 4×100 m freestyle 1987 Brisbane 4×100 m medley Pan American Games 1983 Caracas 4×100 m freestyle

{{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.

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

• Category:Pages using Infobox swimmer with unknown parameters (0)
• Category:Pages using infobox swimmer with national team parameter (2)
• Category:Pages using infobox swimmer with nationality parameter (2)
• Category:Pages using infobox swimmer with USA nationality (0)
• Category:Pages using infobox swimmer with show-medals enabled (0)

via Infobox sportsperson

• Category:Pages using deprecated image syntax (0) – Used by Module:InfoboxImage to track articles where an infobox uses image syntax in the format |image=[[File:Example.jpg]]. To exclude articles from this category, change it to |image=Example.jpg.
• Category:No local image but image on Wikidata (24) – 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 |nocat_wdimage=yes to the infobox.

See also

• Template:Infobox sportsperson

This parameter, "Honorific_Prefix" should be added for this template.

Template parameters

Parameter		Description	Type	Status
honorific_prefix	honorific_prefix	no description	Unknown	optional