Extension:CLDR

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:CLDR and the translation is 41% complete.

Other languages:
English • ‎dansk • ‎español • ‎русский • ‎中文 • ‎日本語
MediaWiki 拡張機能マニュアル
OOjs UI icon advanced.svg
CLDR
リリースの状態: 安定
ExampleOfCLDRExtension.png
実装 パーサー関数
説明 Provides functions to localize the names of languages, countries, currencies, and time units based on their language code.
作者
最新バージョン 4.3.0 (CLDR 29) (Continous updates)
MediaWiki 1.30+
データベースの変更 いいえ
Composer mediawiki/cldr
ライセンス GPL-2.0+, data variant of BSD 3-clauses
ダウンロード Included in Language Extension Bundle or
README
Translatewiki.net
translatewiki.net で翻訳を利用できる場合は、CLDR 拡張機能の翻訳にご協力ください
使用状況とバージョン マトリクスを確認してください。

The CLDR extension contains local language names for different languages, countries, currencies, and time units extracted from CLDR data. 情報については translatewiki:CLDR を参照してください。

インストール

  • ダウンロードして、ファイルを extensions/ フォルダー内の cldr という名前のディレクトリ内に配置します。
  • 以下のコードを LocalSettings.php の末尾に追加します:
    wfLoadExtension( 'cldr' );
    
  • Yes 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

MediaWiki 1.26 以前を稼働させている利用者へ:

上記の手順では、wfLoadExtension() を使用してこの拡張機能をインストールする新しい方法を記載しています。 この拡張機能をこれらの過去のバージョン (MediaWiki 1.26 以前) にインストールする必要がある場合は、wfLoadExtension( 'cldr' ); の代わりに以下を使用する必要があります:

require_once "$IP/extensions/cldr/cldr.php";

データの更新

The CLDR extension comes with data pre-populated in the language files, but if you want to get the latest data from the Unicode Consortium, you'll need to download it from the CLDR site and then run a rebuild script.

Download newest data from CLDR site:

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

Example (from within the cldr directory):

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

使用法とパラメーター

言語名

CLDR defines the class LanguageNames which has a static method, getNames(). LanguageNames::getNames accepts three parameters:

  1. code - the ISO 639 (see here for details) code of the preferred language to return the list in
  2. fbMethod - fallback method. Should be set to one of the following:
    • LanguageNames::FALLBACK_NATIVE (default): Missing entries fallback to the native name
    • LanguageNames::FALLBACK_NORMAL: Missing entries fallback through the fallback chain
  3. list - which languages to return. Should be set to one of the following:
    • LanguageNames::LIST_MW_SUPPORTED: Only languages that have localization in MediaWiki
    • LanguageNames::LIST_MW (default): All languages that are in Names.php
    • LanguageNames::LIST_MW_AND_CLDR: All languages that are either in MediaWiki or in CLDR

The language names are best access with MediaWiki core functions:

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

国名

CLDR defines the class CountryNames which has a static method, getNames(). CountryNames::getNames accepts one parameter:

  1. code - the ISO 639 code of the preferred language to return the list in

The following example sets a variable to the list of all countries in CLDR in French.

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

通貨名

CLDR defines the class CurrencyNames which has a static method, getNames(). CurrencyNames::getNames accepts one parameter:

  1. code - the ISO 639 code of the preferred language to return the list in

The following example sets a variable to the list of all currencies in CLDR in German.

if ( is_callable( array( 'CurrencyNames', 'getNames' ) ) ) {
    $currencies = CurrencyNames::getNames( 'de' );
}
CLDR includes a very large number of currencies, including many that are no longer in use.


関連項目