テンプレート:Post-nominals/docのソースを表示

{{documentation subpage|種類=[[ヘルプ:テンプレート|テンプレート]]}}
<includeonly>{{pp-template}}</includeonly>
{{Template redirect|Post-nominal|Post-nominal styles|Postnom|Postnominal|Postnominals|Post nominals}}
このテンプレートは[[ポスト・ノミナル・レターズ]]を表示します。

__TOC__
=== 使い方 ===
==== 基本的な使い方 ====
{{para|country}}引数に[[ISO 3166-1 alpha-3]]の国名コード（後述）を入力し、名無し引数にポスト・ノミナル・レターズを1つずつ入力します。肩書きごとの内部リンクが自動で作成されます。
:例：<code><nowiki>{{post-nominals|country=CAN|PC|CC|OBE}}</nowiki></code>
:表示：{{post-nominals|country=CAN|PC|CC|OBE}}

==== 自動リンクを使用しない場合 ====
内部リンクを自動で追加しないようにする場合は{{para|unlinked}}、{{para|list}}、{{para|post-noms}}のいずれかでポスト・ノミナル・レターズを指定してください。
:例：<code><nowiki>{{post-nominals|unlinked=PC CC OBE}}</nowiki></code>
:表示：{{post-nominals|unlinked=PC CC OBE}}
:例：<code><nowiki>{{post-nominals|list=[[バス勲章|KB]]}}</nowiki></code>
:表示：{{post-nominals|list=[[バス勲章|KB]]}}

==== 文字サイズ ====
{{para|size}}引数を指定することで、文字サイズを変更できます（既定値は<code>85%</code>）。
:例：<code><nowiki>Jane Smith {{post-nominals|country=CAN|size=100%|PC|CC|OBE}}</nowiki></code>
:表示：Jane Smith {{post-nominals|country=CAN|size=100%|PC|CC|OBE}}

==== 区切り文字 ====
ポスト・ノミナル・レターズの間の区切り文字は既定では半角スペース（<code> </code>）となっています。コンマ（<code>,</code>）で区切る場合は{{para|commas}}または{{para|sep}}引数に空白以外の値を指定してください。
:例：<code><nowiki>Jane Smith, {{post-nominals||country=CAN|size=100%|commas=on|PC|CC|OBE}}</nowiki></code>
:表示：Jane Smith, {{post-nominals||country=CAN|size=100%|commas=on|PC|CC|OBE}}

==== 国名コード ====
{{para|unlinked}}、{{para|list}}、{{para|post-noms}}を使用していない場合、{{para|country}}引数は必須です。{{para|country}}引数が指定されていない場合の自動リンク処理は{{para|country|CAN}}（カナダ）として処理されますが、エラーメッセージが表示され、[[:Category:テンプレート呼び出しエラーのあるページ/Template:Post-nominals]]に追加されます。

国名コードを指定するときは、{{para|country|<var>XXX</var>}}（{{var|XXX}}は[[ISO 3166-1 alpha-3]]の国名コード）のように指定してください。
:例：<code><nowiki>Jane Smith {{post-nominals|country=NZL|PC|OBE}}</nowiki></code>
:表示：Jane Smith {{post-nominals|country=NZL|PC|OBE}}

現在、指定できる国は下記となっており、リンク先で指定できるポスト・ノミナル・レターズを閲覧できます。
<!--国名コード順-->
*カナダ: [[Template:Post-nominals/CAN|CAN]]
*イギリス: [[Template:Post-nominals/GBR|GBR]]
*ニュージーランド: [[Template:Post-nominals/NZL|NZL]]

===== 例外 =====
<!--(アルファベット順:)-->
*'''AM'''はイギリスにおける複数の肩書きを指すため、曖昧さ回避が必要です。[[ロンドン議会]]議員は'''AMl'''（末尾に小文字の"l"を追加）を、[[ウェールズ議会]]議員は'''AMw'''を、{{仮リンク|オーストラリア勲章|en|Order of Australia}}名誉メンバー（{{lang|en|honorary Member}}）は'''AMh'''を指定してください。

*'''GNZM GCB GCMG GBE'''はナイト（男性）とデイム（女性）の両方で同じ肩書きとなっているが、リンク先が違うため、このテンプレートでは曖昧さ回避が必要です。女性の場合は末尾に'''f'''を追加してください。
:例：<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>
:表示：Dame Jane Jones {{post-nominals|country=NZL|GNZMf|GCBf|GCMGf|GBEf}}

