Template:Sortname/doc
![]() | 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 57,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}}
Alternative version of {{sort}} tailored to the wikilinked names of persons, to 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
[edit]# | 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
[edit]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
[edit]The HTML markup produced by this template includes an hCard microformat, which makes the person's name parsable by computers, either acting automatically to catalogue articles across Wikipedia or via a browser tool operated by a reader, to (for example) add the subject to an address book. For more information about the use of microformats on Wikipedia, please see the microformat project.
To include a URL, use {{URL}}.
Classes
[edit]The hCard in this template uses at least some of these HTML classes:
- agent
- family-name
- fn (required)
- given-name
- honorific-prefix
- honorific-suffix
- n
- nickname
- org
- url
- vcard
Please do not rename or remove these classes nor collapse nested elements which use them.
See also
[edit]- 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}}
No description.
Parameter | Description | Type | Status | |
---|---|---|---|---|
First Name | 1 | no description
| Unknown | required |
Last Name | 2 | no description
| Unknown | required |
Optional Link Target | 3 | no description
| Page name | optional |
Optional Sort Key | 4 | no description
| Unknown | optional |
Disambiguator (no brackets) | dab | no description
| Unknown | optional |
No Link | nolink | Type "1" for no wikilink to appear
| Unknown | optional |
sort | sort | no description | Unknown | optional |
last | last | no description | Unknown | optional |
first | first | no description | Unknown | optional |
link | link | no description | Unknown | optional |