This is a documentation subpage for Template:Sortname. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 53,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
- Usage
{{sortname|first|last|optional link target|optional sort key}}
Creates a wikilinked name that can be used in a sortable table (created with class="wikitable sortable").
- The default sort key is "last, first".
- The link label is "first last".
- The default link target is "first last"
The optional link target is useful when "first last" is a disambiguation page instead of the desired article, or when linking to a section of a page.
The optional sort key is useful in the case of special characters such as é.
- Optional parameters
|dab=disambiguator
- Wikilinks to "first last (disambiguator)".
(Note: ignored if optional link target is not blank.)
- Wikilinks to "first last (disambiguator)".
|nolink=1
- Suppresses wikilinking the name, useful for list entries which are likely to never have articles so shouldn't be redlinked.
(Note: optional link target ignored when "|nolink=1" used.)
- Suppresses wikilinking the name, useful for list entries which are likely to never have articles so shouldn't be redlinked.
Examples
# | What you type | What's generated |
---|---|---|
1 | {{sortname|first|last}}
|
<span data-sort-value="last, first">[[first last|first last]]</span> |
2 | {{sortname|first|last|nolink=1}}
|
<span data-sort-value="last, first">first last</span> |
3 | {{sortname|first|last|dab=disambiguator}}
|
<span data-sort-value="last, first">[[first last (disambiguator)|first last]]</span> |
4 | {{sortname|first|last|target}}
|
<span data-sort-value="last, first">[[target|first last]]</span> |
5 | {{sortname|first|last||sort}}
|
<span data-sort-value="sort">[[first last|first last]]</span> |
6 | {{sortname|first|last||sort|nolink=1}}
|
<span data-sort-value="sort">first last</span> |
7 | {{sortname|first|last|target|sort}}
|
<span data-sort-value="sort">[[target|first last]]</span> |
# | What you type | What's displayed | What's sorted | What's linked |
---|---|---|---|---|
1 | {{sortname|Tom|Jones}}
|
Tom Jones | Jones, Tom | Tom Jones |
2 | {{sortname|Tom|Jones|nolink=1}}
|
Tom Jones | Jones, Tom | (no link) |
3 | {{sortname|Tom|Jones|dab=singer}}
|
Tom Jones | Jones, Tom | Tom Jones (singer) |
4 | {{sortname|Tom|Jones|Tom Jones (singer)}}
|
Tom Jones | Jones, Tom | Tom Jones (singer) |
1 | {{sortname|Fábio|da Silva}}
|
Fábio da Silva | da Silva, Fábio | Fábio da Silva |
2 | {{sortname|Fábio|da Silva|nolink=1}}
|
Fábio da Silva | da Silva, Fábio | (no link) |
3 | {{sortname|Fábio|da Silva|Fábio Gomes da Silva}}
|
Fábio da Silva | da Silva, Fábio | Fábio Gomes da Silva |
4 | {{sortname|Fábio|da Silva||Silva, Fabio}}
|
Fábio da Silva | Silva, Fabio | Fábio da Silva |
5 | {{sortname|Fábio|da Silva||Silva, Fabio|nolink=1}}
|
Fábio da Silva | Silva, Fabio | (no link) |
6 | {{sortname|Fábio|da Silva|Fábio Gomes da Silva|Silva, Fabio}}
|
Fábio da Silva | Silva, Fabio | Fábio Gomes da Silva |
Things you might not expect
# | What you type | What's displayed | What's sorted | What's linked |
---|---|---|---|---|
- | [[Mark Evans]]
|
Mark Evans | Mark Evans | Mark Evans |
- | [[Mark Evans (general)|Mark Evans]]
|
Mark Evans | Mark Evans (general) | Mark Evans (general) |
1 | Sir {{sortname|Mark|Evans}}
|
Sir Mark Evans | Sir Evans, Mark | Mark Evans |
1 | {{sortname|Sir Mark|Evans}}
|
Sir Mark Evans | Evans, Sir Mark | Sir Mark Evans |
3 | {{sortname|Sir Mark|Evans|Mark Evans (general)}}
|
Sir Mark Evans | Evans, Sir Mark | Mark Evans (general) |
6 | {{sortname|Sir Mark|Evans|Mark Evans (general)|Evans, Mark}}
|
Sir Mark Evans | Evans, Mark | Mark Evans (general) |
1 | {{sortname|Fábio da|Silva}}
|
Fábio da Silva | Silva, Fábio da | Fábio da Silva |
2 | {{sortname|Fábio da|Silva|nolink=1}}
|
Fábio da Silva | Silva, Fábio da | (no link) |
3 | {{sortname|Fábio da|Silva|Fábio Gomes da Silva}}
|
Fábio da Silva | Silva, Fábio da | Fábio Gomes da Silva |
4 | {{sortname|Fábio da|Silva||Silva, Fabio}}
|
Fábio da Silva | Silva, Fabio | Fábio da Silva |
5 | {{sortname|Fábio da|Silva||Silva, Fabio|nolink=1}}
|
Fábio da Silva | Silva, Fabio | (no link) |
6 | {{sortname|Fábio da|Silva|Fábio Gomes da Silva|Silva, Fabio}}
|
Fábio da Silva | Silva, Fabio | Fábio Gomes da Silva |
Note
To link to a section within the page in which the template appears, encode the number sign:
{{Sortname|Examples||#Examples}}
- gives: Examples
and for an inline Interlanguage link the initial colon must be encoded as %3A
{{Sortname|Hanning|Schröder|%3Ade:Hanning Schröder}}
- gives: Hanning Schröder
Microformat
See also
- Help:Sorting#Specifying a sort key for a cell
- {{sort}} – see talk for central sorting talk
- {{Date table sorting}} – for using dates in sortable tables
- {{Number table sorting}} – for using alphabetic sort mode for numbers in sortable tables
- {{Last word}}