View source for Template:Sortname/doc

{{Documentation subpage}}
{{Ombox|type=content|text=This template is '''deprecated'''. Table sort keys should now be defined using the <code>data-sort-value</code> attribute, like so: <code><nowiki>| data-sort-value="Doe, John" | John Doe</nowiki></code>. Please see {{Section link|WP:SORT|Specifying a sort key for a cell}} for details.}}

;Usage:<code><nowiki>{{</nowiki>sortname|''first''|''last''|''optional link target''|''optional sort key''}}</code>

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
: <code>|dab=''disambiguator''</code>
:: Wikilinks to "''first last (disambiguator)''".<br>(Note: ignored if ''optional link target'' is not blank.)
: <code>|nolink=1</code>
::Suppresses wikilinking the name, useful for list entries which are likely to never have articles so shouldn't be redlinked.<br>(Note: ''optional link target'' ignored when "|nolink=1" used.)

==Examples==
{| class=wikitable
! # || What you type || What's generated
|-
| 1 || <code><nowiki>{{sortname|first|last}}</nowiki></code>
| <nowiki><span data-sort-value="last, first">[[first last|first last]]</span></nowiki>
|-
| 2 || <code><nowiki>{{sortname|first|last|nolink=1}}</nowiki></code>
| <nowiki><span data-sort-value="last, first">first last</span></nowiki>
|-
| 3 || <code><nowiki>{{sortname|first|last|dab=disambiguator}}</nowiki></code>
| <nowiki><span data-sort-value="last, first">[[first last (disambiguator)|first last]]</span></nowiki>
|-
| 4 || <code><nowiki>{{sortname|first|last|target}}</nowiki></code>
| <nowiki><span data-sort-value="last, first">[[target|first last]]</span></nowiki>
|-
| 5 || <code><nowiki>{{sortname|first|last||sort}}</nowiki></code>
| <nowiki><span data-sort-value="sort">[[first last|first last]]</span></nowiki>
|-
| 6 || <code><nowiki>{{sortname|first|last||sort|nolink=1}}</nowiki></code>
| <nowiki><span data-sort-value="sort">first last</span></nowiki>
|-
| 7 || <code><nowiki>{{sortname|first|last|target|sort}}</nowiki></code>
| <nowiki><span data-sort-value="sort">[[target|first last]]</span></nowiki>
|}

{| class=wikitable
! # || What you type || What's displayed || What's sorted || What's linked
|-
| 1 || <code><nowiki>{{sortname|Tom|Jones}}</nowiki></code>
| {{sortname|Tom|Jones}} <!-- [[Tom Jones]] -->
| Jones, Tom
| [[Tom Jones]] <!-- [[Tom Jones]] -->
|-
| 2 || <code><nowiki>{{sortname|Tom|Jones|nolink=1}}</nowiki></code>
| {{sortname|Tom|Jones|nolink=1}} <!-- Tom Jones -->
| Jones, Tom
| <small>''(no link)''</small>
|-
| 3 || <code><nowiki>{{sortname|Tom|Jones|dab=singer}}</nowiki></code>
| {{sortname|Tom|Jones|dab=singer}} <!-- [[Tom Jones (singer)]] -->
| Jones, Tom
| [[Tom Jones (singer)]] <!-- [[Tom Jones (singer)]] -->
|-
| 4 || <code><nowiki>{{sortname|Tom|Jones|Tom Jones (singer)}}</nowiki></code>
| {{sortname|Tom|Jones|Tom Jones (singer)}} <!-- [[Tom Jones (singer)]] -->
| Jones, Tom
| [[Tom Jones (singer)]] <!-- [[Tom Jones (singer)]] -->
|-
| 
|-
| 1 || <code><nowiki>{{sortname|Fábio|da Silva}}</nowiki></code>
| {{sortname|Fábio|da Silva}} <!-- [[Fábio da Silva]] -->
| da Silva, Fábio
| [[Fábio da Silva]] <!-- [[Fábio da Silva]] -->
|-
| 2 || <code><nowiki>{{sortname|Fábio|da Silva|nolink=1}}</nowiki></code>
| {{sortname|Fábio|da Silva|nolink=1}} <!-- Fábio da Silva -->
| da Silva, Fábio
| <small>''(no link)''</small>
|-
| 3 || <code><nowiki>{{sortname|Fábio|da Silva|Fábio Gomes da Silva}}</nowiki></code>
| {{sortname|Fábio|da Silva|Fábio Gomes da Silva}} <!-- displays [[Fábio da Silva]] -->
| da Silva, Fábio
| [[Fábio Gomes da Silva]] <!-- [[Fábio Gomes da Silva]] -->
|-
| 4 || <code><nowiki>{{sortname|Fábio|da Silva||Silva, Fabio}}</nowiki></code>
| {{sortname|Fábio|da Silva||Silva, Fabio}}
| Silva, Fabio
| [[Fábio da Silva]]
|-
| 5 || <code><nowiki>{{sortname|Fábio|da Silva||Silva, Fabio|nolink=1}}</nowiki></code>
| {{sortname|Fábio|da Silva||Silva, Fabio|nolink=1}}
| Silva, Fabio
| <small>''(no link)''</small>
|-
| 6 || <code><nowiki>{{sortname|Fábio|da Silva|Fábio Gomes da Silva|Silva, Fabio}}</nowiki></code>
| {{sortname|Fábio|da Silva|Fábio Gomes da Silva|Silva, Fabio}}
| Silva, Fabio
| [[Fábio Gomes da Silva]]
|}

