Template:Post-nominals/sandbox

This is the

template sandbox page for Template:Post-nominals (diff).
See also the companion subpage for test cases

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 54,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.

Redirects

Usage

Default

The default use provides post-nominals linked to the relevant article for the award. By default, the Canadian set of awards is used:

{{post-nominals|PC|CC|OBE}} produces:

Unlinked and/or custom-linked post-nominals

To list post-nominals without links and/or with customised linking, use |unlinked= or |list= (or |post-noms=):

{{post-nominals|unlinked=PC CC OBE}} produces:

{{post-nominals|list=[[Order of the British Empire|KBE]]}} produces:

Commas

By default, a single space is placed between each linked post-nominal (see above). To include a comma, set |commas= (or |sep=) as "on", "true", "," etc. (without quotemarks):

Jane Smith, {{post-nominals|size=100%|commas=on|PC|CC|OBE}} produces: Jane Smith,

Country

By default, the template links to articles on the Canadian versions of the honours indicated by the post-nominals. Please add |country=CAN anyway when Canada is wanted. To specify another country, include |country=XXX where XXX is the ISO 3166-1 alpha-3 code for that country:

Jane Smith {{post-nominals|country=NZL|PC|OBE}} produces: Jane Smith

Currently, the countries supported are Australia (AUS); Canada (CAN); Ghana (GHA); Hong Kong (HKG); Jamaica (JAM); New Zealand (NZL); Nigeria (NGA); the United Kingdom (GBR); and South Africa (ZAR). United States (USA) is functional but blank. (See data links below.)

If country is missing and none of unlinked, list, post-noms are used then Category:Pages using Template:Post-nominals with missing parameters is added to the page.

Exceptions

AM is ambiguous in British honours. Use AMl ("AM" followed by a lowercase "L") for a member of the
Member of the Order of Australia
.

GNZM GCB GCMG GBE designates both a Knight Grand Cross/Companion and a Dame Grand Cross/Companion. In order to link correctly, however, more specific abbreviations are needed to differentiate between the Knight and Dame. For instance, "Sir John Smith, " is produced by:

Sir John Smith, {{post-nominals|country=NZL|size=100%|sep=,|GNZM|GCB|GCMG|GBE}}

while "Dame Jane Jones " is produced by:

Dame Jane Jones {{post-nominals|country=NZL|GNZMf|GCBf|GCMGf|GBEf}}

Kt, in the British set of honours, indicates a
Knight of the Thistle
.

OM in the Canadian set defaults to the
QC
", for instance, is produced by:

Joseph Jacques Jean Chrétien {{post-nominals|country=CAN|PC|OMt|CC|QC}}

QFSM, in New Zealand, designates both the
Queen's Police Medal for Distinguished Service
. In both instances, the Medal for Distinguished Service is specified with QFSMd and QPMd:

John Smith {{post-nominals|country=NZL|QFSM|QPM|QPSMd|QPMd}} produces: John Smith

Data

Data templates for each supported country:

Antigua: AG
Australia: AUS or AUS-cats (compare)
Barbados: BRB
Belgium: BE
Brunei: BRN
Canada: CAN or CAN-cats (compare)
Fiji: FJI or FJI-cats (compare)
Germany: DEU
Ghana: GHA
Hong Kong: HKG
India: IND
Jamaica: JAM
Kenya: KEN
New Zealand: NZL
Nigeria: NGA
Pakistan: PAK
South Africa: ZAR
Sri Lanka: SRI
Sweden: SWE
United Kingdom: GBR or GBR-cats (compare)
United States: USA-cats

Tracking categories

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Post-nominals in articles based on its TemplateData.

TemplateData for Post-nominals

Show a person's post-nominals cleanly and with links to the relevant articles.

Template parameters[Edit template data]
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Country	`country`	Which set of awards to use, by ISO 3166-1 alpha-3 country code. By default, the Canadian set is used. Default CAN Example GBR	String	suggested
1st post-nominal	`1`	A post-nominal to show with a link to the relevant page. Example GCB	String	suggested
2nd post-nominal	`2`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
3rd post-nominal	`3`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
4th post-nominal	`4`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
5th post-nominal	`5`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
6th post-nominal	`6`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
7th post-nominal	`7`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
8th post-nominal	`8`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
9th post-nominal	`9`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
10th post-nominal	`10`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
11th post-nominal	`11`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
12th post-nominal	`12`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
13th post-nominal	`13`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
14th post-nominal	`14`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
15th post-nominal	`15`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
16th post-nominal	`16`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
17th post-nominal	`17`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
18th post-nominal	`18`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
19th post-nominal	`19`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
20th post-nominal	`20`	A post-nominal to show with a link to the relevant page. Example GCB	String	optional
Separator	`sep` `commas`	What separator to use. By default, this uses a space; you can use commas if you wish. Default	String	optional
Size	`size`	At what size to show the list; only over-ride if appropriate. Default 85% Example 100%	String	optional
Unformatted list	`list` `unlinked` `post-noms`	A list of post-nominals to display without links, or with customised linking. Example PC [[Order of the British Empire\|KBE]]	Unbalanced wikitext	optional