Template:Post-nominals/doc
This is a documentation subpage for Template:Post-nominals. It may contain usage information, categories and other content that is not part of the original template page. |
Usage
The default use provides post-nominals linked to the relevant article for the award. By default, the Canadian set of awards is used:
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%:
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):
Country
By default, the template links to articles on the Canadian versions of the honours indicated by the post-nominals. To specify another country, include |country=XXX
where XXX is the ISO 3166-1 alpha-3 code for that country:
Currently, the countries supported are Australia (AUS); Canada (CAN); Hong Kong (HKG); New Zealand (NZL); Nigeria (NG); the United Kingdom (GBR); and South Africa (ZAR). (See data links below.)
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|GNZM|GCB|GCMG|GBE}}
- while "Dame Jane Jones, GNZM GCB GCMG GBE" is produced by:
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 Medal for Distinguished Service is specified with QFSMd and QPMd:
Data
Data templates for each supported country:
TemplateData
Show a person's post-nominals cleanly and with links to the relevant articles.
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