imported>Nigej: /* Usage */ add

2021-12-06T18:15:27Z

Usage: add

New page

{{Documentation subpage}}

{{Lua|Module:Infobox|Module:InfoboxImage|Module:Wikidata|Module:Check for unknown parameters}}
{{Uses Wikidata|P18}}

== Usage ==
{{Parameter names example | name | image | image_size | alt | caption | birth_date | birth_place | death_date | death_place | Sport country | Nickname | Professional | High ranking | Official maximums | Best finish | Ranking wins | Minor wins | Other wins | World champ | medals | medals-expand }}

<pre style="overflow: auto;">
{{Infobox snooker player
| name =
| honorific_suffix =
| image =
| image_size =
| alt =
| caption =
| birth_date = 
| birth_place =
| death_date = 
| death_place =
| Sport country =
| Nickname =
| Professional =
| High ranking =
| Official maximums =
| Best finish =
| Ranking wins =
| Minor wins =
| Other wins =
| World champ =
| medals-expand = 
| medals = 
}}
</pre>
{{clear}}

* '''All information in the infobox should also be in the article prose''', in some (usually ''more'' not less detailed) form, '''and should be sourced there.''' Please do ''not'' put reference citations in the infobox nor add information to the infobox before adding it the main article text. Infoboxes are convenient ''summaries'' of important stats from articles; they are ''not'' mini-articles unto themselves and should not be treated as such.
* {{para|honorific_suffix}} is for things like <code><nowiki>|honorific_suffix = [[Order of the British Empire|OBE]]</nowiki></code> – honorifics of serious significance that are attached to the name in formal address, such as knighthoods and non-honorary doctorates; do not use it for routine things like "[[Bachelor of arts|BA]]". It is not necessary to use the {{tlx|post-nominals}} template in this parameter; doing so will make the output smaller (that template is intended for inline use in the article lead, and uses small-caps style).
* Images must be specified in a format like {{para|image|<nowiki /><var>ImageName.ext</var>}} – leaving out the <code><nowiki>[[...]]</nowiki></code> bracketing markup causes a table layout error in Internet Explorer. The caption is handled as a separate template parameter, {{para|caption}}, not a <code><nowiki>[[File:...]]</nowiki></code> parameter.
* The official rankings for the current season are available [https://wst.tv/rankings here]. '''Do not''' use ''provisional rankings'' in the infobox, although they can be included (if noted as provisional) in the main text of the article. Wait until the official rankings are released for the next season (or when the season has just finished, use the rankings from [http://www.global-snooker.com/world-professional-snooker-ranking-lists.asp here] as they are usually correct, and the official rankings take a long time before they are released) before editing the data in the infobox; also wait until the parameter name is '''changed''' to reflect the current season and the '''article''' for the next seasons rankings are made. Make sure '''all''' articles that contain this infobox are updated; this should be done in one long editing session when the infobox parameter is updated, to ensure that none of them are left out. This will probably be co-ordinated from [[Wikipedia:WikiProject Snooker|WikiProject Snooker]].
* Fill in what tournaments a player has won in the actual article, in a separate section from the rest, rather than in the infobox. Only list the ''number of events'' that player has won, in the infobox's '''{{para|Ranking wins}}''' and '''{{para|Other wins}}''' parameters, apart from the '''{{para|World champ}}''' parameter, where you can list the years. Please don't add amateur, pro-am, team and non-snooker titles to the {{para|Other wins}} parameter.
* The '''{{para|Minor wins}}''' should be used for minor-ranking tournaments.
* If a player has won some tournaments before and after the 1973/1974 season, list them according to [[List of snooker tournaments]].
* The '''{{para|Official maximums}}''' parameter is number of official maximum breaks achieved during the player's professional career.
* The '''{{para|Best finish}}''' parameter is for listing the best performance of players who have not won a ranking tournament. Generally use Runner-up, Semi-final, Quarter-final, Last 16, Last 24 or Last 32, followed by the number of times they have reached this stage, eg "(x1)". These achievements should be mentioned in the prose. Do not update until the player has "finished" in a tournament. This parameter is not used for players who have never reached the Last 32 stage.
* The '''{{para|Sport country}}''' parameter is used here to reflect the ''sporting nationality'' of players as competitors. These generally match [[List of FIFA country codes|those of FIFA]]. It is ''not the player's legal citizenship'' (which will often be the same but need not be). In snooker, as in association football, rugby, etc., players usually represent [[Sovereignty|sovereign]] [[nation-states]], but may represent non-sovereign sub-national entities, such as the constituent countries of the UK (England, Wales, Scotland and Northern Ireland) for sporting purposes. It is not just Wikipedia that does this, as can be seen at the official [[International Billiards and Snooker Federation]] website [http://www.ibsf.info/past-champions.shtml here]. The [[BBC]] have also adopted this usage as can be seen [http://news.bbc.co.uk/sport1/hi/other_sports/snooker/results/default.stm here]. The Wikipedia usage reflects the real-life usage within the sport. This is a ''snooker player infobox'', not a general biography box and its purpose is to express information about the player in relation to their sport. Finally, this parameter should not be used at all for snooker personages not notable as pro or top-flight amateur players, but for another role such as referee, announcer, etc.
* '''Flag templates''': Please use flags properly, per [[Wikipedia:Manual of Style (icons)]]:
:* Flag templates are ''only'' used for the '''{{para|Sport country}}''' parameter in the infobox (and ''should'' be used there, with the excepetion of Northern Ireland, for which see below). Format: {{Para|Sport country|{<nowiki />{flag{{!}}<var>CountryName</var><nowiki>}}</nowiki>}} or {{Para|Sport country|{<nowiki />{<var>CountryCode</var><nowiki>}}</nowiki>}}
:* Flag templates are ''never'' used for birth/death places (per [[Wikipedia:Manual of Style (icons)]]), as this improperly implies citizenship/nationality that simply may not apply (many people are born, and even die, abroad).
:* Emphatically do '''not''' use the [[Flag of Northern Ireland|Ulster banner]], {{tlx|flag|Northern Ireland}} or {{tl|NIR}}: {{NIR}} for "Sport country" in snooker player infoboxes. This flag does not officially or civically represent N.I. any longer and hasn't in years. Meanwhile (much more seriously) use of the flag to indicate someone's nationality, in any sense, is a major [[WP:NPOV|point of view]] problem in a Wikipedia article. The flag is a major Unionist political rallying symbol; using it in infoboxes will, for many readers, imply a political position not a nationality, much less a sporting nationality. Technically, the proper infobox usage for people from N.I. would be {{para|Sport country|<nowiki>{{Flagicon|United Kingdom}} [[Northern Ireland]]</nowiki>}}. Irish Nationalists are equally offended by this, however, making that, too, a PoV-pushing issue. Just don't use a flag for Northern Irish snooker player infoboxes. Therefore simply use {{para|Sport country|[[Northern Ireland]]}}.
:* The Ulster Banner ''is'' appropriate for use in ''sports statistics'' tables, such as tournament results, because the flag, curiously, ''does'' have official status in various sport federations as the flag of N.I. for sporting purposes, and it carries no political connotations when used in this context. So, for example, Alex Higgins should have no flag in his infobox, but in ranking tournament results would have the Ulster Banner.

==Current ranking==
The infobox also contains a "Current ranking" field. Data for this field is not stored in the player's infobox but in a separate file: [[Template:Infobox snooker player/rankings]].

==Century breaks==
The infobox also contains a "Century breaks" field. Data for this field is not stored in the player's infobox but in a separate file: [[Template:Infobox snooker player/century breaks]].

== Example ==
{{Infobox snooker player
| name = Ronnie O'Sullivan
| image = Stephen Maguire, Ronnie O’Sullivan, and Michaela Tabb at German Masters Snooker Final (DerHexer) 2012-02-05 05 cropped.jpg
| caption = O'Sullivan in 2012
| birth_date = {{birth date and age|1975|12|5|df=yes}}
| birth_place = [[Wordsley]], [[West Midlands (county)|West Midlands]]
| Sport country = {{flag|England}}
| Nickname = The Rocket<br />The Essex Exocet<br />The Magician
| Professional = 1992–
| High ranking = [[List of world number one snooker players|1]] (3 years)
| Official maximums = 10
| Ranking wins = 22
| Other wins = 22
| World champ = [[2001 World Snooker Championship|2001]], [[2004 World Snooker Championship|2004]], [[2008 World Snooker Championship|2008]]
}}

<pre style="overflow: auto;">
{{Infobox snooker player
| name = Ronnie O'Sullivan
| image = Stephen Maguire, Ronnie O’Sullivan, and Michaela Tabb at German Masters Snooker Final (DerHexer) 2012-02-05 05 cropped.jpg
| caption = O'Sullivan in 2012
| birth_date = {{birth date and age|1975|12|5|df=yes}}
| birth_place = [[Wordsley]], [[West Midlands (county)|West Midlands]]
| Sport country = {{flag|England}}
| Nickname = The Rocket<br />The Essex Exocet<br />The Magician
| Professional = 1992–
| High ranking = [[List of world number one snooker players|1]] (3 years)
| Official maximums = 10
| Ranking wins = 22
| Other wins = 22
| World champ = [[2001 World Snooker Championship|2001]], [[2004 World Snooker Championship|2004]], [[2008 World Snooker Championship|2008]]
}}
</pre>
{{clear}}

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

== Tracking category ==
* {{clc|Pages using Infobox snooker player with unknown parameters}}

<includeonly>{{sandbox other||

[[Category:Sportsperson infobox templates|Snooker player]]
[[Category:Snooker infobox templates|Player]]
[[Category:Infobox templates using Wikidata]]
[[Category:Templates that add a tracking category]]
}}</includeonly>

Template:Infobox snooker player/doc - Revision history

imported>Nigej: /* Usage */ add