Template:Post-nominals/doc: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
meta>Jdaloner
Modified <includeonly> section so that "sandbox" subpage won't appear in categories.
meta>Sardanaphalus
parameter names (with some rephrasing), subheading, removed duplicated "post-nominals|"
Line 2: Line 2:
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->


=== Usage ===
===Usage===
The default use provides post-nominals linked to the relevant article for the award. By default, the Canadian set of awards are used:
The default use provides post-nominals linked to the relevant article for the award. By default, the Canadian set of awards is used:
: <code><nowiki>{{post-nominals|PC|CC|OBE}}</nowiki></code> produces: {{post-nominals|PC|CC|OBE}}


<code><nowiki>{{post-nominals|PC|CC|OBE}}</nowiki></code>: {{post-nominals|PC|CC|OBE}}
====Unlinked post-nominals====
To list post-nominals without links, use {{para|unlinked}} (or {{para|post-noms}}):
: <code><nowiki>{{post-nominals|unlinked=PC CC OBE}}</nowiki></code> produces: {{post-nominals|unlinked=PC CC OBE}}


==== Suppress links with the postnoms parameter ====
====Font size====
The linking can be suppressed by using the {{para|post-noms}} parameter:
 
<code><nowiki>{{post-nominals|post-noms=PC CC OBE}}</nowiki></code>: {{post-nominals|post-noms=PC CC OBE}}
 
==== Font size ====
The optional {{para|size}} parameter allows for the size of the text, as a percentage, to be changed from the template's default of 85%:
The optional {{para|size}} parameter allows for the size of the text, as a percentage, to be changed from the template's default of 85%:
: <code><nowiki>{{post-nominals|size=100%|PC|CC|OBE}}</nowiki></code> produces: {{post-nominals|size=100%|PC|CC|OBE}}


<code><nowiki>{{post-nominals|post-nominals|PC|CC|OBE|size=100%}}</nowiki></code>: {{post-nominals|post-nominals|PC|CC|OBE|size=100%}}
====Commas====
By default, a single space is placed between each linked post-nominal (see above). To include a comma, set {{para|commas}} (or {{para|sep}}) as "on", "true", "," etc (without quotemarks):
: <code><nowiki>{{post-nominals|commas=on|PC|CC|OBE}}</nowiki></code> produces: {{post-nominals|commas=on|PC|CC|OBE}}


==== Separator ====
====Country====
To use a comma separator between post-nominals, use
By default, the template links to articles on the Canadian versions of the honours indicated by the post-nominals. To specify another country, include {{para|country|''XXX''}} where ''XXX'' is the [[ISO 3166-1 alpha-3]] code for that country:
{{para|sep|,}}
: <code><nowiki>{{post-nominals|country=NZL|PC|OBE}}</nowiki></code> produces: {{post-nominals|country=NZL|PC|OBE}}
Leave out the parameter completely or supply a blank value {{para|sep}} to have just non-breaking spaces between the post-nominals. Only a comma is supported as punctuation in this case and anything else supplied as a value will default to using a comma in the rendered text.


<code><nowiki>{{post-nominals|PC|CC|OBE|sep=,}}</nowiki></code>: {{post-nominals|PC|CC|OBE|sep=,}}
Currently, the countries supported are Australia (AUS); Canada (CAN); New Zealand (NZL); and the United Kingdom (GBR). (See data links below.)


==== Automatic linking to a country article ====
=====Exceptions=====
* '''OM''', in the Canadian set of honours, defaults to the [[Order of Manitoba]], while the [[Order of Merit]] is specified by '''OMt'''. "Joseph Jacques Jean Chrétien, {{post-nominals|country=CAN|PC|OMt|CC|QC}}", for instance, is produced by:
:: <code><nowiki>Joseph Jacques Jean Chrétien, {{post-nominals|country=CAN|PC|OMt|CC|QC}}</nowiki><code>


<code><nowiki>{{post-nominals|country=CAN|PC|CC|OBE}}</nowiki></code>: {{post-nominals|country=CAN|PC|CC|OBE}}
* '''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 {{post-nominals|country=NZL|GNZM|GCB|GCMG|GBE}}" is produced by:
:: <code><nowiki>Sir John Smith {{post-nominals|country=NZL|GNZM|GCB|GCMG|GBE}}</nowiki></code>
: while "Dame Jane Jones {{post-nominals|country=NZL|GNZMf|GCBf|GCMGf|GBEf}}" is produced by:
:: <code><nowiki>Dame Jane Jones {{post-nominals|country=NZL|GNZM</nowiki>'''f'''<nowiki>|GCB</nowiki>'''f'''<nowiki>|GCMG</nowiki>'''f'''<nowiki>|GBE</nowiki>'''f'''<nowiki>}}</nowiki></code>


Countries are specified using [[ISO 3166-1 alpha-3]] codes. The only countries currently supported are Australia (AUS), Canada (CAN), New Zealand (NZL), and the United Kingdom (GBR). If a country is not specified, the Canadian list will be used, as it duplicates most of the British list.
* '''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 QFSM'''d''' and QPM'''d''':
:: <code><nowiki>John Smith {{post-nominals|country=NZL|QFSM|QPM|QPSMd|QPMd}}</nowiki></code> produces: John Smith {{post-nominals|country=NZL|QFSM|QPM|QFSMd|QPMd}}