;Things you might not expect
{| class=wikitable
! # || What you type || What's displayed || What's sorted || What's linked
|-
| - || <code><nowiki>[[Mark Evans]]</nowiki></code>
| [[Mark Evans]] <!-- [[Mark Evans]] -->
| Mark Evans
| [[Mark Evans]] <!-- [[Mark Evans]] -->
|-
| - || <code><nowiki>[[Mark Evans (general)|Mark Evans]]</nowiki></code>
| [[Mark Evans (general)|Mark Evans]]
| Mark Evans (general)
| [[Mark Evans (general)]]
|-
|
|-
| 1 || <code><nowiki>Sir {{sortname|Mark|Evans}}</nowiki></code>
| Sir {{sortname|Mark|Evans}}
| Sir Evans, Mark
| [[Mark Evans]]
|-
| 1 || <code><nowiki>{{sortname|Sir Mark|Evans}}</nowiki></code>
| {{sortname|Sir Mark|Evans}}
| Evans, Sir Mark
| [[Sir Mark Evans]]
|-
| 3 || <code><nowiki>{{sortname|Sir Mark|Evans|Mark Evans (general)}}</nowiki></code>
| {{sortname|Sir Mark|Evans|Mark Evans (general)}}
| Evans, Sir Mark
| [[Mark Evans (general)]]
|-
| 6 || <code><nowiki>{{sortname|Sir Mark|Evans|Mark Evans (general)|Evans, Mark}}</nowiki></code>
| {{sortname|Sir Mark|Evans|Mark Evans (general)|Evans, Mark}}
| Evans, Mark
| [[Mark Evans (general)]]
|-
| 
|-
| 1 || <code><nowiki>{{sortname|Fábio da|Silva}}</nowiki></code>
| {{sortname|Fábio da|Silva}} <!-- [[Fábio da Silva]] -->
| Silva, Fábio da
| [[Fábio da Silva]] <!-- [[Fábio da Silva]] -->
|-
| 2 || <code><nowiki>{{sortname|Fábio da|Silva|nolink=1}}</nowiki></code>
| {{sortname|Fábio da|Silva|nolink=1}} <!-- Fábio da Silva -->
| Silva, Fábio da
| <small>''(no link)''</small>
|-
| 3 || <code><nowiki>{{sortname|Fábio da|Silva|Fábio Gomes da Silva}}</nowiki></code>
| {{sortname|Fábio da|Silva|Fábio Gomes da Silva}} <!-- displays [[Fábio da Silva]] -->
| Silva, Fábio da
| [[Fábio Gomes da Silva]] <!-- [[Fábio Gomes da Silva]] -->
|-
| 4 || <code><nowiki>{{sortname|Fábio da|Silva||Silva, Fabio}}</nowiki></code>
| {{sortname|Fábio da|Silva||Silva, Fabio}}
| Silva, Fabio
| [[Fábio da Silva]]
|-
| 5 || <code><nowiki>{{sortname|Fábio da|Silva||Silva, Fabio|nolink=1}}</nowiki></code>
| {{sortname|Fábio da|Silva||Silva, Fabio|nolink=1}}
| Silva, Fabio
| <small>''(no link)''</small>
|-
| 6 || <code><nowiki>{{sortname|Fábio da|Silva|Fábio Gomes da Silva|Silva, Fabio}}</nowiki></code>
| {{sortname|Fábio da|Silva|Fábio Gomes da Silva|Silva, Fabio}}
| 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]]:

<pre>
{{Sortname|Examples||&amp;#35;Examples}}
</pre>

:gives: {{Sortname|Examples||&#35;Examples}}

==Microformat==
{{UF-hcard-name}}

==See also==
*{{tl|sort}}&nbsp;– see talk for central sorting talk
*{{tl|Date table sorting}}&nbsp; – for using dates in sortable tables
*{{tl|Number table sorting}}&nbsp; – for using alphabetic sort mode for numbers in sortable tables
*{{tl|sortfrac}}&nbsp;– for sorting numbers which can contain fractions
*{{tl|Last word}}

<includeonly>{{sandbox other||
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Sorting templates|Sortname]]
}}</includeonly>