Template:Sortable medal image documentation
This template is for including medal symbols in sporting event result tables, while preserving the ability for sort.
Contents
Template series
The first group of templates show medal images while giving a table sort of 01, 02 or 03, respectively.
{{Gold1}}= <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">
{{Silver2}}= <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">
{{Bronze3}}= <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">
The second group of templates are show medal images with display text of either Gold, Silver, Bronze. These also give a table sort of 01, 02 or 03, respectively.
{{Gold medal}}= <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127."> Gold{{Silver medal}}= <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127."> Silver{{Bronze medal}}= <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127."> Bronze
Usage
Simply insert the template where you would like to see the symbol. No parameters are required.
Parameters
The link parameter can be used to pass a link to an article to these templates.
Example:
{{gold1|link=article name}}
It defaults to null.
Sorting
These templates use 01, 02 and 03 as the gold, silver, and bronze sort value, respectively. Sorting will operate numerically unless the column also contains any non-numeric text, in which case a text sort may sometimes occur (e.g. "10" is before "3").
To get the desired sort results for other values it may be necessary to use the data-sort-type="..." and data-sort-value="..." attributes. Placing a data-sort-type="number" attribute in the header cell will force a numeric sort. Adding a data-sort-value="..." attribute to a data cell will override the value.
A commonly used but now-deprecated technique is to use the {{hs}} or {{sort}} templates to specify appropriate sort keys to be inserted as hidden text in front of the displayed values. For example, {{hs|99}}DQ and {{sort|99|DQ}} both display "DQ" but sort using "99 DQ". A text sort still occurs, but the desired results can be achieved using carefully selected hidden values. Sometimes leading zeros or other tricks may be needed.
See Help:Sorting#Configuring the sorting for additional details.
Examples
Simple case
When all ranks are single digit numbers, the templates can be used directly in place of the ranks.
The following markup:
{| class="wikitable sortable" style="text-align:center"
! Rank !! Place
|-
| {{Gold1}} || First
|-
| {{Silver2}} || Second
|-
| {{Bronze3}} || Third
|-
| 4 || Fourth
|-
| 5 || Fifth
|-
| 6 || Sixth
|-
| 7 || Seventh
|-
| 8 || Eighth
|}
...will display as:
| Rank | Place |
|---|---|
| <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127."> |
First |
| <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127."> |
Second |
| <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127."> |
Third |
| 4 | Fourth |
| 5 | Fifth |
| 6 | Sixth |
| 7 | Seventh |
| 8 | Eighth |
Handling two-digit rankings, blank, or special values
When the rankings contain two-digit rankings, blank, or special values, additional markup may be needed to trigger numeric sorting and/or to explicitly set equivalent sort values. The preferred method is to use the data-sort-type="..." and data-sort-value="..." attributes. Placing a data-sort-type="number" attribute in the header cell will force a numeric sort order. Adding a data-sort-value="..." attribute to a data cell will override the value.
The following markup:
{| class="wikitable sortable" style="text-align:center"
! data-sort-type="number" | Rank !! Place !! Bad Sort !! Older Sort Style
|-
| {{Gold1}} || First || 1 || {{Gold1}}
|-
| {{Silver2}} || Second || 2 || {{Silver2}}
|-
| {{Bronze3}} || Third || 3 || {{Bronze3}}
|-
| 4* || Fourth || 4* || {{Sort|04|4*}}
|-
| 5 || Fifth || 5 || {{Sort|05|5}}
|-
| 10 || Tenth || 10 || 10
|-
| 11 || Eleventh || 11 || 11
|-
| 20 || Twentieth || 20 || 20
|-
| 50 || Fiftieth || 50 || 50
|-
| data-sort-value="96"|NM || No mark || NM || {{Sort|96|NM}}
|-
| data-sort-value="97"|DQ || Disqualified || DQ || {{Sort|97|DQ}}
|-
| data-sort-value="98"|– || Dash || – || {{Hs|98}}–
|-
| data-sort-value="99"| || Empty || || {{Hs|99}}
|}
...will display as:
| Rank | Place | Bad Sort | Older Sort Style |
|---|---|---|---|
| <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127."> |
First | 1 | <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">
|
| <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127."> |
Second | 2 | <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">
|
| <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127."> |
Third | 3 | <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">
|
| 4* | Fourth | 4* | <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">4* |
| 5 | Fifth | 5 | <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">5 |
| 10 | Tenth | 10 | 10 |
| 11 | Eleventh | 11 | 11 |
| 20 | Twentieth | 20 | 20 |
| 50 | Fiftieth | 50 | 50 |
| NM | No mark | NM | <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">NM |
| DQ | Disqualified | DQ | <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127.">DQ |
| – | Dash | – | <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127." style="display:none;">– |
| Empty | <span data-sort-value="Lua error: Internal error: The interpreter exited with status 127." style="display:none;"> |
As demonstrated in the rightmost column, the {{sort}} and {{hs}} templates can also be used to resolve sorting problems, but this methodology is deprecated.
Deprecated templates
The below templates have had their functionality merged into the main templates, as bad sorting is never a useful feature.
- Template:Goca (backlinks edit)
- Template:Sica (backlinks edit)
- Template:Brca (backlinks edit)
- Template:Gold01 (backlinks edit)
- Template:Silver02 (backlinks edit)
- Template:Bronze03 (backlinks edit)
See also
- Template:Sort (backlinks edit) — for using names in sortable tables
- Template:Won (backlinks edit) — for using an alternative way to specify awards
- Template:Olympic Gold medal (backlinks edit) — for an alternative Olympic Gold metal icon
- Template:Olympic Silver medal (backlinks edit) — for an alternative Olympic Silver metal icon
- Template:Olympic Bronze medal (backlinks edit) — for an alternative Olympic Bronze metal icon
- m:Help:Sorting
