Template:Nihongo3/doc

Usage
This template is basically the same as 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 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. ' Japanese term in Rōmaji (Kanji version, "English translation")', instead of ' English term (Kanji version, Japanese translation in Rōmaji)'.

Syntax: Parameters:
 * &lt;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;kanji/kana>. Required when &lt;rōmaji> is empty or omitted. The word as written using Japanese script (kanji, kana).
 * &lt;rōmaji>. Required when &lt;kanji/kana> is empty. Transliteration of the Japanese word, using Hepburn Romanization.
 * &lt;extra>. Optional. Can be used to add a gloss (particularly if there is no English form). Can also be expressed as a named parameter,
 * &lt;extra2>. Optional. Can also be expressed as a named parameter, . 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  segment as being in Japanese Kanji, which helps web browsers display it correctly. It also applies the  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 . 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 extra and extra2. Parameter extra2 is useful only in ";" definitions (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 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 single quotation marks, not double.
 * The Rōmaji parameter (the third one) does automatically put its content into italics, which in most cases should be done (manually).
 * The order of parameters is fixed, and is intentionally the same as that of 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 Nihongo3 to Nihongo).

See examples below for usage hints.

Examples
With :

The  parameter can be used for links, reference footnote citations, etc.

Without  (and probably not the desired effect):

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

Do not use  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  (which renders as "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
User style can be set by adding code similar to


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

or


 * .t_nihongo_kanji { color: green; font-family: Arial; }

to common.css.

Error messaging
This template emits one error message of its own:
 * error: : Japanese or romaji text required

One of the positional parameters , the 'Japanese' referred to in the error message or    is required for proper operation of this template. Articles with these errors are collected in.

This error often occurs because the template is malformed:
 * instead of ; 東京タワー is in    instead of   .  To resolve this error, add the missing pipe  or consider using  or

Because this template uses and  which emit their own error messages, see the help text for those at:
 * – for error messages emitted by
 * – for error messages emitted by