Nwuan a̱tyin ka a li Ta‌̱mpi‌̱let:Nihongo3/doc

{{Documentation subpage}}
{{COinS safe|n}}
{{Lua|Module:Nihongo}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{TOCright}}

== Usage ==
This template is basically the same as {{tl|Nihongo}}, except that it reverses the order of the English and [[Rōmaji]] items' display, and relies on a little bit of manual formatting for italics and quotation marks; its handling of [[Kanji]] (and/or [[Kana]]) is the same as that of {{tl|Nihongo}}.

This template is useful when one is addressing a Japanese term directly instead of providing a Japanese translation for an English one, i.e. <nowiki>'</nowiki>''Japanese term in Rōmaji'' (Kanji version, "English translation")', instead of <nowiki>'</nowiki>English term (Kanji version, ''Japanese translation in Rōmaji'')'.

<!--Re-enable the following when the page has been updated to address this template.--><!--{{Details|2=when to use this template|Wikipedia:Manual of Style (Japan-related articles)}}-->

'''Syntax:'''
{|class=wikitable
|-
|<code><nowiki>{{Nihongo3|</nowiki>&lt;{{var|english}}>&#124;&lt;{{var|kanji/kana}}>&#124;&lt;{{var|rōmaji}}>&#124;&lt;{{var|extra}}>&#124;&lt;{{var|extra2}}>}}</code>
|}
'''Parameters:'''
* &lt;{{var|english}}>. Optional. The word as translated into English. Note that this will sometimes be the actual Japanese word due to it being adopted into English.
* &lt;{{var|kanji/kana}}>. Required when &lt;{{var|rōmaji}}> is empty or omitted. The word as written using Japanese script (kanji, kana).
* &lt;{{var|rōmaji}}>. Required when &lt;{{var|kanji/kana}}> is empty. Transliteration of the Japanese word, using Hepburn Romanization.
* &lt;{{var|extra}}>. Optional. Can be used to add a gloss (particularly if there is no English form). Can also be expressed as a named parameter, <code>extra=</code>
* &lt;{{var|extra2}}>. Optional. Can also be expressed as a named parameter, <code>extra2=</code>. It is only useful in ";" definitions (extra2 will be displayed without bold, whereas text following the template will get the bold).

This template marks the <code>Kanji</code> segment as being in Japanese Kanji, which helps web browsers display it correctly. It also applies the <code>t_nihongo_kanji</code> CSS style class to it.

Parameters 1, 2 and 3 are required, but the first may be blank (e.g. if the Kanji/Kana and Rōmaji are known but the English is not, use <code><nowiki>{{Nihongo3||&lt;{{var|kanji/kana}}>|&lt;{{var|rōmaji}}>}}</nowiki></code>. Using the template without the Rōmaji and Kanji version is essentially pointless, and will result in a useless or worse-than-useless display. Parameters 4 and 5 can also be directly invoked with {{para|extra}} and {{para|extra2}}. Parameter {{para|extra2}} is useful only in ";" definitions ({{para|extra2}}'s content will be displayed without bold, whereas text following the template will get the bold); see below for a concrete example.

'''Please note''':
*The English parameter (the first one) does {{em|not}} automatically put quotation marks around its content.  This may or may not be desired, depending upon the context and content (and as in example below, something else may be done, such as prefacing the English translation with something. Literal translations and linguistic glosses go in [[MOS:SINGLE|single quotation marks]], not double.
*The Rōmaji parameter (the third one) does automatically put its content into italics, which in most cases {{em|other than proper names}} should be done (manually).
*The order of parameters is fixed, and is intentionally the same as that of {{tl|Nihongo}} (despite it being not very intuitive for this template) to make most conversions between the two display formats a simple matter of a one-character change to the template name and some manual quotation mark and italics formatting (or removal thereof if converting from {{tl|Nihongo3}} to {{tl|Nihongo}}).

See examples below for usage hints.

=== Examples ===
<!--Probably need non-bio examples, since the MOS/NC seem to recommend using Western name order for article title.-->
{| class="wikitable"
|'''Code''' ||<code><nowiki>{{Nihongo3|Western: '''Motojiro Kajii'''|梶井 基次郎|'''Kajii Motojirō'''|1901–1932}}</nowiki></code>
|-
|'''Gives'''||              {{Nihongo3|Western: '''Motojiro Kajii'''|梶井 基次郎|'''Kajii Motojirō'''|1901–1932}}
|}

With <code>extra2</code>:

{| class="wikitable"
|'''Code''' ||
<code><nowiki>; {{Nihongo3|'priest of nothingness'|虚無僧|komusō|extra2=[religion]}}</nowiki></code><br />
<code><nowiki>: Mendicant priest of the Fuke sect of Zen Buddhism.</nowiki></code>
|-
|'''Gives'''||
; {{Nihongo3|'priest of nothingness'|虚無僧|komusō|extra2=[religion]}}
: Mendicant priest of the Fuke sect of Zen Buddhism.
|}

The <code>extra2</code> parameter can be used for links, reference footnote citations, etc.

Without <code>extra2</code> (and probably '''not''' the desired effect):

{{hatnote|Note: literal translations and linguistic glosses go in [[MOS:SINGLE|single quotation marks]], not double.}}

{| class="wikitable"
|'''Code''' ||
<code><nowiki>; {{Nihongo3|'priest of nothingness'|虚無僧|komusō}} [religion]</nowiki></code><br />
<code><nowiki>: Mendicant priest of the Fuke sect of Zen Buddhism.</nowiki></code>
|-
|'''Gives'''||
<!--       -->; {{Nihongo3|'priest of nothingness'|虚無僧|komusō}} [religion]
<!--       -->: Mendicant priest of the Fuke sect of Zen Buddhism.
|}

Example of usage when it is not clear from the context that Japanese is the language in question:

{| class="wikitable"
|'''Code''' ||
<code><nowiki>{{Nihongo3|Japanese for 'four balls'|四つ球|'''yotsudama'''}}</nowiki></code>
|-
|'''Gives'''||
{{Nihongo3|Japanese for 'four balls'|四つ球|'''yotsudama'''}}
|}

Do not use <code><nowiki>Japanese: 'English version'</nowiki></code> for a case like this, as this colon formatting is used by Wikipedia language templates to indicate that the material that ''follows'' the colon is in the language mentioned before the colon, and this different use of this formatting will confuse readers.  Use "for" or some other clear wording instead.  Also, do not use <code><nowiki>{{Lang-ja|"English version"}}</nowiki></code> (which renders as {{Lang-ja|"English version"}}); this even more explicitly signals that the material following the language name is in that language, and the text will appear (as it does in that example) in a different font.

== User style ==
[[Help:User style|User style]] can be set by adding code similar to

: <nowiki>*[lang=ja] { color: green; font-family: Arial; }</nowiki>

or

: <nowiki>.t_nihongo_kanji { color: green; font-family: Arial; }</nowiki>
to [[Special:Mypage/common.css|common.css]].

==Error messaging==
This template emits one error message of its own:
:<span class="error" style="font-size:100%">error: <nowiki>{{nihongo3}}</nowiki>: Japanese or romaji text required</span>
One of the positional parameters <code>&lt;{{var|kanji/kana}}></code> (<code><nowiki>{{{2}}}</nowiki></code>), the 'Japanese' referred to in the error message or <code>&lt;{{var|rōmaji}}></code> (<code><nowiki>{{{3}}}</nowiki></code>) is required for proper operation of this template.  Articles with these errors are collected in {{clc|Nihongo template errors}}.

This error often occurs because the template is malformed:
:<code><nowiki>{{Nihongo3|東京タワー}}</nowiki></code> instead of <code><nowiki>{{Nihongo3||東京タワー}}</nowiki></code>; {{lang|ja|東京タワー}} is in <code><nowiki>{{{1}}}</nowiki></code> (<code>&lt;{{var|english}}></code>) instead of <code><nowiki>{{{2}}}</nowiki></code> (<code>&lt;{{var|kanji/kana}}></code>).  To resolve this error, add the missing pipe (<code>|</code>) or consider using {{tlx|lang}} or {{tlx|transl}}

Because this template uses {{tld|lang}} and {{tlx|transl}} which emit their own error messages, see the help text for those at:
:{{cl|Lang and lang-xx template errors}} – for error messages emitted by {{tld|lang}}
:{{cl|Transl template errors}} – for error messages emitted by {{tld|transl}}

== See also ==
* {{tl|Nihongo}}, essentially same as this template, but gives English first and Rōmaji inside the parentheses
* {{tl|Nihongo krt}}, essentially the same as this template, but gives kanji first with rōmaji and English inside the parentheses
* {{tl|Nihongo foot}}, same as {{tl|Nihongo}}, but puts everything but the English into a footnote.
* {{tl|Nihongo2}}, also displays the kanji properly, but without adding anything in parentheses, without Rōmaji and without the extra parameters
* {{tl|Nihongo-s}}, a simplified version of {{tl|Nihongo}} without the extra spans or checks

<includeonly>{{Sandbox other||
<!-- CATEGORIES AND INTERWIKIS BELOW THIS LINE PLEASE -->

[[Category:Japonic multilingual support templates|{{PAGENAME}}]]
[[Category:WikiProject Japan templates|Nihongo3]]

[[ca:Plantilla:Nihongo3]]
[[id:Templat:Nihongo3]]
}}</includeonly> 
<templatedata>
{
	"params": {
		"1": {
			"type": "string",
			"label": "English translation",
			"required": true,
			"description": "English translation of the Japanese term, but can be blank",
			"example": "priest of nothingness"
		},
		"2": {
			"label": "Kanji/kana",
			"type": "string",
			"required": true,
			"example": "虚無僧"
		},
		"3": {
			"type": "string",
			"label": "Rōmaji",
			"required": true,
			"example": "komusō"
		},
		"extra": {
			"label": "extra text in parentheses",
			"type": "string",
			"aliases": [
				"4"
			]
		},
		"extra2": {
			"label": "extra text after parentheses",
			"aliases": [
				"5"
			],
			"type": "string"
		}
	},
	"description": "Like {{Nihongo}} but lists '''rōmaji''' first"
}
</templatedata>