Template:Infobox swimmer/doc
 | 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[change source]
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[change source]
| [[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
| |||
{{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[change source]
| 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): |
| 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[change source]
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[change source]
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[change source]
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[change source]
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[change source]
- Category:Pages using infobox swimmer with nationality parameter
- Category:Pages using infobox swimmer with USA nationality
- Category:Pages using infobox swimmer with national team parameter
- Category:Pages using infobox swimmer with show-medals
- Category:Pages using Infobox swimmer with unknown parameters
- 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.
See also[change source]