查看“︁Template:Jp/doc”︁的源代码

<includeonly><!-- 在這裡加入模板的保護標識 -->{{Wraps infobox|Jpn}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
<!-- 在本行下編輯模板說明 -->
{{High-use|822}}
== 說明 ==
本模板可為從[[日語]]翻譯而來的中文字詞標注其日語原文、[[注音假名]]以及[[平文式羅馬字|羅馬字]]，甚或日語[[舊字體]]等額外資料。

基本樣式：{{jp|c=中文字|j=日語原文|hg=假名|rm=羅馬字|lead=yes}}

在不使用中文欄位時，包裹日語文字的括號會自動隱藏，不使用任何日語欄位時則會自動隱藏幫助連結。

模板建基於{{tl|jpn}}，主要用以解決{{tl|nihongo}}需為沒有使用的參數留位和雙重括號的問題，同時也大致覆蓋了舊有兩個模板的功能。此外，本模板的全部欄位均為選填，用戶可自行按需要填寫使用的欄位，也可以選擇顯示幫助連結「<small>[[日語|<span style="font: bold sans-serif; text-decoration: none; "><sup>?</sup></span>]]</small>」或「日語：」標籤與否，解決了{{tl|jpn}}在內文使用時必須每次寫入「link=no」的麻煩，靈活性較高。

== 參數 ==
全部參數均為可選填寫。
* 一般使用的參數
** <code>|c=</code>：填寫位於括號前的中文翻譯名稱。如不填寫此項，模板將不會顯示括號。
** <code>|j=</code>：填寫日語原文。日語原文不限表記方式，通常由[[漢字]]和[[日語假名|假名]]組成，甚或[[和漢混淆文]]。
** <code>|hg=</code>：填寫日語原文對應的[[注音假名]]表記，可為全[[平假名]]或全[[片假名]]，特殊情況下也可混合使用。
** <code>|rm=</code>：填寫日語原文對應的[[平文式羅馬字]]。建議僅在導言及敘述與讀音相關的內容時使用。
* 較少使用的參數
** <code>|lead=yes</code>：顯示「日語：」字樣。只在條目中首次使用時填入，否則一般不使用。
** <code>|kyu=</code>：填寫日語漢字[[舊字體]]表記。多適用於1946年以前的名稱和字詞，一般較少使用。
** <code>|extra1=</code>：填寫括號{{red|內}}的額外參數。可在導言段用於表示生死日期，又或是用於只有外文沒有日語角色名字，也可寫入對該詞的註釋（如[[#條目使用範例|條目使用範例的「文中使用」]]）。
** <code>|extra2=</code>：填寫括號{{red|外}}的額外參數。可用於表示配音員資料。
** <code>|help=no</code>：隱藏幫助連結「<small>[[日語|<span style="font: bold sans-serif; text-decoration: none; "><sup>?</sup></span>]]</small>」。除非原文、平假名和羅馬字三個參數均沒有使用，否則一般不需隱藏。

== 範例 ==
=== 代碼使用範例 ===
; 首次使用
{| class="wikitable"
|-
! 輸入
| <code><nowiki>{{jp|c=乙坂步未|j=乙坂 歩未|hg=おとさか あゆみ|rm=Otosaka Ayumi|lead=yes}}</nowiki></code>
|-
! 顯示
| {{jp|c=乙坂步未|j=乙坂 歩未|hg=おとさか あゆみ|rm=Otosaka Ayumi|lead=yes}}
|}

; 一般使用
{| class="wikitable"
|-
! 輸入
| <code><nowiki>{{jp|c=乙坂步未|j=乙坂 歩未|hg=おとさか あゆみ|rm=Otosaka Ayumi}}</nowiki></code>
|-
! 顯示
| {{jp|c=乙坂步未|j=乙坂 歩未|hg=おとさか あゆみ|rm=Otosaka Ayumi}}
|}

; 隱藏幫助連結
{| class="wikitable"
|-
! 輸入
| <code><nowiki>{{jp|c=乙坂步未|j=乙坂 歩未|hg=おとさか あゆみ|rm=Otosaka Ayumi|help=no}}</nowiki></code>
|-
! 顯示
| {{jp|c=乙坂步未|j=乙坂 歩未|hg=おとさか あゆみ|rm=Otosaka Ayumi|help=no}}
|}

; 不使用日文
{| class="wikitable"
|-
! 輸入
| <code><nowiki>{{jp|c=薩拉雪恩|extra1=Sara Shane|extra2=聲：[[澤城美雪]]，歌：[[marina]]|help=no}}</nowiki></code>
|-
! 顯示
| {{jp|c=薩拉雪恩|extra1=Sara Shane|extra2=聲：[[澤城美雪]]，歌：[[marina]]|help=no}}
|}

; 不使用中文
{| class="wikitable"
|-
! 輸入
| <code><nowiki>{{jp|j=乙坂 歩未|hg=おとさか あゆみ|rm=Otosaka Ayumi|help=no}}</nowiki></code>
|-
! 顯示
| {{jp|j=乙坂 歩未|hg=おとさか あゆみ|rm=Otosaka Ayumi|help=no}}
|}

;使用全部參數（僅供示範）
{| class="wikitable"
|-
! 輸入
| <code><nowiki>{{jp|c=乙坂步未|j=乙坂 歩未|kyu=乙坂 步未|hg=おとさか あゆみ|rm=Otosaka Ayumi|lead=yes|help=no|extra1={{bd|1994年|6月25日}}|extra2=聲：[[麻倉桃]]}}</nowiki></code>
|-
! 顯示
| {{jp|c=乙坂步未|j=乙坂 歩未|kyu=乙坂 步未|hg=おとさか あゆみ|rm=Otosaka Ayumi|lead=yes|help=no|extra1={{bd|1994年|6月25日}}|extra2=聲：[[麻倉桃]]}}
|}

=== 條目使用範例 ===
*導言使用
*:<code><nowiki>'''和歌山縣'''（{{jp|j=和歌山県|hg=わかやまけん|rm=Wakayama-ken|lead=yes}}），位於[[日本]][[本州島]][[紀伊半島]]西部，屬[[近畿地方]]。</nowiki></code>
*:'''或'''<code><nowiki>{{jp|c='''和歌山縣'''|j=和歌山県|hg=わかやまけん|rm=Wakayama-ken|lead=yes}}，位於[[日本]][[本州島]][[紀伊半島]]西部，屬[[近畿地方]]。</nowiki></code>
*:{{jp|c='''和歌山縣'''|j=和歌山県|hg=わかやまけん|rm=Wakayama-ken|lead=yes}}，位於[[日本]][[本州島]][[紀伊半島]]西部，屬[[近畿地方]]。
*:（出處：[[和歌山縣]]）
*文中使用
*:<code><nowiki>熊耳的外號{{jp|c=「{{lang|en|Pooh}}」|j=プー|rm=puu|extra1=[[小熊維尼]]的英文名稱}}，由隼翼所取。</nowiki></code>
*:熊耳的外號{{jp|c=「{{lang|en|Pooh}}」|j=プー|rm=puu|extra1=[[小熊維尼]]的英文名稱}}，由隼翼所取。
*:<code><nowiki>語癖是喜歡在句末加上「{{jp|j=なのですぅ|rm=nano desuu}}」和「{{jp|j=なのでござる|rm=nano de gozaru}}」等修飾詞。</nowiki></code>
*:語癖是喜歡在句末加上「{{jp|j=なのですぅ|rm=nano desuu}}」和「{{jp|j=なのでござる|rm=nano de gozaru}}」等修飾詞。
*:（出處：[[Charlotte (動畫)]]）
*ACG條目角色介紹使用
*:<code><nowiki>{{jp|c=高坂穗乃果|j=高坂 穂乃果|hg=こうさか ほのか|rm=Kōsaka Honoka|extra2=聲：[[新田惠海]]（日本）；[[薛晴 (配音員)|薛晴]]（臺灣）；[[何璐怡]]（香港）；{{Link-en|瑪莉芙·希靈頓|Marieve Herrington}}（美國）}}</nowiki></code>
*:;{{jp|c=高坂穗乃果|j=高坂 穂乃果|hg=こうさか ほのか|rm=Kōsaka Honoka|extra2=聲：[[新田惠海]]（日本）；[[薛晴 (配音員)|薛晴]]（臺灣）；[[何璐怡]]（香港）；{{Link-en|瑪莉芙·希靈頓|Marieve Herrington}}（美國）}}
*:（出處：[[Love Live!人物列表]]）
*ACG條目角色介紹（只有外文名字）使用
*:<code><nowiki>{{jp|c=薩拉雪恩|extra1=Sara Shane|extra2=聲：[[澤城美雪]]，歌：[[marina]]|help=no}}</nowiki></code>
*:;{{jp|c=薩拉雪恩|extra1=Sara Shane|extra2=聲：[[澤城美雪]]，歌：[[marina]]|help=no}}
*:（出處：[[Charlotte (動畫)]]）

== 模板数据 ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"c": {
			"label": "中文",
			"description": "填写位于括号前的中文翻译名称。如不填写此项，模板将不会显示括号",
			"type": "string"
		},
		"j": {
			"label": "日文",
			"description": "填写日语原文。日语原文不限表记方式，通常由汉字和假名组成，甚或和汉混淆文。",
			"type": "string",
			"required": true
		},
		"hg": {
			"label": "假名",
			"description": "填写日语原文对应的注音假名表记，可为全平假名或全片假名，特殊情况下也可混合使用。",
			"type": "string",
			"suggested": true
		},
		"rm": {
			"label": "罗马字",
			"description": "填写日语原文对应的平文式罗马字。建议仅在导言及叙述与读音相关的内容时使用。",
			"type": "string",
			"suggested": true
		},
		"lead": {
			"label": "lead",
			"description": "若设置为“yes”则显示“日语：”字样。只在条目中首次使用时填入，否则一般不使用。",
			"example": "yes",
			"type": "boolean"
		},
		"kyu": {
			"label": "旧字体",
			"description": "填写日语汉字旧字体表记。多适用于1946年以前的名称和字词，一般较少使用。",
			"type": "string"
		},
		"extra1": {
			"label": "扩展注释1",
			"description": "填写括号内的额外参数。可在导言段用于表示生死日期，又或是用于只有外文没有日语角色名字，也可写入对该词的注释（如条目使用范例的“文中使用”）。",
			"type": "string"
		},
		"extra2": {
			"label": "扩展注释2",
			"description": "填写括号外的额外参数。可用于表示配音员资料。",
			"type": "string"
		},
		"help": {
			"label": "help",
			"description": "若设置为“no”则隐藏帮助连结“?”。除非原文、平假名和罗马字三个参数均没有使用，否则一般不需隐藏。",
			"example": "no",
			"type": "boolean"
		}
	},
	"description": "本模板可为从日语翻译而来的中文字词标注其日语原文、注音假名以及罗马字，甚或日语旧字体等额外资料。",
	"format": "inline",
	"paramOrder": [
		"c",
		"j",
		"hg",
		"rm",
		"lead",
		"kyu",
		"extra1",
		"extra2",
		"help"
	]
}
</templatedata>

==相關模板==
{{Jpn/doc/Related templates}}

==相關鏈接==
* [[WIkipedia:格式手冊/日本相關條目]]
* [[Wikipedia:日本動漫遊戲條目指導]]
* [[Wikipedia:漢字文化圈語言專有名詞的中譯規則#日語相關]]

<includeonly>
<!-- 本行下加入模板的分類 -->
[[Category:日語模板|{{PAGENAME}}]]
<!-- 本行下加入模板的跨語言鏈接 -->

</includeonly>