Template:NameSort/doc

This template is being stripped from and reapplied to pages during the first week of February 2012. This action will ensure that each page has one and only one instance of the template on the page, and it will "refresh" the categories in which people are placed, allowing the new features to more quickly take hold.

For a few days, therefore, categorisation of people will be a bit of a mess. Please do not attempt to manually affect alphabetisation in the meantime. 00:58: Thu 02 Feb 2012

NameSort — like its sister template, TitleSort — 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: 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 --> Smiith, 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,.

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, 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:
 * 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
Even if there are other templates out there on wikis that do this same thing, this template's original form was developed entirely here at Tardis.

Widespread implementation
This template is being mass-added to pages by bot as of 17:49, April 11, 2011 (UTC). It's also being added to preloadable formats so that it will be automatically placed on new pages, so long as editors use those preloadable formats to create pages. Otherwise, if you create a new page about a person without the preloadable format after about 15 April 2011, you'll have to remember to go back and place this template manually.

Note that implementation will take two runs through both the real world and in-universe categories having to do with individuals. On the first run, the template will be placed on the page. If a DEFAULTSORT key already exists on the page, this will automatically cause a red-lettered warning to appear on the page, saying something to the effect of "you can't have two DEFAULTSORT keys". The second run, which will happen after the first run is complete, will come back through and remove the DEFAULTSORT key, leaving only NameSort behind. The process in total will take anywhere from two to five days from the start time given in the paragraph above.