<code><nowiki>{{post-nominals|country=GBR|PC|CC|OBE}}</nowiki></code>: {{post-nominals|country=GBR|PC|CC|OBE}}
* '''AM''' is ambiguous in British honours. Use '''AMl''' (i.e. "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]].


<code><nowiki>{{post-nominals|country=GBR|PC|CC|OBE|size=100%|sep=,}}</nowiki></code>: {{post-nominals|country=GBR|PC|CC|OBE||size=100%|sep=,}}
* '''Kt''', in the British set, indicates a [[Knight Bachelor]] who also holds other knighthoods, baronetcies and/or peerages; '''KT''' indicates a [[Knight of the Thistle]].


Note that this is case-sensitive; "country=GBR" will invoke the British list, but "Country=GBR" will default to the Canadian list.
=====Exceptions=====
*'''OM''' in the Canada set defaults to the [[Order of Manitoba]]. The [[Order of Merit]] is specified with '''OMt''':
::<nowiki>'''Joseph Jacques Jean Chrétien''', {{Post-nominals|country=CAN|PC|OMt|CC|QC}}</nowiki> returns '''Joseph Jacques Jean Chrétien''', {{Post-nominals|country=CAN|PC|OMt|CC|QC}}
*'''GNZM GCB GCMG GBE''' Designates both a Knight Grand Cross/Companion and a Dame Grand Cross/Companion however different parameters  are used to link to a Dame Grand Cross or Companion.
** Sir John Smith {{post-nominals|country=NZL|GNZM|GCB|GCMG|GBE}}
** Dame Jane Jones {{post-nominals|country=NZL|GNZMf|GCBf|GCMGf|GBEf}} use <nowiki>{{post-nominals|country=NZL|GNZM</nowiki>'''f'''<nowiki>|GCB</nowiki>'''f'''<nowiki>|GCMG</nowiki>'''f'''<nowiki>|GBE</nowiki>'''f'''<nowiki>}}</nowiki>
*'''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 QFSM'''d''' and QPM'''d'''.
::<nowiki>'''John Smith''' {{post-nominals|country=NZL|QFSM|QPM|QPSMd|QPMd}}</nowiki> returns '''John Smith''' {{post-nominals|country=NZL|QFSM|QPM|QFSMd|QPMd}}
*'''AM''' is ambiguous in the British list: use '''AMl''' ''(lower case 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]].
*In the British list, distinguish '''Kt''' for a [[Knight Bachelor]] ''(nb: the post-nominal is used only for knights bachelor who hold other knighthoods, baronetcies and/or peerages)'' from '''KT''' for a [[Knight of the Thistle]].
=====Data=====
=====Data=====
Data templates for each supported country:
Data templates for each supported country:
Line 54: Line 47:
*[[Template:Post-nominals/GBR|United Kingdom]] and [[Template:Post-nominals/GBR-cats|UK with Categories]]
*[[Template:Post-nominals/GBR|United Kingdom]] and [[Template:Post-nominals/GBR-cats|UK with Categories]]


 
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
| <!----CATEGORIES BELOW THIS LINE, PLEASE:---->
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Wikipedia formatting and function templates]]
[[Category:Wikipedia formatting and function templates]]
}}</includeonly>
}}</includeonly>

Revision as of 10:13, 21 August 2014

Usage

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 post-nominals

To list post-nominals without links, use |unlinked= (or |post-noms=):

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

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%:

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

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):

{{post-nominals|commas=on|PC|CC|OBE}} produces: PC, CC, OBE

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:

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

Currently, the countries supported are Australia (AUS); Canada (CAN); New Zealand (NZL); and the United Kingdom (GBR). (See data links below.)

Exceptions
Joseph Jacques Jean Chrétien, {{post-nominals|country=CAN|PC|OMt|CC|QC}}
  • 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}}
John Smith {{post-nominals|country=NZL|QFSM|QPM|QPSMd|QPMd}} produces: John Smith QFSM QPM QFSM QPM
Data

Data templates for each supported country: