Template:NameSort/doc

— like its sister template, — allows for apparently automatic sorting of pages. It uses the magic word, DEFAULTSORT, to make sure that the page is put into all categories later added to the page on the basis of the person's last name. As such, this template should only be used on templates about people who have at least two names. If there are more than two names, the template will still work, looking only for the final name.

Usage
Usage is super easy. Just type NameSort at the bottom of a page. Then, when you add categories to the page you no longer have to define the sort key for every individual category. It will automatically sort the person by their last name.

Note that this will sort up to the 6th letter of a person's last name, but will sort by the entire last name if the name is 6 letters or shorter. For names that are 7 letters or longer, sorting will continue after having established the first six letters, which still results in proper alphabetisation.

For instance, take the last names, "Smith-Jones" and "Smith-Klein". The template will result in the same sort key for both, Smith-. However, it will still put Smith-Jones ahead of Smith-Klein in the category list, because the MediaWiki software will continue looking for further letters if it finds that two entries have exactly the same sort keys.

Even so, it's fairly unlikely that there will be too many instances of exact sort key matches, since the sort key is 6 letters long.

Demonstration
It's impossible to show the results of this template directly, as it acts in the background of page management.

However, here are some of the ways this template will sort personal names. Here are some illustrative examples from w:c:tardis: Russell T Davies --> Davies, Russell William Ash --> Ash, William Juanita Maria Perez Garcia --> Garcia, Juanita John Ainsworth --> Ainswo, John Cassandra (actress) --> Cassandra Nelvana --> Nelvan John Wood (illustrator) --> Wood, John Arthur Smith -- > Smith, Arthur Hannah Smith --> Smith, Hannah Adam Smith (director) --> Smith, Adam director Adam Smith (disambiguation) --> Smith, Adam disambiguation Adam Smith (writer) --> Smith, Adam writer

Multi-word last names
One kind of name that won't be handled properly by this template are people who have un-hyphenated but double-barrelled names, like "Roger Lloyd Pack". Roger Lloyd Pack would sort under, when it should be sorting under. Obviously, nothing can be done if the person is a character, and the printed work repeatedly fails to use a hyphen. But in the case of actors and other real world people, common sense should prevail. If the person is usually credited with a hyphen, but wasn't in Doctor Who, treat the the end credits as erroneous, and change the name of the page to include the hyphen.

For the time being, people with multi-word last names will have to have a manual edit of their DEFAULTSORT.

Van, von, de, du
Note that names with non-English possessive adjectives are properly sorted in English by the last name. So the template does the right thing by sorting "Vincent van Gogh" as.

However, where the vowel has been eliminated in favour of an apostrophe, the name will be sorted under,   or.

Sorting of people with same last names
Because the template was altered on 2 February 2012 to directly include first names, people of the same last names will always be sorted first by their last names, then by their first.

Disambiguated articles
As of 2 February 2012, and 11 January 2017 when it was implemented here, NameSort disregards disambiguation terms, and sorts only on the name. So "Barnaby Edwards (actor)" will be sorted under. Because the key includes the disambiguation term (minus the parentheses), it's possible to have an alphabetical order even amongst things with the same name.

However, the template does not truncate articles. Notice therefore, what happens to the following (also from Tardis):
 * John (Remembrance of the Daleks) --> John Remembrance of the Daleks
 * John (The Custodians) --> John The Custodians
 * John (The Sensorites) --> John The Sensorites

However, this break with standard alphabetisation rules is slight and will likely not be corrected. While there are a number of people who have the same names, these people are only very rarely in the same category. Thus this "error" will hardly ever show.

Best practices
Note that even if a person currently exists in a single category, and that category has a sort key defined for it, you should still use this template. The use of DEFAULTSORT should be universal on all pages about people and characters with at least two names. It should be possible for a person to add a category to a page — without having to edit it — and for that page to be automatically sorted properly.

In other words, the default condition of every "person page" should be that it sorts automatically by last name. This template ensures that goal is achieved.

Authorship
This template originated at w:c:tardis, or the Tardis Data Core, and was authored by user:CzechOut.