Template:Sort/doc

This is a documentation subpage for Template:Sort.
It may contain usage information, categories and other content that is not part of the original template page.

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.

This template is used on approximately 119,000 pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:Sortkey

This template is for manually adjusting sorting order in sortable tables by specified sortkeys.

Usage: {{Sort | 1 = {{{sort value}}} | 2 = {{{displayed value}}} }} → {{{displayed value}}}

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}}} }} → [[{{{displayed 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=}}

Example

See also