View source for Template:Lang-x/doc

<noinclude>{{二次利用|ja}}</noinclude>
<includeonly>{{COinS safe|n}}</includeonly>
<!--テンプレート注記：xx-short が存在すれば自動で表示されます--><!--lang-xx-xxで10文字、lang-xx-shortで13文字-->
{{str ≤ len | {{BASEPAGENAME}}| 12|
 {{#ifexist:Template:{{BASEPAGENAME}}-short| {{notice| {{ISO639言語名|{{ucfirst:{{Str right|{{BASEPAGENAME}}|5}}}}}} 本テンプレート{{tl|{{BASEPAGENAME}}}}と、その略記版{{tl|{{BASEPAGENAME}}-short}}があります。}} |}} | {{notice| {{ISO639言語名|{{ucfirst:{{Str crop|{{Str right|{{BASEPAGENAME}}|5}}|6}}}}}} {{tl|{{Str crop|{{BASEPAGENAME}}|6}}}}と、その略記版の本テンプレート{{tl|{{BASEPAGENAME}}}}があります。}} }}
{{#ifeq:{{str rightc|{{BASEPAGENAME}}|5}}|short|{{注意|[[Wikipedia:表記ガイド#略語・略称]]では、リンク先に正式名称がある場合に省略形も許容していますが、同時に[[Wikipedia:ウィキペディアへの自己言及]]でリンクが使えない場合の配慮に言及しています。}}|}}

{{tlf|'''{{BASEPAGENAME}}'''|nolink=yes}}は、どの外国の言語であるかを読者に提示し、その言語の単語等を表示させるためのテンプレートです。このテンプレートを繰り返し用いる際は、何語であるかのリンクを逐次する必要はないので links 引数の使用を考慮してください。

==使用法==
<!--350以上の異なる言語のテンプレートから呼び出されている共通の解説文書です。一貫性に注意してください。-->
''文字列''のところに表示させたい外国語を入れます。

<big><code><nowiki>{{</nowiki>{{BASEPAGENAME}}|''文字列''}}</code></big>

;省略可能な引数
:linksは設定してもしなくてもよい引数です。
:<code><nowiki>{{</nowiki>{{BASEPAGENAME}}|''文字列''|links=no}}</code>

このテンプレートでは標準では各言語へのリンクが作られますが、{{Para|links|no}}を追加することで各言語へのリンクを抑制できます。

=== 使用例 ===
<!--350以上の異なる言語のテンプレートから呼び出されている共通の解説文書です。一貫性に注意してください。-->
{{#switch:{{lc:{{str left|{{BASEPAGENAME}}|7}}}}
|lang-en |lang-an = <!------- 英語の場合の例を表示 ------->
{{#switch:{{BASEPAGENAME}}
|Lang-ang  <!--- 古英語の場合 ---> 
|Lang-enm  <!--- 中世英語の場合 ---> 
|#default = <!--- 現代英語 --->
;編集画面での入力
:<code>[[ホワイトハウス]]は[[メイン州]]の[[ワシントンD.C.]]（<nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Washington, D.C.}}</nowiki>）に位置する。</code>

;実際の表示
:[[ホワイトハウス]]は[[メイン州]]の[[ワシントンD.C.]]（{{{{BASEPAGENAME}}|Washington, D.C.}}）に位置する。
}}

|lang-ko = <!------- ハングルの例を表示 ------->
;編集画面での入力（ハングルの場合）
:<code>朝鮮半島では漬物のキムチ (<nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|김치}}</nowiki>) が好んで食される。</code>

;実際の表示
:朝鮮半島では漬物のキムチ ({{{{BASEPAGENAME}}|김치}}) が好んで食される。

|lang-fr = <!------- フランス語の例を表示 ------->
;編集画面での入力（フランス語の場合）
:<code>ワインはフランスのボルドー (<nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Bordeaux}}</nowiki>) が有名。</code>

;実際の表示
:ワインはフランスのボルドー ({{{{BASEPAGENAME}}|Bordeaux}}) が有名。

|#default = <!------- デフォルトでドイツ語の例を表示 ------->
;編集画面での入力（ドイツ語での例）
:<code>ワイマールは連邦州のチューリンゲン（<nowiki>{{Lang-de|Thüringen}}</nowiki>）に位置する。</code>

;実際の表示
:ワイマールは連邦州のチューリンゲン（{{Lang-de|Thüringen}}）に位置する。

}}<!----- {{#switch:}} 終了 ----->

== 詳細 ==
<!--350以上の異なる言語のテンプレートから呼び出されている共通の解説文書です。一貫性に注意してください。-->
{{tlf|'''{{BASEPAGENAME}}'''|nolink=yes}}は、用語や句が、どの外国の言語であるかを読者に提示します。コンピューターに対しては、{{para|lang}}属性を指定し、これは[[:ja:IETF言語タグ|IETF言語タグ]]の仕様によって特定の言語だと解釈されます。各言語の一覧は[[:Category:言語ラベル]]にあります。

このテンプレートの使用によって、接頭に「○○語:」が付きます。これが不要な場合、コンピューターに対してのみ指定する[[:Category:言語タグテンプレート]]が用意されています。コンピューターに対して指定する理由は、[[:ja:Help:特殊文字|特殊文字]]の表示ですが、日本語や英語のように標準的に表示できる言語では指定する必要はありません。ごく一部の例外を除き、標準のパソコン環境で表示できるため、指定をしなければ表示できないということは少ないでしょう。

[[Wikipedia:記事どうしをつなぐ]]が過剰な内部リンクの抑制を定めています。従って「英語」のような一般的な語にリンクをする必要がありません。特に、繰り返してリンクされる必要はありません。2015年12月にリンクを省略する引数 links が追加されています。

{{#ifexpr:{{#if:{{{1|}}}{{{2|}}}{{{3|}}}{{{4|}}}{{{5|}}}|1|0}} or {{#ifeq:{{str rightc|{{BASEPAGENAME}}|5}}|short|{{#ifexist:{{str crop|{{FULLPAGENAME}}|6}}|1|0}}|0}} or {{#ifexist:{{FULLPAGENAME}}-short|1|0}}|
==関連テンプレート==
<!--350以上の異なる言語のテンプレートから呼び出されている共通の解説文書です。一貫性に注意してください。-->
{{{!}} class="wikitable" border="1"
{{!}}+ style="text-align:left;"{{!}}関連テンプレート一覧
! 種別 !! テンプレート !! 使用例 !! 表示例
{{!}}-
{{#ifeq:{{str rightc|{{BASEPAGENAME}}|5}}|short|{{#ifexist:{{str crop|{{FULLPAGENAME}}|6}}|
{{!}} 通常
{{!}}{{!}} {{tl|{{str crop|{{BASEPAGENAME}}|6}}}} {{!}}{{!}} <nowiki>{{</nowiki>{{str crop|{{BASEPAGENAME}}|6}}<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{str crop|{{BASEPAGENAME}}|6}}|''文字列''}} 
{{!}}-
}}}}
{{!}} {{#ifeq:{{str rightc|{{BASEPAGENAME}}|5}}|short|略記|通常}}
{{!}}{{!}} {{tl|{{BASEPAGENAME}}}} {{!}}{{!}} <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{BASEPAGENAME}}|''文字列''}} 
{{!}}-
{{#ifexist:{{FULLPAGENAME}}-short|
{{!}} 略記
{{!}}{{!}} {{tl|{{BASEPAGENAME}}-short}} {{!}}{{!}} <nowiki>{{</nowiki>{{BASEPAGENAME}}-short<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{BASEPAGENAME}}-short|''文字列''}} 
{{!}}-
}}
{{#if:{{{1|}}}|{{#ifexist:Template:{{{1}}}|{{#ifeq:{{{1}}}|{{BASEPAGENAME}}||{{#ifeq:{{{1}}}|{{str crop|{{BASEPAGENAME}}|6}}||
{{!}} 通常
{{!}}{{!}} {{tl|{{{1}}}}} {{!}}{{!}} <nowiki>{{</nowiki>{{{1}}}<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{1}}}|''文字列''}} 
{{!}}-
}}}}}}}}
{{#if:{{{1|}}}|{{#ifexist:Template:{{{1}}}-short|{{#ifeq:{{{1}}}-short|{{BASEPAGENAME}}||{{#ifeq:{{{1}}}-short|{{BASEPAGENAME}}-short||
{{!}} 略記
{{!}}{{!}} {{tl|{{{1}}}-short}} {{!}}{{!}} <nowiki>{{</nowiki>{{{1}}}-short<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{1}}}-short|''文字列''}} 
{{!}}-
}}}}}}}}
{{#if:{{{2|}}}|{{#ifexist:Template:{{{2}}}|{{#ifeq:{{{2}}}|{{BASEPAGENAME}}||{{#ifeq:{{{2}}}|{{str crop|{{BASEPAGENAME}}|6}}||
{{!}} 通常
{{!}}{{!}} {{tl|{{{2}}}}} {{!}}{{!}} <nowiki>{{</nowiki>{{{2}}}<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{2}}}|''文字列''}} 
{{!}}-
}}}}}}}}
{{#if:{{{2|}}}|{{#ifexist:Template:{{{2}}}-short|{{#ifeq:{{{2}}}-short|{{BASEPAGENAME}}||{{#ifeq:{{{2}}}-short|{{BASEPAGENAME}}-short||
{{!}} 略記
{{!}}{{!}} {{tl|{{{2}}}-short}} {{!}}{{!}} <nowiki>{{</nowiki>{{{2}}}-short<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{2}}}-short|''文字列''}} 
{{!}}-
}}}}}}}}
{{#if:{{{3|}}}|{{#ifexist:Template:{{{3}}}|{{#ifeq:{{{3}}}|{{BASEPAGENAME}}||{{#ifeq:{{{3}}}|{{str crop|{{BASEPAGENAME}}|6}}||
{{!}} 通常
{{!}}{{!}} {{tl|{{{3}}}}} {{!}}{{!}} <nowiki>{{</nowiki>{{{3}}}<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{3}}}|''文字列''}} 
{{!}}-
}}}}}}}}
{{#if:{{{3|}}}|{{#ifexist:Template:{{{3}}}-short|{{#ifeq:{{{3}}}-short|{{BASEPAGENAME}}||{{#ifeq:{{{3}}}-short|{{BASEPAGENAME}}-short||
{{!}} 略記
{{!}}{{!}} {{tl|{{{3}}}-short}} {{!}}{{!}} <nowiki>{{</nowiki>{{{3}}}-short<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{3}}}-short|''文字列''}} 
{{!}}-
}}}}}}}}
{{#if:{{{4|}}}|{{#ifexist:Template:{{{4}}}|{{#ifeq:{{{4}}}|{{BASEPAGENAME}}||{{#ifeq:{{{4}}}|{{str crop|{{BASEPAGENAME}}|6}}||
{{!}} 通常
{{!}}{{!}} {{tl|{{{4}}}}} {{!}}{{!}} <nowiki>{{</nowiki>{{{4}}}<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{4}}}|''文字列''}} 
{{!}}-
}}}}}}}}
{{#if:{{{4|}}}|{{#ifexist:Template:{{{4}}}-short|{{#ifeq:{{{4}}}-short|{{BASEPAGENAME}}||{{#ifeq:{{{4}}}-short|{{BASEPAGENAME}}-short||
{{!}} 略記
{{!}}{{!}} {{tl|{{{4}}}-short}} {{!}}{{!}} <nowiki>{{</nowiki>{{{4}}}-short<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{4}}}-short|''文字列''}} 
{{!}}-
}}}}}}}}
{{#if:{{{5|}}}|{{#ifexist:Template:{{{5}}}|{{#ifeq:{{{5}}}|{{BASEPAGENAME}}||{{#ifeq:{{{5}}}|{{str crop|{{BASEPAGENAME}}|6}}||
{{!}} 通常
{{!}}{{!}} {{tl|{{{5}}}}} {{!}}{{!}} <nowiki>{{</nowiki>{{{5}}}<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{5}}}|''文字列''}} 
{{!}}-
}}}}}}}}
{{#if:{{{5|}}}|{{#ifexist:Template:{{{5}}}-short|{{#ifeq:{{{5}}}-short|{{BASEPAGENAME}}||{{#ifeq:{{{5}}}-short|{{BASEPAGENAME}}-short||
{{!}} 略記
{{!}}{{!}} {{tl|{{{5}}}-short}} {{!}}{{!}} <nowiki>{{</nowiki>{{{5}}}-short<nowiki>|</nowiki>''文字列''<nowiki>}}</nowiki> {{!}}{{!}} {{{{{5}}}-short|''文字列''}} 
{{!}}-
}}}}}}}}
{{!}}} <!---- End of Wikitable ---->
}}
== 関連項目 ==
<!--350以上の異なる言語のテンプレートから呼び出されている共通の解説文書です。一貫性に注意してください。-->
* {{tl|Lang}}と{{tl|LangWithName}} このテンプレートから呼び出している。<!--テンプレート注記：xx icon が存在すれば自動で表示されます-->{{str ≤ len | {{BASEPAGENAME}}| 12
  |{{#ifexist:Template:{{ucfirst:{{Str right|{{BASEPAGENAME}}|5}}}}|
*{{tl|{{ucfirst:{{Str right|{{BASEPAGENAME}}|5}}}}}} {{tlf|Lang}}形式で言語の指定のみを行う。|}}
   {{#ifexist:Template:{{ucfirst:{{Str right|{{BASEPAGENAME}}|5}}}} icon|
*{{tl|{{ucfirst:{{Str right|{{BASEPAGENAME}}|5}}}} icon}} 外部リンクの言語を示す言語アイコン。 |}}

  |{{#ifexist:Template:{{ucfirst:{{Str crop|{{Str right|{{BASEPAGENAME}}|5}}|6}}}}|
*{{tl|{{ucfirst:{{Str crop|{{Str right|{{BASEPAGENAME}}|5}}|6}}}}}} {{tlf|Lang}}形式で言語の指定のみを行う。|}}
   {{#ifexist:Template:{{ucfirst:{{Str crop|{{Str right|{{BASEPAGENAME}}|5}}|6}}}} icon|
*{{tl|{{ucfirst:{{Str crop|{{Str right|{{BASEPAGENAME}}|5}}|6}}}} icon}} 外部リンクの言語を示す言語アイコン。|}}
}}
<includeonly>
[[Category:言語ラベル|{{#invoke:string|replace|source={{BASEPAGENAME}}|pattern=Lang-|replace=|count=1|plain=true}}]]</includeonly>
<noinclude>[[Category:テンプレート共通文書]]</noinclude>
<templatedata>
{
	"params": {
		"1": {
			"label": "表示文字",
			"description": "表示させたい文字を入力します",
			"example": "Template:enの例: sock",
			"type": "string",
			"required": true
		},
		"links": {
			"label": "言語名リンク",
			"description": "言語記事へのリンクが不要な場合は「no」と入力してください",
			"example": "no",
			"type": "string",
			"autovalue": "no"
		}
	},
	"description": "日本語以外の言語の文字列を、言語名を示しつつ適切なフォントや書字方式で表示します"
}
</templatedata>