Template:Nihongo foot/doc
This is a documentation subpage for Template:Nihongo foot. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 3,100 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
This template marks the Kanji
segment as being in Japanese kanji, which helps user agents (web browsers and so on) to display it correctly. It also applies the t_nihongo_kanji
CSS class. The footnote generated is called using the <references />
.
Usage
[edit]Syntax
[edit]{{Nihongo foot|English|Kanji|Rōmaji|extra|extra2|post=,|group=group|ref_name=name}} <references group="group" />
Outputs:
English,[group 1]
- ^ Kanji, Rōmaji, extra extra2
Parameters
[edit]- <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.
- <kanji/kana>. Required when <rōmaji> is empty or omitted. The word as written using Japanese script (kanji, kana).
- <rōmaji>. Required when <kanji/kana> is empty. Transliteration of the Japanese word, using Hepburn Romanization.
- <extra>. Optional. Can be used to add a gloss (particularly if there is no English form). Can also be expressed as a named parameter,
extra=
- <extra2>. Optional. Can also be expressed as a named parameter,
extra2=
. It is only useful in ";" definitions (extra2 will be displayed without bold, whereas text following the template will get the bold). - lead=yes. Optional. This should be used for the first instance of Japanese, usually in the lead. It gives the reader an idea what kind of non-English writing they are viewing.
- post=<postscript>. Optional. Additional characters, such as commas, added after the visible English name but before the reference.
- group<group name>. Optional. Can be used to define a custom references group. The group is then called by using
<references group="group" />
instead of the normal<references />
. - ref_name<name>. Optional. Can be used to define a custom reference name. Use when the note is called multiple times with the same value on a page.
- lead=yes. Optional. This should be used for the first instance, usually a footnote in the lead. It gives the reader an idea what kind of non-English writing they are viewing.
Examples
[edit]Regular use
[edit]{{Nihongo foot|English|英語|eigo}} <references /> |
English[1]
|
With group defined
[edit]{{Nihongo foot|English|英語|eigo|group=nb}} <references group="nb" /> |
English[nb 1]
|
User style
[edit]User style can be set by adding code similar to
@media screen, tv {
*[lang="ja"] {
color: green;
}
}
or
@media screen, tv {
.t_nihongo_kanji {
color: green;
}
}
to your common.css.
Error messaging
[edit]This template emits one error message of its own:
- error: {{nihongo foot}}: Japanese or romaji text required
One of the positional parameters <kanji/kana>
({{{2}}}
), the 'Japanese' referred to in the error message or <rōmaji>
({{{3}}}
) is required for proper operation of this template. Articles with these errors are collected in Category:Nihongo template errors (0).
This error often occurs because the template is malformed:
{{Nihongo foot|東京タワー}}
instead of{{Nihongo foot||東京タワー}}
; 東京タワー is in{{{1}}}
(<English>
) instead of{{{2}}}
(<kanji/kana>
). To resolve this error, add the missing pipe (|
).
Because this template uses {{lang}}
and {{transl}}
which emit their own error messages, see the help text for those at:
- Category:Lang and lang-xx template errors – for error messages emitted by
{{lang}}
- Category:Transliteration template errors – for error messages emitted by
{{transl}}
See also
[edit]- {{Nihongo}}, original: generates everything that is in a footnote inside parenthesis
- {{Nihongo3}}, essentially the same as {{Nihongo}}, but gives romaji first and English inside the parentheses
- {{Nihongo krt}}, essentially the same as {{Nihongo}}, but gives kanji first with rōmaji and English inside the parentheses
- {{Nihongo2}}, also displays the kanji properly, but without adding anything in parentheses, without romaji and without the extra parameters
- {{Nihongo-s}}, a simplified version of {{Nihongo}} without the extra spans or checks
Like {{Nihongo}}, allows kanji/kana and rōmaji text, but puts them in footnotes
Parameter | Description | Type | Status | |
---|---|---|---|---|
English text | 1 | no description
| String | suggested |
Kana/kanji text | 2 | no description
| String | required |
Romanized (rōmaji) text | 3 | no description
| String | suggested |
Label writing systems | lead | If 'yes', shows "Japanese: ", etc., as leads
| String | optional |
First extra text | extra 4 | no description | String | optional |
Second extra text | extra2 5 | no description | String | optional |
Footnote reference group | group | no description | String | suggested |