rm POV, state issue in neutral terms |
→Examples: rm POV (nothing is "deprecated" because the issue is not resolved) and introduction of an example which shouldn't be used (I believe there is consensus that club articles should not include a list of players transferred during the season) |
||
Line 50: | Line 50: | ||
=== Examples === |
=== Examples === |
||
For example, the following code: |
|||
The following code (for a table of players, one not an Argentine national, who were on an Argentine team but transferred to other teams): |
|||
<nowiki>{{ |
<nowiki>{{Football squad start}}</nowiki> |
||
<nowiki>{{football squad player |pos=DF |name=[[Matías Caruzzo]] |other=to [[Universidad de Chile]]}}</nowiki> |
|||
<nowiki>{{football squad player |pos=MF |name=[[Damián Escudero]] |other=to [[EC Vitória]]}}</nowiki> |
|||
<nowiki>{{football squad player |pos=M⁠F |name=[[Jesús Méndez]] |other=to [[Rosario Central]]}}</nowiki> |
|||
<nowiki>{{football squad player |pos=M&#8288;F |name=[[Ribair Rodríguez]], of [[Uruguay]] |other=to [[Santos Laguna]]}}</nowiki> |
|||
<nowiki>{{football squad player |pos=FW |name=[[Franco Cángele]] |other=to [[Sanica Boru Elazığspor|Elazığspor]]}}</nowiki> |
|||
<nowiki>{{football squad player |pos=F&#8288;W |name=[[Nicolás Blandi]] |other=to [[San Lorenzo de Almagro]] |ref=<ref>{{citation| title=Title of Work |last=Lastname |first=Firstname |year=2014}}</ref>}}</nowiki> |
|||
⚫ | |||
⚫ | |||
{{football squad start |hidenote=y |nohead= }} |
|||
{{football squad player |pos=DF |name=[[Matías Caruzzo]] |other=to [[Universidad de Chile]]}} |
|||
{{football squad player |pos=MF |name=[[Damián Escudero]] |other=to [[EC Vitória]]}} |
|||
{{football squad player |pos=M⁠F |name=[[Jesús Méndez]] |other=to [[Rosario Central]]}} |
|||
{{football squad player |pos=M⁠F |name=[[Ribair Rodríguez]], of [[Uruguay]] |other=to [[Santos Laguna]]}} |
|||
{{football squad player |pos=FW |name=[[Franco Cángele]] |other=to [[Sanica Boru Elazığspor|Elazığspor]]}} |
|||
{{football squad player |pos=F⁠W |name=[[Nicolás Blandi]] |other=to [[San Lorenzo de Almagro]] |ref=<ref>{{citation| title=Title of Work |last=Lastname |first=Firstname |year=2014}}</ref>}} |
|||
{{football squad end}} |
|||
Note that the last example includes a reference footnote with the "<code>ref=</code>" parameter, which inserts citation in the article's references section, e.g. this sample data in the example: {{reflist}} |
|||
If flag icons are thought to be genuinely useful in the context (here, the start of a listing of FIFA World Cup players from national teams of different nations), the following code: |
|||
<nowiki>{{football squad start |nohead=Nat. |poshead=&nbsp;}}</nowiki> |
|||
<nowiki>{{football squad player |nat=Togo |name=[[Jean-Paul Abalo]] |other=captain}}</nowiki> |
|||
<nowiki>{{football squad player |nat=Argentina |name=[[Roberto Abbondanzieri]]}}</nowiki> |
|||
<nowiki>{{football squad player |nat=France |name=[[Éric Abidal]] |other=also 2009}}</nowiki> |
|||
<nowiki>{{football squad player |nat=Angola |name=[[Marco Abreu]]}}</nowiki> |
|||
<nowiki>{{football squad end}}</nowiki> |
|||
produces this table: |
|||
{{football squad start |nohead=Nat. |poshead= }} |
|||
{{football squad player |nat=Togo |name=[[Jean-Paul Abalo]] |other=captain}} |
|||
{{football squad player |nat=Argentina |name=[[Roberto Abbondanzieri]]}} |
|||
{{football squad player |nat=France |name=[[Éric Abidal]] |other=also 2009}} |
|||
{{football squad player |nat=Angola |name=[[Marco Abreu]]}} |
|||
{{football squad end}} |
|||
{{strongbad|Deprecated example}} – This table improperly uses flag icons to indicate the original nationality (individual citizenship) of a partial list of members of Real Madrid F.C. of Spain: |
|||
<nowiki>{{Football squad start |team=[[Real Madrid F.C.|Real Madrid]]}}</nowiki> |
|||
<nowiki>{{football squad player | no=1 | nat=Spain | pos=GK | name=[[Iker Casillas]]}}</nowiki> |
<nowiki>{{football squad player | no=1 | nat=Spain | pos=GK | name=[[Iker Casillas]]}}</nowiki> |
||
<nowiki>{{football squad player | no=3 | nat=Spain | pos=DF | name=[[Gerard Pique]]}}</nowiki> |
<nowiki>{{football squad player | no=3 | nat=Spain | pos=DF | name=[[Gerard Pique]]}}</nowiki> |
||
<nowiki>{{football squad player | no=9 | nat=Singapore | pos=FW | name=[[Aleksandar Đurić]] | other=captain}}</nowiki> |
<nowiki>{{football squad player | no=9 | nat=Singapore | pos=FW | name=[[Aleksandar Đurić]] | other=team captain}}</nowiki> |
||
<nowiki>{{football squad mid |
<nowiki>{{football squad mid}}</nowiki> |
||
<nowiki>{{football squad player | no=10 | nat=Netherlands| pos= |
<nowiki>{{football squad player | no=10 | nat=Netherlands| pos=FW | name=[[Robin Van Persie]]}}</nowiki> |
||
<nowiki>{{football squad player | no=13 | nat=South Korea| pos=MF | name=[[Park Ji-sung]]}}</nowiki> |
<nowiki>{{football squad player | no=13 | nat=South Korea| pos=MF | name=[[Park Ji-sung]]}}</nowiki> |
||
<nowiki>{{football squad player | no=25 | nat=England | pos= |
<nowiki>{{football squad player | no=25 | nat=England | pos=GK | name=[[Joe Hart]]}}</nowiki> |
||
<nowiki>{{football squad end}}</nowiki> |
<nowiki>{{football squad end}}</nowiki> |
||
⚫ | |||
⚫ | |||
producing this {{strongbad|deprecated}} table, which violates [[MOS:ICONS]]: |
|||
{{ |
{{Football squad start}} |
||
{{football squad player | no=1 | nat=Spain | pos=GK | name=[[Iker Casillas]]}} |
{{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=3 | nat=Spain | pos=DF | name=[[Gerard Pique]]}} |
||
{{football squad player | no=9 | nat=Singapore | pos=FW | name=[[Aleksandar Đurić]] | other=captain}} |
{{football squad player | no=9 | nat=Singapore | pos=FW | name=[[Aleksandar Đurić]] | other=team captain}} |
||
{{football squad mid |
{{football squad mid}} |
||
{{football squad player | no=10 | nat=Netherlands| pos= |
{{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=13 | nat=South Korea| pos=MF | name=[[Park Ji-sung]]}} |
||
{{football squad player | no=25 | nat=England | pos= |
{{football squad player | no=25 | nat=England | pos=GK | name=[[Joe Hart]]}} |
||
{{football squad end}} |
{{football squad end}} |
||
Revision as of 08:43, 25 June 2014
Usage
This template is used to display a football (soccer) player squad in a standard format.
Syntax
Most squads are split into two vertical columns. For these, you can use the {{Football squad start}}, {{Football squad mid}} and {{Football squad end}} templates to help with the layouting, and then use this template repeatedly within them:
{{Football squad start}} <!-- For help using the below template, please see [[Template talk:Football squad player]] --> {{Football squad player|no=#SHIRT_NUMBER|nat=#NATIONALITY|pos=#POS_OR_ROLE|name=#PLAYER_NAME}} {{Football squad player|no=#SHIRT_NUMBER|nat=#NATIONALITY|pos=#POS_OR_ROLE|name=#PLAYER_NAME|other=#OTHER_RELATED_INFO}} ... {{Football squad mid}} {{Football squad player|no=11|nat=ITA|pos=FW|name=[[Gioacchini Simone]]}} ... {{Football squad end}}
Alternatively, if you just want a single column, you can use {{football squad blank column}} to fill in a blank right hand column.
{{football squad start}} {{Football squad player|no=#SHIRT_NUMBER|nat=#NATIONALITY|pos=#POS_OR_ROLE|name=#PLAYER_NAME}} ... {{football squad blank column}} {{Football squad end}}
Flag icons
The use of flag icons in this template (and similar formatting) to indicate a player's individual citizenship, rather than sporting nationality as a team member is subject to ongoing controversy as of June 2014.
Parameters
The parameters of {{football squad start}}
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 used, or to replace it with "Nat." when shirt numbers are not being given but sporting nationality flag icons are being used.poshead
to suppress display of the "Pos." heading with " "
, when this column isn't being used.
The parameters of {{football squad player}}
are:
no
: 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}}
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. Include the only where relevant and not redundant in the context of the article. Do not include at all in below-international contexts. Use the name of the country, or its 3-letter IOC country code, rather than an adjective (e.g. "Spain" instead of "Spanish"). If shirt numbers (|no=
) are omitted for all entries, but|nat=
is given for one or more of them, use the|nohead=Nat.
parameter in{{Football squad start}}
to change the "No." heading to "Nat."pos
: The position in which the player plays. If omitted for all entries, use the|poshead=
parameter in{{Football squad start}}
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.
name
: The player's name.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.other
: 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.