テンプレート:Lang/docのソースを表示

<noinclude>{{Documentation subpage}}</noinclude><includeonly>{{Pp-template}}{{使用箇所の多いテンプレート|80,000以上}}</includeonly>
本文内で日本語以外の表記を行う際に、言語コードを明示的に指定して表示させるためのテンプレートです。このテンプレートを使うことで漢字の[[グリフ]]（[[字体]]）の違いを表現したり、[[ハングル]]等の文字化けを防いだりできます。

注：インド系文字（[[ブラーフミー系文字]]）などの一部の文字を表示するには本テンプレートでの言語コード指定に加えてお使いのコンピュータのオペレーティングシステムやウェブブラウザの設定が必要になる場合があります。詳しい情報は[[Help:特殊文字]]を参照してください。

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

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

言語タグは[http://tools.ietf.org/html/bcp47 BCP 47]で定義されています。言語タグはハイフンで区切られた一連の下位タグ (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>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を活用することによって、本テンプレートによって言語指定がされた文に特定のフォントを使用するよう指定することができます。

例：ロシア語の文に特定のフォントを指定する

  span[lang|=ru] { font-family: fonteskaya; }

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

  span[lang] { color: green; }

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

{| class="wikitable" style="margin:0 auto; text-align:center"
!!!日本語!!中国語!!中国語（台湾）!!韓国語
|-
|入力例||骨||<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"
!!!日本語!!中国語!!中国語（台湾）!!韓国語
|-
|入力例||近||<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"
!!!日本語!!中国語!!中国語（台湾）!!韓国語
|-
|入力例||偉||<nowiki>{{Lang|zh|偉}}</nowiki>||<nowiki>{{Lang|zh-tw|偉}}</nowiki>||<nowiki>{{Lang|ko|偉}}</nowiki>
|-
|表示例||偉||{{Lang|zh|偉}}||{{Lang|zh-tw|偉}}||{{Lang|ko|偉}}
|}

==脚注==
<references />

== 関連項目 ==
{{Commons|Template:Lang|Template:Lang}}
* [[Wikipedia:Template メッセージの一覧/汎用#多言語の文字]]
* {{tl|Llang}} - 言語名や読み方を併記できるテンプレート
* {{tl|ラテン翻字}}
* [[Help:特殊文字]]
* [[IETF言語タグ]]

== 外部リンク ==
*解説
**[http://tools.ietf.org/html/bcp47 IETF による BCP 47 の説明]
**[http://www.w3.org/International/articles/language-tags/Overview.en.php W3C による言語タグの解説]（英語）
**[http://www.w3.org/TR/i18n-html-tech-lang/ Internationalization Best Practices: Specifying Language in XHTML & HTML Content]（英語）
**[http://www.studyinghttp.net/rfc_ja/rfc3066.ja.html RFC 3066の和訳]
*コードの一覧
**[http://www.iana.org/assignments/language-subtag-registry IANA の言語下位タグのレジストリ]
**[http://unicode.org/iso15924/iso15924-codes.html ISO 15924（用字系コード）の一覧]
**[http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/index.html ISO 3166 （地域コード）の一覧]

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