This is a documentation subpage for Template:Sports roster. It may contain usage information, categories and other content that is not part of the original template page. |
This template uses Lua: |
{{sports roster}} and {{sports roster/entry}} are used to generate detailed roster tables and roster navbox footers depending on the value of |format=
. By having a single template generate both formats, the lists of players and coaches in both templates stay in sync, and editors do not need to update the roster in multiple places.
Usage
editThe main template, {{sports roster}} generates a table or navbox with the roster. The entry template, {{sports roster/entry}}, is used to generate the rows in the table, or names in the list. The syntax used by {{sports roster/entry}} is the same, or similar to, the NBA and WNBA player templates ({{player2}} and {{playerW}}.
Parameter | Remarks |
---|---|
template_name |
The name of the template containing the roster, usually the same as {{subst:PAGENAME}}
|
format |
Either roster or navbox
|
style |
The name of a style submodule. Currently only WNBA and default are supported.
|
players |
A list of players formatted using the {{Sports roster/entry}} template. |
head_coach |
The name of the head coach formatted using the {{Sports roster/entry}} template. |
asst_coach |
The names of the assistant coaches formatted using the {{Sports roster/entry}} template. |
player_development |
The name of the player development coach formatted using the {{Sports roster/entry}} template. |
ath_train |
The name of the athletic trainer formatted using the {{Sports roster/entry}} template. |
assistant_trainer |
The name of the assistant trainer formatted using the {{Sports roster/entry}} template. |
str_cond |
The name of the strength and conditioning coach formatted using the {{Sports roster/entry}} template. |
Additional WNBA style parameters | |
team |
The full name of the WNBA team |
rosterteam |
Not necessary (the name of the used in the roster url at the WNBA website) |
otherlegend |
An entry appearing after the default legend entries |
otherlegend2 |
An entry appearing after the default legend entries |
otherlegend3 |
An entry appearing after the default legend entries |
notes |
Notes appearing after the legend |
Additional default style parameters | |
legend |
Text to appear in the legend after the coaches |
notes |
Notes appearing after the legend |
above |
Table title text shown when |format=roster
|
abovestyle |
CSS styling for the above table cell |
headingstyle |
CSS styling for the heading table cells when |format=roster
|
footer |
Table footer text shown when |format=roster
|
title |
Navbox title text shown when |format=navbox
|
titlestyle |
CSS styling for the navbox title |
below |
Navbox footer text shown when |format=navbox
|
belowstyle |
CSS styling for the navbox below |
Parameter | Remarks |
---|---|
Player or coach name and school parameters | |
first last |
The first and last name of the player or coach (typically the only name parameters needed) |
dab |
Disambiguation for linking the name (e.g., basketball or born in 1970) |
name |
For Chinese names where first and last do not provide the desired result
|
link |
For more complicated article linking, the title of the article about the player or coach |
alt |
For more complicated cases where the rendered name is not as desired |
nolink=1 |
To disable linking entirely |
school or college |
The school or college last attended by the player or coach (uses {{college}} for linking). For coaches with degrees from more than one college, use the institution where the (first) bachelor's degree was earned. |
from |
Where the player or coach transferred from if school or college is not typically (e.g., international players) |
Player parameters | |
num |
The player's uniform number (do not use for coaches) |
pos |
The player's position (do not use for coaches) |
ft in lbs |
The player's height and weight in feet, inches, and pounds (do not use for coaches) |
DOB |
The player's date of birth in YYYY-MM-DD format |
inj |
Set to y if the player is injured
|
note |
Note to put after the player's name (e.g., C for captain). |
WNBA usage
editThe standard usage for a WNBA roster starts by creating a main roster template, which will contain the list of players, coaches, and trainers. To demonstrate the usage, here is the source code for Template:Washington Mystics roster as of May 19, 2020.
{{sports roster
| template_name = Washington Mystics roster
| style = WNBA
| format = {{{1|}}}
| state = {{{state|}}}
| team = Washington Mystics
| players =
<!-- list of players -->
{{sports roster/entry | num = | first = Jaylyn | last = Agnew | pos = | ft = 5 | in = 11 | lbs = | DOB = 1997-07-21 | yrs = R | college =Creighton | nat = USA}}
{{sports roster/entry | num = 7 | first = Ariel | last = Atkins | pos = G | ft = 5 | in = 11 | lbs = 167 | DOB = 1996-07-30 | yrs = 2 | college = Texas | nat = USA}}
{{sports roster/entry | num = 31 | first = Tina | last = Charles | dab = basketball | pos = C | ft = 6 | in = 4 | lbs = 192 | DOB = 1988-12-05 | yrs = 10 | college = Connecticut | nat = USA}}
{{sports roster/entry | num = 9 | first = Natasha | last = Cloud | pos = G | ft = 5 | in = 9 | lbs = 160 | DOB= 1992-02-22 | yrs= 5 | college = Saint Joseph's | nat = USA}}
{{sports roster/entry | num = 11 | first = Elena | last = Delle Donne | pos = G/F | ft = 6 | in = 5 | lbs = 187 | DOB = 1989-09-05 | yrs = 7 | college = Delaware | nat = USA}}
{{sports roster/entry | num = 21 | first = Tianna | last = Hawkins| pos = F | ft = 6 | in = 3 | lbs = 186 | DOB = 1991-03-02 | yrs = 6 | college = Maryland | nat = USA}}
{{sports roster/entry | num = 2 | first = Myisha | last = Hines-Allen | pos = F | ft = 6 | in = 1 | lbs = 200 | DOB = 1996-05-30 | yrs = 2 | college = Louisville | nat = USA}}
{{sports roster/entry | num = 5 | first = Kiara | last = Leslie | pos = G | ft = 6 | in = 0 | lbs = 175 | DOB = 1995-12-06 | yrs = R | college = NC State | nat = USA}}
{{sports roster/entry | num = 33 | first = Emma | last = Meesseman | pos = F | ft = 6 | in = 4 | lbs = 191 | DOB = 1993-05-13 | yrs = 6 | from = Belgium | nat = BEL}}
{{sports roster/entry | num = 5 | first = Leilani | last = Mitchell | pos = G | ft = 5 | in = 5 | lbs = 138 | DOB = 1985-06-15 | yrs = 11 | from = Utah | nat = USA}}
{{sports roster/entry | num = 23 | first = Aerial | last = Powers | pos = F/G | ft = 5 | in = 9 | lbs = 159 | DOB = 1994-07-17 | yrs = 4 | college = Michigan State | nat = USA}}
{{sports roster/entry | num = 30 | first = LaToya | last = Sanders | pos = F/C | ft = 6 | in = 2 | lbs = 170 | DOB = 1986-09-11 | yrs = 7 | college = North Carolina | nat = USA}}
{{sports roster/entry | num = | first = Sug | last = Sutton | pos = G | ft = 5 | in = 8 | lbs = 130 | DOB = 1998-12-17 | yrs = R | college = Texas | nat = USA}}
<!-- end list of players -->
| head_coach =
{{sports roster/entry|nat=USA| first =Mike|last=Thibault|college=[[St. Martin's University|St. Martin's]]}}
| asst_coach =
{{sports roster/entry|nat=USA| first =Eric|last=Thibault|nolink=1|college=Missouri}}
{{sports roster/entry|nat=USA| first =Ashja|last=Jones|nolink=1|college=Connecticut}}
| ath_train =
{{sports roster/entry|nat=USA| first =Chalisa|last=Fonza|nolink=1|college=Western Illinois}}
| str_cond =
{{sports roster/entry|last=''Vacant''|nolink=1}}
}}
Since the value for |format=
is not specified, it shows the default detailed table view of the roster. Now, the source code for Template:Washington Mystics roster is very simple, since it just transcludes Template:Washington Mystics roster with a different value for |format=
{{Indiana Fever roster|footer|state={{{state|autocollapse}}}}}
Default usage
editThe standard usage is to start by creating a main roster template, which will contain the list of players, coaches, and trainers.
{{sports roster
| template_name = {{subst:PAGENAME}}
| style = default<!-- or another supported style -->
| format = {{{format|}}}
| state = {{{state|}}}
<!-- Table format styling -->
| above = <!-- Title to show in table format -->
| abovestyle = <!-- CSS styling for above -->
| headingstyle = <!-- CSS styling for the headings in table format -->
| footer = <!-- Text to show at the foot of the table in table format -->
<!-- Footer format styling -->
| title = <!-- Title to show in footer format -->
| titlestyle = <!-- CSS styling for title -->
| below = <!-- Text to show at the bottom of the navbox in footer format -->
| belowstyle = <!-- CSS styling for below -->
| players =
<!-- list of players -->
{{sports roster/entry | num = 1 | first = First1 | last = Last1 | pos = F | ft = 6 | in = 3 | lbs = 190 | DOB = YYYY-MM-DD | yrs = 2 | college = College1 | nat = Country1 }}
{{sports roster/entry | num = 2 | first = First2 | last = Last2 | link = Link2 | pos = G | ft = 5 | in = 7 | lbs = 143 | DOB = YYYY-MM-DD | yrs = 2 | college = College2 | nat = Country2}}
{{sports roster/entry | num = 3 | first = First3 | last = Last3 | nolink=1 | pos = C | ft = 6 | in = 11 | lbs = 220 | DOB = YYYY-MM-DD | yrs = 3 | college = College3 | nat = Country3 }}
<!-- ... -->
<!-- end list of players -->
| head_coach =
{{sports roster/entry|nat=USA|first=Firstname|last=Lastname|college=Collegename}}
| asst_coach =
{{sports roster/entry|nat=USA|first=Firstname|last=Lastname|nolink=1|college=Collegename}}
| ath_train =
{{sports roster/entry|nat=USA|first=Firstname|last=Lastname|nolink=1|college=[[Collegename]]}}
| str_cond =
{{sports roster/entry|nat=USA|first=Firstname|last=Lastname|nolink=1|college=}}
}}
See also
edit- {{NBA roster header}}
- {{NBA roster footer}}
- {{Player2}}
- {{Basketball roster header}}, {{Basketball roster footer}}, and {{Player3}}
- {{Basketball roster start}}, {{Basketball roster mid}}, {{Basketball roster end}}, and {{Basketball roster player}}