View source for Template:Lang/doc

<noinclude>{{Documentation subpage}}</noinclude><includeonly>{{二次利用|ja}}</includeonly>
日本語以外の表記を行う際に、[[:ja:IETF言語タグ|言語タグ]]を明示的に指定して表示させるためのテンプレートです。指定することで、漢字の[[:ja:グリフ|グリフ]]（[[:ja:字体|字体]]）の違いを表現したり、[[:ja:ハングル|ハングル]]等の文字化けを防いだりできます。各言語のものは[[:Category:言語タグテンプレート]]にあります。右横書き文字には{{tl|Rtl-lang}}があります。

'''注意''' - 2014年にMicrosoftによる[[:ja:Microsoft Windows XP|Windows XP]]のサポートが切れており、[[:ja:Microsoft Windows Vista|Windows Vista]]などそれ以降のOSでは、標準的に多くのフォントが表示できます。インド系文字（[[:ja:ブラーフミー系文字|ブラーフミー系文字]]）などの一部の文字を表示するには、本テンプレートでの言語タグ指定に加えて、お使いのコンピューターの設定が必要になる場合があります。詳しい情報は[[:ja:Help:特殊文字]]や[[:ja:Help:MediaWikiに適応するブラウザ]]を参照してください。

__TOC__

==使い方==
:<code><nowiki>{{lang|言語タグ|文字列}}</nowiki></code>

==言語タグ==
{{see also|:ja:IETF言語タグ}}

