テンプレート:Lang/doc
このページは、テンプレートの解説ページです。このページを直接参照すると、リンク先のページ名やURLを変数で指定しているリンクが赤リンクになる場合がありますが、リンク先を指定し直さなくてよい場合もあります。リンクの設定の不具合に関する質問等は親ページの会話ページに投稿して下さい。 |
本文内で日本語以外の表記を行う際に、言語コードを明示的に指定して表示させるためのテンプレートです。このテンプレートを使うことで漢字のグリフ(字体)の違いを表現したり、ハングル等の文字化けを防いだりできます。
注:インド系文字(ブラーフミー系文字)などの一部の文字を表示するには本テンプレートでの言語コード指定に加えてお使いのコンピュータのオペレーティングシステムやウェブブラウザの設定が必要になる場合があります。詳しい情報はHelp:特殊文字を参照してください。
目次
使い方[編集]
{{lang|言語タグ|文字列}}
言語タグ[編集]
IETF言語タグ も参照
言語タグはBCP 47で定義されています。言語タグはハイフンで区切られた一連の下位タグ (subtag) から構成されます。このうち language のみ必須で、それ以外は省略可です。下位タグは不要な場合には可能な限り省略することが推奨されます。
書式: language-script-region-variant-extension-privateuse
下位タグ名 | 指定内容 | 説明 |
---|---|---|
language | ISO 639(言語名コード) | 言語の特定を避けたい場合は und (undetermined、「非決定」の略)を指定できる。 小文字で書くことが推奨される。 |
script | ISO 15924(用字系コード) | 省略された場合にはその言語の基本の用字系が選択される。 1文字目を大文字で書くことが推奨される。 |
region | ISO 3166-1(国名コード) ISO 3166(地域名コード) |
大文字で書くことが推奨される。 |
variant | 方言など、上記の下位タグでカバーしきれない情報を示す。 | |
extension | (予約領域) | |
privateuse | (私的領域。ウィキペディアでは使用されていない) |
言語タグの例[編集]
- 単純な例 (language)
en
: 英語ko
: 韓国語zh
: 中国語
- language-region の例
en-GB
: イギリスで用いられている英語ko-KP
: 朝鮮民主主義人民共和国で用いられている韓国語(南北における差異があまり大きくないため、通常は用いられない)zh-TW
: 台湾で用いられている中国語es-005
: 南米で用いられているスペイン語
- language-script の例
ar-Latn
: アラビア語、ラテン文字転写zh-Hans
: 中国語、簡体字zh-Hant
: 中国語、繁体字und-Hant
: 言語非決定、繁体字(伝統字)[1]
- language-script-region の例
zh-Hant-HK
: 香港で用いられている中国語、繁体字
- language-variant ほかの例
sl-nedis
: スロベニア語 Nadiza 方言de-CH-1901
: スイスで使用されるドイツ語、1901年版正書法利用
用途[編集]
言語タグは以下の用途に用いられます。
- ウェブブラウザがどのフォントなどを用いるかを決定する判断材料として利用します。
- アクセシビリティ。スクリーンリーダーが正しく発音するのに利用します。
- スペルチェッカや文法チェッカ。
- ウェブブラウザがどの字体・引用符・ハイフンなどを用いるかを決定する判断材料として利用します。
- スタイルシートで特定の言語の色を変更できます(#スタイルシートの適用を参照)。執筆者の手助けになります。
- 検索エンジンが文章をインデックスする際に利用できます。
- ウィキペディアを再利用する出版社・開発者などが利用できます。
- ウィキペディアにおける利用言語の統計に利用できます。
スタイルシートの適用[編集]
登録ユーザーは、個人設定のユーザーCSSを活用することによって、本テンプレートによって言語指定がされた文に特定のフォントを使用するよう指定することができます。
例:ロシア語の文に特定のフォントを指定する
span[lang|=ru] { font-family: fonteskaya; }
例:言語指定された文すべてにおいて色を変更する
span[lang] { color: green; }
使用例[編集]
例1:「骨」[編集]
「骨」という字のグリフは日本語と中国語では左右対称となっている。
日本語 | 中国語 | 中国語(台湾) | 韓国語 | |
---|---|---|---|---|
入力例 | 骨 | {{Lang|zh|骨}} | {{Lang|zh-tw|骨}} | {{Lang|ko|骨}} |
表示例 | 骨 | 骨 | 骨 | 骨 |
例2:「近」[編集]
「近」という字のグリフは日本語と中国語では1点しんにょうだが、韓国語では2点しんにょうである。
また、中国語(台湾)ではくねくねとした1点しんにょうとなっている(または2点しんにょう)。
日本語 | 中国語 | 中国語(台湾) | 韓国語 | |
---|---|---|---|---|
入力例 | 近 | {{Lang|zh|近}} | {{Lang|zh-tw|近}} | {{Lang|ko|近}} |
表示例 | 近 | 近 | 近 | 近 |
例3:「偉」[編集]
「偉」という字のグリフは日本語と中国語では「韋」の形が異なっている。
日本語 | 中国語 | 中国語(台湾) | 韓国語 | |
---|---|---|---|---|
入力例 | 偉 | {{Lang|zh|偉}} | {{Lang|zh-tw|偉}} | {{Lang|ko|偉}} |
表示例 | 偉 | 偉 | 偉 | 偉 |
脚注[編集]
- ↑ 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) というコードを使用すべきではない。その場合、タグを省略すべきである。 」) としていることに注意。
関連項目[編集]
- Wikipedia:Template メッセージの一覧/汎用#多言語の文字
- {{Llang}} - 言語名や読み方を併記できるテンプレート
- {{ラテン翻字}}
- Help:特殊文字
- IETF言語タグ
外部リンク[編集]
- 解説
- コードの一覧