Login
Login

template:Sortname/doc#Note

{{Documentation subpage}}

{{#ifeq:{{SUBPAGENAME}}|sandbox||{{High-use}}}}

{{lua|Module:Sort}}

;Usage:{{sortname|first|last|optional link target|optional sort key}}

Alternative version of {{tl|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.)

: |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.)

Examples

class=wikitable

! #

What you typeWhat's generated
1{{sortname|first|last}}

| first last

2{{sortname|first|last|nolink=1}}

| first last

3{{sortname|first|last|dab=disambiguator}}

| first last

4{{sortname|first|last|target}}

| first last

5{{sortname|first|lastsort}}

| first last

6{{sortname|first|lastsort|nolink=1}}

| first last

7{{sortname|first|last|target|sort}}

| first last

class=wikitable

! #

What you typeWhat's displayedWhat's sortedWhat's linked
1{{sortname|Tom|Jones}}

| {{sortname|Tom|Jones}}

| Jones, Tom

| Tom Jones

2{{sortname|Tom|Jones|nolink=1}}

| {{sortname|Tom|Jones|nolink=1}}

| Jones, Tom

| (no link)

3{{sortname|Tom|Jones|dab=singer}}

| {{sortname|Tom|Jones|dab=singer}}

| Jones, Tom

| Tom Jones (singer)

4{{sortname|Tom|Jones|Tom Jones (singer)}}

| {{sortname|Tom|Jones|Tom Jones (singer)}}

| Jones, Tom

| Tom Jones (singer)

1{{sortname|Fábio|da Silva}}

| {{sortname|Fábio|da Silva}}

| da Silva, Fábio

| Fábio da Silva

2{{sortname|Fábio|da Silva|nolink=1}}

| {{sortname|Fábio|da Silva|nolink=1}}

| da Silva, Fábio

| (no link)

3{{sortname|Fábio|da Silva|Fábio Gomes da Silva}}

| {{sortname|Fábio|da Silva|Fábio Gomes da Silva}}

| da Silva, Fábio

| Fábio Gomes da Silva

4{{sortname|Fábio|da SilvaSilva, Fabio}}

| {{sortname|Fábio|da Silva

Silva, Fabio}}

| Silva, Fabio

| Fábio da Silva

5{{sortname|Fábio|da SilvaSilva, Fabio|nolink=1}}

| {{sortname|Fábio|da Silva

Silva, Fabio|nolink=1}}

| Silva, Fabio

| (no link)

6{{sortname|Fábio|da Silva|Fábio Gomes da Silva|Silva, Fabio}}

| {{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 typeWhat's displayedWhat's sortedWhat's linked
-Mark Evans

| Mark Evans

| Mark Evans

| Mark Evans

-Mark Evans

| Mark Evans

| Mark Evans (general)

| Mark Evans (general)

1Sir {{sortname|Mark|Evans}}

| Sir {{sortname|Mark|Evans}}

| Sir Evans, Mark

| Mark Evans

1{{sortname|Sir Mark|Evans}}

| {{sortname|Sir Mark|Evans}}

| Evans, Sir Mark

| Sir Mark Evans

3{{sortname|Sir Mark|Evans|Mark Evans (general)}}

| {{sortname|Sir Mark|Evans|Mark Evans (general)}}

| Evans, Sir Mark

| Mark Evans (general)

6{{sortname|Sir Mark|Evans|Mark Evans (general)|Evans, Mark}}

| {{sortname|Sir Mark|Evans|Mark Evans (general)|Evans, Mark}}

| Evans, Mark

| Mark Evans (general)

1{{sortname|Fábio da|Silva}}

| {{sortname|Fábio da|Silva}}

| Silva, Fábio da

| Fábio da Silva

2{{sortname|Fábio da|Silva|nolink=1}}

| {{sortname|Fábio da|Silva|nolink=1}}

| Silva, Fábio da

| (no link)

3{{sortname|Fábio da|Silva|Fábio Gomes da Silva}}

| {{sortname|Fábio da|Silva|Fábio Gomes da Silva}}

| Silva, Fábio da

| Fábio Gomes da Silva

4{{sortname|Fábio da|SilvaSilva, Fabio}}

| {{sortname|Fábio da|Silva

Silva, Fabio}}

| Silva, Fabio

| Fábio da Silva

5{{sortname|Fábio da|SilvaSilva, Fabio|nolink=1}}

| {{sortname|Fábio da|Silva

Silva, has Fabio|nolink=1}}

| Silva, Fabio

| (no link)

6{{sortname|Fábio da|Silva|Fábio Gomes da Silva|Silva, Fabio}}

| {{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:



{{Sortname|Examples||#Examples}}

:gives: {{Sortname|Examples||#Examples}}

and for an inline Interlanguage link the initial colon must be encoded as %3A



{{Sortname|Hanning|Schröder|%3Ade:Hanning Schröder}}

:gives: {{Sortname|Hanning|Schröder|%3Ade:Hanning Schröder}}

Microformat

{{UF-hcard-name}}

See also

  • Help:Sortable tables#Specifying a sort key for a cell
  • {{tl|sort}} – see talk for central sorting talk
  • {{tl|Date table sorting}}  – for using dates in sortable tables
  • {{tl|Number table sorting}}  – for using alphabetic sort mode for numbers in sortable tables
  • {{tl|Last word}}

{{sandbox other||

Sortname

}}

{

"params": {

"1": {

"label": "First Name",

"example": "Tom",

"required": true,

"suggested": true

},

"2": {

"label": "Last Name",

"example": "Jones",

"required": true

},

"3": {

"label": "Optional Link Target",

"example": "Tom Jones (singer)",

"type": "wiki-page-name"

},

"4": {

"label": "Optional Sort Key",

"example": "Jones, Tom"

},

"sort": {},

"last": {},

"first": {},

"nolink": {

"label": "No Link",

"description": "Type \"1\" for no wikilink to appear ",

"example": "1"

},

"dab": {

"label": "Disambiguator (no brackets)",

"example": "singer"

},

"link": {}

},

"paramOrder": [

"1",

"2",

"3",

"4",

"dab",

"nolink",

"sort",

"last",

"first",

"link"

],

"format": "inline"

}