→Flag icons: NPOV |
→Parameters: Remove further misleading instructions, as there is no consensus on this matter |
||
Line 57: | Line 57: | ||
* <code>'''hidenote=y'''</code> to suppress display of the above-table note about flags, e.g. when there are not flags in the table, or several such tables are being used in series and the first already has the note. |
* <code>'''hidenote=y'''</code> to suppress display of the above-table note about flags, e.g. when there are not flags in the table, or several such tables are being used in series and the first already has the note. |
||
* <code>'''nohead'''</code> to rename or suppress the "No." heading (e.g. to replace it with "<code>&nbsp;"</code> to blank it out when it isn't used |
* <code>'''nohead'''</code> to rename or suppress the "No." heading (e.g. to replace it with "<code>&nbsp;"</code> to blank it out when it isn't used |
||
* <code>'''nathead=Nat.'''</code> to have a nationality heading appear (it is suppressed by default |
* <code>'''nathead=Nat.'''</code> to have a nationality heading appear (it is suppressed by default). Another value can be given, e.g. {{para|nathead|State}}. |
||
* <code>'''poshead'''</code> to suppress display of the "Position" heading with "<code>&nbsp;"</code>, when this column isn't being used; or use it to change "Position" to "Pos.", "Role", etc. |
* <code>'''poshead'''</code> to suppress display of the "Position" heading with "<code>&nbsp;"</code>, when this column isn't being used; or use it to change "Position" to "Pos.", "Role", etc. |
||
Line 63: | Line 63: | ||
* <code>'''name'''</code> (or <code>'''1'''</code>) The player's name, the only required parameter. If the value is unassigned as of this writing, you can simply put "[unassigned]", "[vacant]" or the like, to indicate a vacant position. Do not add anything to the name here (citations go in the {{para|ref}} parameter, and notes go in the {{para|note}} parameter. |
* <code>'''name'''</code> (or <code>'''1'''</code>) The player's name, the only required parameter. If the value is unassigned as of this writing, you can simply put "[unassigned]", "[vacant]" or the like, to indicate a vacant position. Do not add anything to the name here (citations go in the {{para|ref}} parameter, and notes go in the {{para|note}} parameter. |
||
* <code>'''num'''</code> (or <code>'''no'''</code>): The shirt number of the player, if they have one. If the player's number is not known, or unassigned, then you can use the <code>–</code> character instead, or simply omit it. If omitted for all entries, use the {{para|nohead|&nbsp;}} parameter in {{tlx|football squad start}} and {{tlx|football squad mid}} to suppress the "No." heading. |
* <code>'''num'''</code> (or <code>'''no'''</code>): The shirt number of the player, if they have one. If the player's number is not known, or unassigned, then you can use the <code>–</code> character instead, or simply omit it. If omitted for all entries, use the {{para|nohead|&nbsp;}} parameter in {{tlx|football squad start}} and {{tlx|football squad mid}} to suppress the "No." heading. |
||
* <code>'''nat'''</code>: The player's {{em|sporting}} nationality (the country that the player represents in international football), which may have nothing to do with citizenship or birth place. |
* <code>'''nat'''</code>: The player's {{em|sporting}} nationality (the country that the player represents in international football), which may have nothing to do with citizenship or birth place. Use the name of the country, or its 3-letter [[List of IOC country codes|IOC country code]], rather than an adjective (e.g. "Spain" instead of "Spanish"). If used, also use the {{para|nathead|Nat.}} parameter in {{tlx|football squad start}} and {{tlx|football squad mid}} to enable the "Nat." heading above the icons. |
||
* <code>'''pos'''</code>: The position in which the player plays. If omitted for all entries, use the {{para|poshead|&nbsp;}} parameter in {{tlx|football squad start}} and {{tlx|football squad mid}} to suppress the "Pos." heading. You can use any of the four options below for the position, and they'll be linked automatically: |
* <code>'''pos'''</code>: The position in which the player plays. If omitted for all entries, use the {{para|poshead|&nbsp;}} parameter in {{tlx|football squad start}} and {{tlx|football squad mid}} to suppress the "Pos." heading. You can use any of the four options below for the position, and they'll be linked automatically: |
||
*# <code>'''GK'''</code> for [[Goalkeeper (association football)|goalkeeper]] |
*# <code>'''GK'''</code> for [[Goalkeeper (association football)|goalkeeper]] |
Revision as of 11:15, 25 June 2014
Usage
The {{football squad player}}
and related templates are used to display the players on an association football (soccer) squad (team, club), in a consistent format:
{{football squad start |team=[[Real Madrid F.C.|Real Madrid]] |hidenote=y}} {{football squad player |num=9 |pos=FW |name=[[Aleksandar Đurić]] |note=captain}} {{football squad player |num=1 |pos=GK |name=[[Iker Casillas]]}} {{football squad player |num=25 |pos=G⁠K |name=[[Joe Hart]]}} ... {{football squad mid |team= }} {{football squad player |num=13 |pos=MF |name=[[Park Ji-sung]]}} {{football squad player |num=3 |pos=DF |name=[[Gerard Pique]]}} {{football squad player |num=10 |pos=FW |name=[[Robin Van Persie]]}} ... {{football squad end}}
|
|
In this case, the captain is listed first, followed by other members by alphabetical order of family name; in other cases, you might prefer to list them by shirt number, position or some other criteria.
The templates can technically be used for other sports, but note that the pre-set values of the |pos=
parameter automatically link to association football articles by default.
Syntax
Most such tables are split into two vertical columns. For these, you can use the {{football squad start}}
, {{football squad mid}}
, and {{football squad end}}
templates for layout, and then use the {{football squad player}}
template repeatedly within that layout:
{{football squad start}} <!-- For help using the below template, please see [[Template talk:Football squad player]] --> {{football squad player |name=Player Name |num=shirt number |nat=team nationality (if not already clear in context) |pos=position or role played |note=optional parenthetical note}} {{football squad player |name=Player Name |num=shirt number |nat=team nationality (if not already clear in context) |pos=position or role played |note=optional parenthetical note}} ... {{football squad mid}} {{football squad player |name=Player Name |num=shirt number |nat=team nationality (if not already clear in context) |pos=position or role played |note=optional parenthetical note}} ... {{football squad end}}
For a single-column layout, you can omit {{football squad mid}}
.
Flag icons
Whether the WP:MOSICON guideline's rule against the use of flag icons to indicate a player's birth place or individual legal citizenship, rather than sporting nationality as a team member, should be changed is the subject of an ongoing discussion as of June 2014.
Parameters
The parameters of {{football squad start}}
and {{football squad mid}}
are:
team
to specific the team name (which may be wikilinked)hidenote=y
to suppress display of the above-table note about flags, e.g. when there are not flags in the table, or several such tables are being used in series and the first already has the note.nohead
to rename or suppress the "No." heading (e.g. to replace it with " "
to blank it out when it isn't usednathead=Nat.
to have a nationality heading appear (it is suppressed by default). Another value can be given, e.g.|nathead=State
.poshead
to suppress display of the "Position" heading with " "
, when this column isn't being used; or use it to change "Position" to "Pos.", "Role", etc.
The parameters of {{football squad player}}
are:
name
(or1
) The player's name, the only required parameter. If the value is unassigned as of this writing, you can simply put "[unassigned]", "[vacant]" or the like, to indicate a vacant position. Do not add anything to the name here (citations go in the|ref=
parameter, and notes go in the|note=
parameter.num
(orno
): The shirt number of the player, if they have one. If the player's number is not known, or unassigned, then you can use the–
character instead, or simply omit it. If omitted for all entries, use the|nohead=
parameter in{{football squad start}}
and{{football squad mid}}
to suppress the "No." heading.nat
: The player's sporting nationality (the country that the player represents in international football), which may have nothing to do with citizenship or birth place. Use the name of the country, or its 3-letter IOC country code, rather than an adjective (e.g. "Spain" instead of "Spanish"). If used, also use the|nathead=Nat.
parameter in{{football squad start}}
and{{football squad mid}}
to enable the "Nat." heading above the icons.pos
: The position in which the player plays. If omitted for all entries, use the|poshead=
parameter in{{football squad start}}
and{{football squad mid}}
to suppress the "Pos." heading. You can use any of the four options below for the position, and they'll be linked automatically:GK
for goalkeeperDF
for defender (including sweeper, centre-, full- and wing-backMF
for midfielderFW
for forward or striker (incl. winger and second striker)- some other value; one example would be using
G⁠K
to replace second and subsequent occurrences of "GK" with a "G" then a zero-width non-breaking space in it then a "K", so that the template does not redundantly link it; another case could be to use[[Association football positions#Attacking midfield|AM]]
if there is some reason to be more specific, or a similar link to another position in another sport if the template is being used for non-soccer purposes.
ref
: A reference footnote, which appears immediately after the player name. It must be in the form|ref=<ref ...>...</ref>
. This keeps the reference citation code from being confused with part of the player's name in metadata.note
(orother
): This is an optional parameter. You can add any related info to this parameter, like specifying captain, vice-captain, whether the player is on loan, etc. It will show additional info in the parentheses (round brackets) after the player name.
Examples
For example, the following code:
{{Football squad start}} {{football squad player | no=1 | nat=Spain | pos=GK | name=[[Iker Casillas]]}} {{football squad player | no=3 | nat=Spain | pos=DF | name=[[Gerard Pique]]}} {{football squad player | no=9 | nat=Singapore | pos=FW | name=[[Aleksandar Đurić]] | other=team captain}} {{football squad mid}} {{football squad player | no=10 | nat=Netherlands| pos=FW | name=[[Robin Van Persie]]}} {{football squad player | no=13 | nat=South Korea| pos=MF | name=[[Park Ji-sung]]}} {{football squad player | no=25 | nat=England | pos=GK | name=[[Joe Hart]]}} {{football squad end}}
Produces this table:
Note: Flags indicate national team as defined under FIFA eligibility rules. Players may hold more than one non-FIFA nationality.
|
|
Shortented template names
In order to make easier the work of writing new squads, some alternative, shorter, names has been designed. So, you may now use {{Fs start}}, {{Fs mid}}, {{Fs player}}, {{Fs end}} and {{Fs blank column}} as alternative templates, using the same equivalent syntax of the other ones.
Microformat
The HTML markup produced by this template includes an hCard microformat, which makes the person's name 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. For more information about the use of microformats on Wikipedia, please see the microformat project.
To include a URL, use {{URL}}.
Classes
The hCard in this template uses at least some of these HTML classes:
- agent
- family-name
- fn (required)
- given-name
- honorific-prefix
- honorific-suffix
- n
- nickname
- org
- url
- vcard
Please do not rename or remove these classes nor collapse nested elements which use them.