Extension:CLDR

MediaWiki 拡張機能マニュアル

CLDR リリースの状態: 安定
説明	言語コードに基づいて言語、国、通貨、および時間単位の名前をローカライズする関数を提供します。
作者	Niklas Laxström Siebrand Mazeland Ryan Kaldari Sam Reed
最新バージョン	4.17.0 (継続的な更新)
MediaWiki	1.30+
データベースの変更	いいえ
Composer	mediawiki/cldr
ライセンス	GPL-2.0-or-later, data variant of BSD 3-clauses
ダウンロード	言語拡張機能バンドルに含まれるもの或いは 拡張機能をダウンロード Git [?]: リポジトリを参照 (Phabricator · GitHub) Gerrit コード レビュー Git コミット ログ Download source tarball README
例	Translatewiki.net
使用するフック GetHumanTimestamp LanguageGetTranslatedLanguageNames
master
使用中の公開ウィキ	6,625 (Ranked 63rd)
translatewiki.net で翻訳を利用できる場合は、CLDR 拡張機能の翻訳にご協力ください

CLDR拡張機能は、 CLDRから抽出した様々な言語、国、通貨、時間単位のローカル名を提供します。 情報については translatewiki:CLDR を参照してください。

インストール

• ダウンロードして、ファイルをextensions/フォルダー内のcldrという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/cldr
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'cldr' );
  

• 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

git からダウンロードする場合は、ファイルを CLDR から cldr に変更します。

データの更新

CLDR 拡張機能には、言語ファイルにあらかじめ入力されたデータが付いていますが、Unicode コンソーシアムから最新のデータを取得する場合は、CLDR サイトからダウンロードしてから、再構築スクリプトを実行する必要があります。

CLDR サイトから最新のデータをダウンロードします:

http://www.unicode.org/cldr/repository_access.html

例 (cldr ディレクトリ内で):

wget https://www.unicode.org/Public/cldr/latest/core.zip
unzip core.zip -d core
php rebuild.php

使用法とパラメーター

言語名

CLDR は、static メソッド getNames() を持つクラス LanguageNames を定義します。 LanguageNames::getNames は以下の3つのパラメーターを受け取ります:

1. code – 一覧を返す条件として選択した言語のISO 639コード（コードの詳細はマニュアル:言語#言語コードを参照）
2. fbMethod – 代替方式は以下のいずれかに必ず設定：
   • LanguageNames::FALLBACK_NATIVE - 原語名の代替が欠落した項目（規定）
   • LanguageNames::FALLBACK_NORMAL - 一連の代替と対比して抽出された代替が欠落した項目
3. list – 値を返す言語の設定。 以下のいずれかを条件として必ず選択：
   • LanguageNames::LIST_MW_SUPPORTED - MediaWiki でローカライズ済みの言語に限定
   • LanguageNames::LIST_MW - Names.php (既定値) に掲載されたすべての言語
   • LanguageNames::LIST_MW_AND_CLDR - MediaWiki もしくは CLDR に収載されたすべての言語

例

言語名はMediaWikiのコア機能でのアクセスが推奨されます:

// Japanisch
$name = Language::fetchLanguageName( 'ja', 'de', 'all' );

国名

CLDR は、static メソッド CountryNames を持つクラス CountryNames を定義します。 CountryNames::getNames は以下の1つのパラメーターを受け取ります:

1. code - 選択した言語のISO 639コードに一致する一覧を返す

例

次の例では変数にCLDRの国のリストをフランス語で指定しています。

if ( is_callable( array( 'CountryNames', 'getNames' ) ) ) {
    $countries = CountryNames::getNames( 'fr' );
}

関連項目

• Extension:I18nTags
• Extension:Babel