<span lang="{{{1}}}" xml:lang="{{{1}}}">{{{2}}}</span>.mw-parser-output .documentation,.mw-parser-output .documentation-metadata{border:1px solid #a2a9b1;background-color:#ecfcf4;clear:both}.mw-parser-output .documentation{margin:1em 0 0 0;padding:1em}.mw-parser-output .documentation-metadata{margin:0.2em 0;font-style:italic;padding:0.4em 1em}.mw-parser-output .documentation-startbox{padding-bottom:3px;border-bottom:1px solid #aaa;margin-bottom:1ex}.mw-parser-output .documentation-heading{font-weight:bold;font-size:125%}.mw-parser-output .documentation-clear{clear:both}.mw-parser-output .documentation-toolbar{font-style:normal;font-size:85%} テンプレートの解説[表示] [編集] [履歴] [キャッシュを破棄].mw-parser-output .ombox{margin:4px 0;border-collapse:collapse;border:1px solid #a2a9b1;background-color:#f8f9fa;box-sizing:border-box}.mw-parser-output .ombox.mbox-small{font-size:88%;line-height:1.25em}.mw-parser-output .ombox-speedy{border:2px solid #b32424;background-color:#fee7e6}.mw-parser-output .ombox-delete{border:2px solid #b32424}.mw-parser-output .ombox-content{border:1px solid #f28500}.mw-parser-output .ombox-style{border:1px solid #fc3}.mw-parser-output .ombox-move{border:1px solid #9932cc}.mw-parser-output .ombox-protection{border:2px solid #a2a9b1}.mw-parser-output .ombox .mbox-text{border:none;padding:0.25em 0.9em;width:100%;font-size:90%}.mw-parser-output .ombox .mbox-image{border:none;padding:2px 0 2px 0.9em;text-align:center}.mw-parser-output .ombox .mbox-imageright{border:none;padding:2px 0.9em 2px 0;text-align:center}.mw-parser-output .ombox .mbox-empty-cell{border:none;padding:0;width:1px}.mw-parser-output .ombox .mbox-invalid-type{text-align:center}@media(min-width:720px){.mw-parser-output .ombox{margin:4px 10%}.mw-parser-output .ombox.mbox-small{clear:right;float:right;margin:4px 0 4px 1em;width:238px}}

このテンプレートは300,000以上のページで使われています。
余計な混乱やサーバーへの負荷を避けるために、どんな変更でも最初はテンプレートのサンドボックス・サブページ、テストケース・サブページもしくはあなた自身の利用者スペースのページで試すべきです。そうすれば、試した変更を1度の編集でこのテンプレートに加えることができます。しかし、最初にあなたの提案した変更を、この項目のノートで議論するようにお願いします。

このテンプレートは、出典表記形式1や出典表記形式2のような出典テンプレートに用いるべきではありません。なぜなら、マークアップが含まれており、生成されるCOinSメタデータを書き換えてしまうからです（Wikipedia:COinSも参照）。

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

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

言語タグはBCP 47（英語）で定義されています。言語タグはハイフンで区切られた一連の下位タグ (subtag) から構成されます。このうち language（言語名コード）のみ必須で、それ以外は省略可です。下位タグは不要な場合には可能な限り省略することが推奨されます。使用可能な下位タグはInternet Assigned Numbers Authority（IANA）が公開している Language Subtag Registry を参照してください。

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

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

言語タグの例

language のみの例

en : 英語

ko : 朝鮮語

zh : 中国語

language-region の例

en-GB : イギリスで用いられている英語

ko-KR : 韓国で用いられている韓国語

ko-KP : 北朝鮮で用いられている朝鮮語

zh-CN : 中国（本土）で用いられている簡体字中国語

zh-HK : 香港で用いられている繁体字中国語

zh-TW : 台湾で用いられている繁体字中国語

es-005 : 南米で用いられているスペイン語

language-script の例

ar-Latn : アラビア語、ラテン文字転写

zh-Hans : 中国語、簡体字

zh-Hant : 中国語、繁体字

ain-Kana : アイヌ語（仮名表記）

ain-Latn : アイヌ語（ラテン文字表記）

und-Hant : 言語非決定、繁体字（伝統字）[1]

language-script-region の例

zh-Hant-HK : 香港で用いられている中国語、繁体字

language-variant ほかの例

sl-nedis : スロベニア語 Nadiza 方言

de-CH-1901 : スイスで使用されるドイツ語、1901年版正書法利用

用途

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

ウェブブラウザーが、どのフォントを用いるかを判断します。

アクセシビリティ。スクリーンリーダーが正しく発音するのに利用します。

スペルチェッカーや文法チェッカー。

ウェブブラウザーがどの字体・引用符・ハイフンなどを用いるかを判断する。

スタイルシートで特定の言語の色を変更できます（#スタイルシートの適用を参照）。執筆者の手助けになります。

検索エンジンが文章をインデックスする際に利用できます。

ウィキペディアを再利用する出版社・開発者などが利用できます。

ウィキペディアにおける利用言語の統計に利用できます。

スタイルシートの適用

登録ユーザーは、個人設定のユーザーCSSを活用することによって、本テンプレートによって言語指定がされた文に特定のフォントを使用するよう指定することができます。詳細は「Help:外装の詳細設定」を参照

例：ロシア語の文に特定のフォントを指定する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|偉}}
表示例偉偉偉偉

各言語用ショートカット

たとえば英語ならば、{{lang|en|life annuity}}と書く代わりに、専用テンプレート{{En}}を使い、{{En|life annuity}}と書けます。一覧はCategory:言語タグテンプレートを見て下さい。
TemplateDataこれはビジュアルエディターやテンプレートウィザードにより使用されるテンプレートのためのTemplateData文書です。

Lang

日本語以外の表記を行う際に、IETF言語タグを明示的に指定して表示させるためのテンプレート。

テンプレートパラメーター[テンプレートデータを編集]

このテンプレートは、パラメーターを1行で記述することが推奨されています。パラメーター説明型状態
言語タグ1

表示する言語を指定するためのIETF言語タグ
例
en行必須
表示する文字列2

指定した言語で記述された文字列
例
Wikipedia文字列必須
補足3

「表示する文字列」に続いて、小さなフォントで説明などを付加する場合に使用します（言語タグは適用されません）。
例
ウィキペディア行省略可能

脚注^ 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) というコードを使用すべきではない。その場合、タグを省略すべきである。 」） としていることに注意。

関連項目

{{lang属性}}

{{lang-*}}

{{lang-*-Latn}}

Wikipedia:Template メッセージの一覧/汎用#多言語の文字

{{Rtl-lang}} - 「右から左」の書字方向をもつ言語のためのテンプレート

{{script}} - 文字体系のみを指定するためのテンプレート