言語タグは[http://tools.ietf.org/html/bcp47 BCP 47]{{en icon}}で定義されています。言語タグはハイフンで区切られた一連の下位タグ (subtag) から構成されます。このうち language のみ必須で、それ以外は省略可です。下位タグは不要な場合には可能な限り省略することが推奨されます。

書式： ''language-script-region-variant-extension-privateuse''

{|class="wikitable" border="1"
|+ 言語タグの下位タグの一覧
!下位タグ名 !!指定内容 !!説明
|-
!language
|[[ISO 639]]（言語名コード） ||言語の特定を避けたい場合は und (undetermined、「非決定」の略）を指定できる。<br />小文字で書くことが推奨される。
|-
!script
|[[ISO 15924]]（用字系コード） ||省略された場合にはその言語の基本の用字系が選択される。<br />1文字目を大文字で書くことが推奨される。
|-
!region
|[[ISO 3166-1]]（国名コード）<br />[[ISO 3166]]（地域名コード）||大文字で書くことが推奨される。
|-
!variant
|||方言など、上記の下位タグでカバーしきれない情報を示す。
|-
!extension
|||（予約領域）
|-
!privateuse
|||（私的領域。ウィキペディアでは使用されていない）
|}

===言語タグの例===
''language'' のみの例
*<code>en</code> : 英語
*<code>ko</code> : 朝鮮語
*<code>zh</code> : 中国語

''language-region'' の例
*<code>en-GB</code> : イギリスで用いられている英語
*<code>ko-KP</code> : 朝鮮民主主義人民共和国で用いられている朝鮮語
*<code>zh-TW</code> : 台湾で用いられている中国語
*<code>es-005</code> : 南米で用いられているスペイン語

''language-script'' の例
*<code>ar-Latn</code> : アラビア語、ラテン文字転写
*<code>zh-Hans</code> : 中国語、簡体字
*<code>zh-Hant</code> : 中国語、繁体字
*<code>ain-Kana</code> : アイヌ語（仮名表記）
*<code>ain-Latn</code> : アイヌ語（ラテン文字表記）
*<code>und-Hant</code> : 言語非決定、繁体字（伝統字）<ref>RFC3066では、"You SHOULD NOT use the UND (Undetermined) code unless the protocol in use forces you to give a value for the language tag, even if the language is unknown.  Omitting the tag is preferred."（「もし使用するプロトコルが言語タグについて値を与える事を強制するのでなければ、たとえその言語が不明であっても、UND (Undetermined) というコードを使用すべきではない。その場合、タグを省略すべきである。 」） としていることに注意。</ref>

''language-script-region'' の例
*<code>zh-Hant-HK</code> : 香港で用いられている中国語、繁体字

''language-variant'' ほかの例
*<code>sl-nedis</code> : スロベニア語 Nadiza 方言
*<code>de-CH-1901</code> : スイスで使用されるドイツ語、1901年版[[正書法]]利用

==用途==
言語タグは以下の用途に用いられます。一般的な読者にとっては、表示するフォントの決定に重要であり、書式があるからといって一般的に利用されない指定を行ってもそれを読み取るコンピュータがありません。

*ウェブブラウザーが、どのフォントを用いるかを判断します。
*[[アクセシビリティ]]。スクリーンリーダーが正しく発音するのに利用します。
*スペルチェッカーや文法チェッカー。
*ウェブブラウザーがどの字体・引用符・ハイフンなどを用いるかを判断する。
*スタイルシートで特定の言語の色を変更できます（[[#スタイルシートの適用]]を参照）。執筆者の手助けになります。
*検索エンジンが文章をインデックスする際に利用できます。
*ウィキペディアを再利用する出版社・開発者などが利用できます。
*ウィキペディアにおける利用言語の統計に利用できます。

==スタイルシートの適用==
登録ユーザーは、個人設定のユーザーCSSを活用することによって、本テンプレートによって言語指定がされた文に特定のフォントを使用するよう指定することができます。
{{Main|:ja:Help:外装の詳細設定}}
例：ロシア語の文に特定のフォントを指定する

:<code>span[lang|=ru] { font-family: fonteskaya; }</code>

例：言語指定された文すべてにおいて色を変更する

:<code>span[lang] { color: green; }</code>

==使用例==
===例1：「骨」===
「骨」という字のグリフは日本語と中国語では左右対称となっています。

{|class="wikitable" style="margin:0 auto; text-align:center; font-size: large"
!!!日本語!!中国語!!中国語（台湾）!!朝鮮語
|-
!入力例
|骨||<nowiki>{{Lang|zh|骨}}</nowiki>||<nowiki>{{Lang|zh-tw|骨}}</nowiki>||<nowiki>{{Lang|ko|骨}}</nowiki>
|-
!表示例
|骨||{{Lang|zh|骨}}||{{Lang|zh-tw|骨}}||{{Lang|ko|骨}}
|}

===例2：「近」===
「近」という字のグリフは日本語と中国語では1点[[辵部|しんにょう]]ですが、朝鮮語では2点しんにょうです。

また、中国語（台湾）ではくねくねとした1点しんにょうとなっています（または2点しんにょう）。

{|class="wikitable" style="margin:0 auto; text-align:center; font-size: large"
!!!日本語!!中国語!!中国語（台湾）!!朝鮮語
|-
!入力例
|近||<nowiki>{{Lang|zh|近}}</nowiki>||<nowiki>{{Lang|zh-tw|近}}</nowiki>||<nowiki>{{Lang|ko|近}}</nowiki>
|-
!表示例
|近||{{Lang|zh|近}}||{{Lang|zh-tw|近}}||{{Lang|ko|近}}
|}

===例3：「偉」===
「偉」という字のグリフは日本語と中国語では「韋」の形が異なっています。

{|class="wikitable" style="margin:0 auto; text-align:center; font-size: large"
!!!日本語!!中国語!!中国語（台湾）!!朝鮮語
|-
!入力例
|偉||<nowiki>{{Lang|zh|偉}}</nowiki>||<nowiki>{{Lang|zh-tw|偉}}</nowiki>||<nowiki>{{Lang|ko|偉}}</nowiki>
|-
!表示例
|偉||{{Lang|zh|偉}}||{{Lang|zh-tw|偉}}||{{Lang|ko|偉}}
|}
<!--
===例4：補足===
3番目のパラメータで補足説明を表示することが出来ます。

{|class="wikitable" style="margin:0 auto; text-align:center; font-size: large"
!入力例
|<source lang="wiki" inline>{{Lang|zh|维基百科|- 簡体中文で「ウィキペディア」はこう書きます}}</source>
|-
!表示例
|{{Lang|zh|维基百科|- 簡体中文で「ウィキペディア」はこう書きます}}
|}
-->

==各言語用ショートカット==
たとえば英語ならば、{{tlc|lang|en|life annuity}}と書く代わりに、専用テンプレート{{tl|En}}を使い、{{tlc|En|life annuity}}と書けます。一覧は{{cat|言語タグテンプレート}}を見て下さい。

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>
{
	"description": "日本語以外の表記を行う際に、IETF言語タグを明示的に指定して表示させるためのテンプレート。",
	"params": {
		"1": {
			"label": "言語タグ",
			"description": "表示する言語を指定するためのIETF言語タグ",
			"type": "line",
			"required": true,
			"example": "en"
		},
		"2": {
			"label": "表示する文字列",
			"description": "指定した言語で記述された文字列",
			"type": "string",
			"required": true,
			"example": "Wikipedia"
		},
		"3": {
			"label": "補足",
			"description": "「表示する文字列」に続いて、小さなフォントで説明などを付加する場合に使用します（言語タグは適用されません）。",
			"type": "line",
			"example": "ウィキペディア"
		}
	},
	"format": "inline"
}
</templatedata>

==脚注==
{{Reflist}}

==関連項目==
*{{tl|lang属性}}
*{{tl|lang-*}}
*{{tl|lang-*-Latn}}
*[[Wikipedia:Template メッセージの一覧/汎用#多言語の文字]]
*{{tl|Rtl-lang}} - 「右から左」の書字方向をもつ言語のためのテンプレート
*{{tl|script}} - 文字体系のみを指定するためのテンプレート
*{{tl|Llang}} - 言語名や読み方を併記できるテンプレート
*{{tl|ラテン翻字}} - 非ラテン文字の言語をラテン文字で表記する際に用いるテンプレート
*[[:ja:Help:特殊文字]]
*[[:ja:IETF言語タグ]]

==外部リンク==
{{Commons|Template:Lang|Template:Lang}}
;解説
*[http://tools.ietf.org/html/bcp47 BCP 47 - Tags for Identifying Languages]{{en icon}}(IETF) BCP 47 の説明
*[https://www.w3.org/International/articles/language-tags/ HTMLとXMLにおける言語タグ] (W3C)
*[https://www.w3.org/International/articles/language-tags/Overview.en.php Language tags in HTML and XML]{{en icon}}(W3C)言語タグの解説
*[https://www.w3.org/TR/i18n-html-tech-lang/ Internationalization Best Practices: Specifying Language in XHTML & HTML Content]{{en icon}}(W3C)
*[http://www.studyinghttp.net/rfc_ja/rfc3066.ja.html RFC 3066の和訳]
;コードの一覧
*[https://www.iana.org/assignments/language-subtag-registry IANA の言語下位タグのレジストリ]
*[https://unicode.org/iso15924/iso15924-codes.html ISO 15924（用字系コード）の一覧]
*[https://www.iso.org/iso-3166-country-codes.html ISO 3166 （地域コード）の一覧]

<includeonly>
<!-- カテゴリは以下に記入してください -->
{{デフォルトソート:{{PAGENAME}}}}
[[Category:多言語支援テンプレート]]
[[Category:言語タグテンプレート|*]]
</includeonly>