*'''Kt'''はイギリスにおける{{仮リンク|下級勲爵士|en|Knight Bachelor}}を、'''KT'''は[[シッスル勲章]]受章者を指します。

*'''OM'''はカナダにおける{{仮リンク|マニトバ勲章|en|Order of Manitoba}}受章者を、'''OMt'''は[[メリット勲章]]受章者を指します。

* '''QFSM'''はニュージーランドにおける[[:en:Queen's Fire Service Medal for Gallantry|Queen's Fire Service Medal for Gallantry]]と[[:en:Queen's Fire Service Medal for Distinguished Service|Queen's Fire Service Medal for Distinguished Service]]を、'''QPM'''は[[:en:Queen's Police Medal for Gallantry|Queen's Police Medal for Gallantry]]と[[:en:Queen's Police Medal for Distinguished Service|Queen's Police Medal for Distinguished Service]]を指します。どちらもDistinguished Serviceを指定する場合は末尾に'''d'''を追加してください。
::例：<code><nowiki>John Smith {{post-nominals|country=NZL|QFSM|QPM|QPSMd|QPMd}}</nowiki></code>
::表示：John Smith {{post-nominals|country=NZL|QFSM|QPM|QFSMd|QPMd}}

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"description": "ポスト・ノミナル・レターズを肩書きへのリンクつきで表示するテンプレート",
	"format": "inline",
	"params": {
		"country": {
			"example": "GBR",
			"label": "国",
			"description": "肩書きの該当国を国名コードで指定する。既定値はCAN（カナダ）。",
			"type": "string",
			"default": "CAN",
			"suggested": true
		},
		"1": {
			"label": "肩書き1",
			"description": "ポスト・ノミナル・レターズを指定する。",
			"example": "GCB",
			"type": "string",
			"suggested": true
		},
		"2": {
			"inherits": "1",
			"label": "肩書き2",
			"suggested": false
		},
		"3": {
			"inherits": "2",
			"label": "肩書き3"
		},
		"4": {
			"inherits": "2",
			"label": "肩書き4"
		},
		"5": {
			"inherits": "2",
			"label": "肩書き5"
		},
		"6": {
			"inherits": "2",
			"label": "肩書き6"
		},
		"7": {
			"inherits": "2",
			"label": "肩書き7"
		},
		"8": {
			"inherits": "2",
			"label": "肩書き8"
		},
		"9": {
			"inherits": "2",
			"label": "肩書き9"
		},
		"10": {
			"inherits": "2",
			"label": "肩書き10"
		},
		"11": {
			"inherits": "2",
			"label": "肩書き11"
		},
		"12": {
			"inherits": "2",
			"label": "肩書き12"
		},
		"13": {
			"inherits": "2",
			"label": "肩書き13"
		},
		"14": {
			"inherits": "2",
			"label": "肩書き14"
		},
		"15": {
			"inherits": "2",
			"label": "肩書き15"
		},
		"16": {
			"inherits": "2",
			"label": "肩書き16"
		},
		"17": {
			"inherits": "2",
			"label": "肩書き17"
		},
		"18": {
			"inherits": "2",
			"label": "肩書き18"
		},
		"19": {
			"inherits": "2",
			"label": "肩書き19"
		},
		"20": {
			"inherits": "2",
			"label": "肩書き20"
		},
		"size": {
			"label": "サイズ",
			"description": "ポスト・ノミナル・レターズの文字サイズ。",
			"example": "100%",
			"type": "string",
			"default": "85%"
		},
		"list": {
			"aliases": [
				"unlinked",
			"post-noms"
			],
			"label": "肩書きリスト",
			"description": "自動リンクをしない場合に指定する肩書きのリスト。",
			"example": "PC [[大英帝国勲章|KBE]]",
			"type": "unbalanced-wikitext"
		},
		"sep": {
			"aliases": [
				"commas"
			],
			"label": "区切り文字",
			"description": "区切り文字をスペースからコンマに切り替える場合に指定する。",
			"type": "string",
			"default": " "
		}
	},
	"paramOrder": [
		"country",
		"1",
		"2",
		"3",
		"4",
		"5",
		"6",
		"7",
		"8",
		"9",
		"10",
		"11",
		"12",
		"13",
		"14",
		"15",
		"16",
		"17",
		"18",
		"19",
		"20",
		"sep",
		"size",
		"list"
	]
}
</templatedata>

== 関連項目 ==
* {{clc|テンプレート呼び出しエラーのあるページ/Template:Post-nominals}}

<includeonly>{{sandbox other||
<!-- カテゴリは以下に追加してください -->
[[Category:レイアウト用テンプレート]]

}}</includeonly>