Template:Nihongo/doc: Difference between revisions

m
1 revision imported from wikipedia:Template:Nihongo/doc: nihongo update
m (1 revision imported: Templates)
m (1 revision imported from wikipedia:Template:Nihongo/doc: nihongo update)
 
(One intermediate revision by one other user not shown)
Line 1:
{{Documentation subpage}}
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). -->
{{High-use}}
{{COinS safe|n}}
{{Lua|Module:Nihongo}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 
{{TOCright}}
=== Usage ===
This template marks the <CODEcode>[[kanji]]</CODEcode> segment as being in Japanese kanji and/or kana, which helps user agents (web browsers and so on) to display it correctly. It also applies the <TT>t_nihongo_kanji</TT> CSS class.
 
{{Detailsdetails|2topic=when to use this template|Wikipedia:Manual of Style (Japan-related articles)}}
=== Usage ===
This template marks the <CODE>kanji</CODE> segment as being in Japanese kanji and/or kana, which helps user agents (web browsers and so on) to display it correctly. It also applies the <TT>t_nihongo_kanji</TT> CSS class.
 
; '''Syntax:'''
{{Details|2=when to use this template|Wikipedia:Manual of Style (Japan-related articles)}}
 
; Syntax
{|class=wikitable
|Without lead=yes
|With lead=yes
|-
|<code><nowiki>{{Nihongo|</nowiki>&lt;{{var|english}}>&#124;&lt;{{var|kanji/kana}}>&#124;&lt;{{var|rōmaji}}>&#124;&lt;{{var|extra}}>&#124;&lt;{{var|extra2}}>}}</code>
 
|<code><nowiki>{{Nihongo|English</nowiki>&lt;{{var|english}}>&#124;&lt;{{var|kanji/kana}}>&#124;&lt;{{var|rōmaji}}>&#124;lead=yes&#124;extra=&lt;{{var|extra}}>&#124;extra2=&lt;{{var|extra2}}>}}</code>
|{{Nihongo|English|kanji/kana|rōmaji|lead=yes|extra|extra2}}
|}
; '''Parameters:'''
* ''English''&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 inusing Japanese script (kanji, kana, Roman letters, and possibly other marks).
* ''&lt;{{var|rōmaji''}}>. OptionalRequired when &lt;{{var|kanji/kana}}> is empty. Transliteration of the Japanese word, using Hepburn Romanization.
* ''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.
* ''&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, <CODEcode>extra=</CODEcode>
* ''&lt;{{var|extra2''}}>. Optional. Can also be expressed as a named parameter, <CODEcode>extra2=</CODEcode>. It is only useful in ";" definitions (extra2 will be displayed without bold, whereas text following the template will get the bold).
 
=== Examples ===
;Regular use:
{| CLASS="wikitable"
|'''Code''' ||<CODEcode><NOWIKInowiki>{{Nihongo|Tokyo Tower|東京タワー|Tōkyō tawā}}</NOWIKInowiki></CODEcode>
|-
|'''Gives'''|| {{Nihongo|Tokyo Tower|東京タワー|Tōkyō tawā}}
|}
 
 
;Use in lead:
{| CLASS="wikitable"
|'''Code''' ||<CODEcode><NOWIKInowiki>{{Nihongo|Tokyo Tower|東京タワー|Tōkyō tawā|lead=yes}}</NOWIKInowiki></CODEcode>
|-
|'''Gives'''|| {{Nihongo|Tokyo Tower|東京タワー|Tōkyō tawā|lead=yes}}
Line 44:
;Without <code>English</code>:
{| CLASS="wikitable"
|'''Code''' ||<CODEcode><NOWIKInowiki>{{Nihongo||東京タワー|Tōkyō tawā}}</NOWIKInowiki></CODEcode>
|-
|'''Gives'''|| {{Nihongo||東京タワー|Tōkyō tawā}}
Line 51:
;Without <code>English</code>, use in lead:
{| CLASS="wikitable"
|'''Code''' ||<CODEcode><NOWIKInowiki>{{Nihongo||東京タワー|Tōkyō tawā|lead=yes}}</NOWIKInowiki></CODEcode>
|-
|'''Gives'''|| {{Nihongo||東京タワー|Tōkyō tawā|lead=yes}}
|}
 
;With <CODEcode>extra2extra</CODEcode> to add a literal translation:
{| CLASS="wikitable"
|'''Code''' ||<code><nowiki>{{Nihongo|''Sokoban''|倉庫番|Sōko-ban|{{lit|warehouse keeper}}}}</nowiki></code>
|-
|'''Gives'''|| {{Nihongo|''Sokoban''|倉庫番|Sōko-ban|{{lit|warehouse keeper}}}}
|}
 
;With <code>extra2</code>:
{| CLASS="wikitable"
|'''Code''' ||
<CODEcode><NOWIKInowiki>; {{Nihongo||虚無僧|komusō|extra2="'Priest of nothingness"'}}</NOWIKInowiki></CODEcode><BR />
<CODEcode><NOWIKInowiki>: Mendicant priest of the Fuke sect of Zen Buddhism.</NOWIKInowiki></CODEcode>
|-
|'''Gives'''||
; {{Nihongo||虚無僧|komusō|extra2="'Priest of nothingness"'}}
: Mendicant priest of the Fuke sect of Zen Buddhism.
|}
{{hatnote|Note: literal translations and linguistic glosses go in [[MOS:SINGLE|single quotation marks]], not double.}}
 
;Without <CODEcode>extra2</CODEcode>:
{| CLASS="wikitable"
|'''Code''' ||
<CODEcode><NOWIKInowiki>; {{Nihongo||虚無僧|komusō}} "'Priest of nothingness"'</NOWIKInowiki></CODEcode><BR />
<CODEcode><NOWIKInowiki>: Mendicant priest of the Fuke sect of Zen Buddhism.</NOWIKInowiki></CODEcode>
|-
|'''Gives'''||
<!-- -->; {{Nihongo||虚無僧|komusō}} "'Priest of nothingness"'
<!-- -->: Mendicant priest of the Fuke sect of Zen Buddhism.
|}
Line 81 ⟶ 89:
[[Help:User style|User style]] can be set by adding code similar to
 
<sourcesyntaxhighlight lang="css">
@media screen, tv {
*[lang="ja"] {
color: green;
}
}</sourcesyntaxhighlight>
 
to [[Special:Mypage/common.css|common.css]].
or
 
==Error messaging==
<source lang="css">
This template emits one error message of its own:
@media screen, tv {
:<span class="error" style="font-size:100%">error: <nowiki>{{nihongo}}</nowiki>: Japanese or romaji text required</span>
.t_nihongo_kanji {
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}}.
color: green;
 
}
This error often occurs because the template is malformed:
}
:<code><nowiki>{{Nihongo|東京タワー}}</nowiki></code> instead of <code><nowiki>{{Nihongo||東京タワー}}</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}}
</source>
 
to [[Special:Mypage/common.css|common.css]].
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}}
 
==Limitations==
This cannot be used within a Wikilink in an article or in any template or other page that is [[WP:Transclusion|transcluded]] into an article.
 
=== TemplateSee dataalso ===
* {{tlp|Lang-ja|...}},{{tlp|lang|ja|...}}, similar templates in the [[:Category:Lang-x templates|Lang-x template]] for marking up Japanese text
* {{tl|Nihongo3}}, essentially the same as this template, but gives rōmaji first and English 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 this version, 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
* {{tltlp|Jain iconlang|ja}}, to label sources written in Japanese
* {{tl|Japanese}}, to request expert assistance with Japanese script
 
== Template data ==
{{TemplateDataHeader}}
<templatedata>
Line 108 ⟶ 131:
"label": "English text",
"type": "string",
"description": "The word as translated into English. Note this will sometimes be the actual Japanese word if it has been adopted into English."
},
"2": {
Line 125 ⟶ 148:
"type": "string",
"description": "Adds extra text inside the parentheses. ",
"aliases": ["extra"]
"extra"
]
},
"5": {
"label": "Extra text outside parentheses",
"type": "string",
"description": "Adds extra text outside the parentheses. It is only useful in \";\" definitions (it will be displayed without bold, whereas text following the template, will getbe the boldbolded). Literal translations and linguistic glosses must use single quotation marks, not double.",
"aliases": ["extra2"]
"extra2"
]
},
"lead": {
"label": "FormattingLead formatting",
"type": "string",
"description": "ChangesIf set to yes, changes formatting style. Iffor setthe tofirst yesinstance of Japanese, usesusually leadin formattingthe lead. OtherwiseIt usesgives defaultthe formattingreader an idea what kind of non-English writing they are viewing.",
"suggestedvalues": [
"yes"
]
}
},
"paramOrder": [
"1",
"2",
"3",
"lead",
"4",
"5"
],
"format": "inline"
}
</templatedata>
 
<includeonly>{{Sandbox other||
=== See also ===
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
* {{tl|Nihongo4}}, the same as this template, but does not link to [[Help:Installing Japanese character sets]]
* {{tl|Nihongo3}}, essentially the same as this template, but gives rōmaji first and English inside the parentheses
* {{tl|Nihongo2}}, also displays the kanji properly, but without adding anything in parentheses, without rōmaji and without the extra parameters
* {{tl|Nihongo foot}}, same as this version, but puts everything but the English into a footnote
* {{tl|Ja icon}}, to label sources written in Japanese
* {{tl|Japanese}}, to request expert assistance with Japanese script
* {{tl|zh}}, for use with Chinese text
 
<includeonly>
<!-- CATEGORIES AND INTERWIKIS BELOW THIS LINE PLEASE -->
 
[[Category:Japonic multilingual support templates|{{PAGENAME}}]]
[[Category:WikiProject Japan templates|Nihongo]]
 
}}</includeonly>