「テンプレート:Lang」の版間の差分

提供: Yourpedia
移動: 案内検索
(求人広告ユアデム (トーク) による版 347265 を取り消し)
 
(11人の利用者による、間の16版が非表示)
1行目: 1行目:
<includeonly><onlyinclude><span lang="{{{1}}}" xml:lang="{{{1}}}">{{{2}}}</span>{{{3|}}}&#32;<small></small></onlyinclude></includeonly><noinclude>
+
<span lang="{{{1}}}" xml:lang="{{{1}}}">{{{2}}}</span><noinclude>
<nowiki><span lang="{{{1}}}" xml:lang="{{{1}}}">{{{2}}}</span></nowiki>
+
 
{{Documentation}}
+
日本語以外の表記を行う際に、[[IETF言語タグ|言語タグ]]を明示的に指定して表示させるためのテンプレートです。このテンプレートを使うことで、漢字の[[グリフ]]([[字体]])の違いを表現したり、[[ハングル]]等の文字化けを防いだりできます。
<!-- Add Categories and Interwikis to the /doc subpage, NOT HERE! -->
+
 
 +
'''注意''' - インド系文字([[ブラーフミー系文字]])などの一部の文字を表示するには、本テンプレートでの言語タグ指定に加えて、お使いのコンピューターの[[オペレーティングシステム]]や[[ウェブブラウザー]]の設定が必要になる場合があります。詳しい情報は[[ヘルプ:特殊文字]]を参照してください。
 +
 
 +
__TOC__
 +
==使い方==
 +
<nowiki>{{Lang|言語タグ|文字列}}</nowiki>
 +
 
 +
==言語タグ==
 +
{{Main|IETF言語タグ}}
 +
 
 +
言語タグは[http://tools.ietf.org/html/bcp47 BCP 47]で定義されています。言語タグはハイフンで区切られた一連の下位タグ(subtag)から構成されます。このうちlanguageのみ必須で、それ以外は省略可です。下位タグは不要な場合には可能な限り省略することが推奨されます。
 +
 
 +
書式:''language-script-region-variant-extension-privateuse''
 +
 
 +
{| class="wikitable"
 +
|+ 言語タグの下位タグの一覧
 +
!下位タグ名!!指定内容!!説明
 +
|-
 +
!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を活用することによって、本テンプレートによって言語指定がされた文に特定のフォントを使用するよう指定することができます。
 +
 
 +
例:ロシア語の文に特定のフォントを指定する
 +
 
 +
  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|偉}}
 +
|}
 +
 
 +
==各言語用ショートカット==
 +
たとえば英語ならば、{{tnull|lang|en|life annuity}}と書く代わりに、専用テンプレート{{Tl|En}}を使い、{{Tnull|En|life annuity}}と書けます。一覧は{{Cat|言語タグテンプレート}}を見て下さい。
 +
 
 +
==脚注==
 +
{{Reflist}}
 +
 
 +
==関連項目==
 +
*{{Tl|lang属性}}
 +
*[[Yourpedia:Template メッセージの一覧/汎用#多言語の文字]]
 +
*{{Tl|Rtl-lang}} - 「右から左」の書字方向をもつ言語のためのテンプレート
 +
*{{Tl|script}} - 文字体系のみを指定するためのテンプレート
 +
*{{Tl|Llang}} - 言語名や読み方を併記できるテンプレート
 +
*{{Tl|ラテン翻字}} - 非ラテン文字の言語をラテン文字で表記する際に用いるテンプレート
 +
*[[ヘルプ:特殊文字]]
 +
*[[IETF言語タグ]]
 +
 
 +
==外部リンク==
 +
{{Commons|Template:Lang|Template:Lang}}
 +
*解説
 +
**[http://tools.ietf.org/html/bcp47 IETFによるBCP 47の説明]
 +
**[http://www.w3.org/International/articles/language-tags/Overview.en.php W3C による言語タグの解説]{{En icon}}
 +
**[http://www.w3.org/TR/i18n-html-tech-lang/ Internationalization Best Practices: Specifying Language in XHTML & HTML Content]{{En icon}}
 +
**[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 (地域コード)の一覧]
 +
 
 +
[[Category:多言語支援テンプレート]]
 +
[[Category:言語タグテンプレート|*]]
 
</noinclude>
 
</noinclude>

2017年12月27日 (水) 09:03時点における最新版

{{{2}}}

日本語以外の表記を行う際に、言語タグを明示的に指定して表示させるためのテンプレートです。このテンプレートを使うことで、漢字のグリフ字体)の違いを表現したり、ハングル等の文字化けを防いだりできます。

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

使い方[編集]

{{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:中国語、繁体字
    • ain-Kana:アイヌ語(仮名表記)
    • ain-Latn:アイヌ語(ラテン文字表記)
    • 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|偉}}
表示例

各言語用ショートカット[編集]

たとえば英語ならば、テンプレート:tnullと書く代わりに、専用テンプレート{{En}}を使い、テンプレート:Tnullと書けます。一覧はテンプレート:Catを見て下さい。

脚注[編集]

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

関連項目[編集]

外部リンク[編集]