Template:Post-nominals/doc

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: PC CC OBE

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: PC CC OBE

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

Font size

The optional |size= parameter allows for the size of the text, as a percentage, to be changed from the template's default of 85%. As per MOS:FONTSIZE, this must be added when the template is used in infoboxes (it should be set to 100%), because infoboxes already use size-reduced text. It can be used elsewhere when there are few post-nominal letters.

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

Commas

By default, a comma-space is placed between each linked post-nominal (see above). Many post-nominals contain their own spaces ("OFM Cap FSA Scot FRHistS" looks like five post-nominals, but is only three). To include only a space, set |nocommas=y (or |nocommas=true, etc.):

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

This should probably only be done in cases where space is at a premium, such as in a tight table, and (not or) when all of a person's post-nominals are known with absolute certainty and zero of them contain spaces.

The old |comma= (AKA |sep=) is no longer needed, and can be removed from deployed instances of the template, since inclusion of the comma is the default.

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 PC OBE

Currently, the countries supported are Australia (AUS); Canada (CAN); Hong Kong (HKG); 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 London Assembly; AMw for a member of the National Assembly for Wales; and AMh for an honorary 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, GNZM GCB GCMG GBE" is produced by:

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

while "Dame Jane Jones GNZM GCB GCMG GBE" is produced by an f suffix on the parameter values:

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

• Kt, in the British set of honours, indicates a Knight Bachelor who also holds other knighthoods, baronetcies, and/or peerages; KT indicates a Knight of the Thistle.

• OM in the Canadian set defaults to the Order of Manitoba, while the Order of Merit is specified by OMt. "Joseph Jacques Jean Chrétien PC OM CC 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 Fire Service Medal for Gallantry and Queen's Fire Service Medal for Distinguished Service. QPM designates both Queen's Police Medal for Gallantry and Queen's Police Medal for Distinguished Service. In both instances, the medals for distinguished service are specified with a d suffix on the parameter values: QFSMd and QPMd:

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

Data

Data templates for each supported country:

• Australia
• Canada
• Hong Kong
• India
• New Zealand
• Nigeria
• Pakistan
• United Kingdom and UK with Categories
• South Africa

TemplateData

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

TemplateData for Post-nominals

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

Template parameters

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	nocommas nocomma	Change the default separator (comma-space) into just a space; should not be done any time confusion could result, such as with post-nominals that contain spaces themselves. 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