Template:Sort
Revision as of 08:45, 16 September 2022 by Gwyneth Llewelyn (talk | contribs) (Adding documentation)
Template documentationThis documentation is 
transcluded from Template:Sort/doc. (Edit | history)
Note to editors: Please don't categorize this template by editing it directly. Instead, place the category in its documentation page, in its "includeonly" section.
transcluded from Template:Sort/doc. (Edit | history)Note to editors: Please don't categorize this template by editing it directly. Instead, place the category in its documentation page, in its "includeonly" section.
 |
This template should be avoided. Table sort keys are best defined using the data-sort-value attribute, like so: | data-sort-value="Doe, John" | John Doe. Please see WP:SORT § Specifying a sort key for a cell for details. |
 |
The original code was quite different than what is currently on Wikipedia |
This template is for manually adjusting sorting order in sortable tables by specified sortkeys.
- Usage
{{Sort | 1 = {{{sort value}}} | 2 = {{{displayed value}}} }}→ Warning: Default sort key "{{{sort value}}}" overrides earlier default sort key "Sort".
The first parameter is the sortkey; the second parameter is the wikitext of what has to be displayed. By default, this is the sortkey with link brackets:
{{Sort | 1 = {{{displayed value}}} }}→ Warning: Default sort key "{{{displayed value}}}" overrides earlier default sort key "{{{sort value}}}".
A table using this template should use it in all rows.
This template works by adding a hidden sort value, which replaces the value of the visible text for sorting purposes. The HTML output looks like: <span data-sort-value="sortvalue">[[displayed value]]</span>.
Example
|{{Sort|Brothers Karamazov|[[The Brothers Karamazov]]}}
- Sorting by numerical value, date, etc.
- See Help:Sorting#Numerical sorting problems and meta:Help:Sorting#Sort modes
- Equal rank
- If you simply code as the second parameter an indicator that two items are equally ranked, e.g. "4=", the template interpreter will treat this as an additional parameter (i.e. parameter 4, which it will then not use). You must explicitly code this as parameter 2:
{{Sort|4|2=4=}}
See also
- Template:Sortname (backlinks edit)—for using names in sortable tables (using "last name, first name" as default sort key)
- Template:Date table sorting (backlinks edit)—for using dates in sortable tables
- Template:Number table sorting (backlinks edit)—for using alphabetic sort mode for numbers in sortable tables
- Help:Sorting
- meta:Help:Sorting