Help:Extension:Translate/Group configuration/ja

メッセージ群を翻訳拡張機能に追加する方法はいくつかあります. ここではメッセージの集合をメッセージ群と呼びます. 通常はソフトウェアのモジュールとファイルに1対1で対応します (また対応は翻訳目的語ごとに1件. ) メッセージ群に他のメッセージ群を含ませることも可能です. 例えば特定のソフトウェア内のメッセージをすべてまとめたメッセージ群が作れます. あるいはまたMediaWiki の最重要なメッセージで必ず最初に翻訳するべきものなど、メッセージのサブセット限定でまとめる方法もあります. そのような高いレベルのメッセージ群はファイルとのマッピングに固有の形式がないものの、他のメッセージ群同様に他の翻訳ツールへの書き出しを Gettext 形式で実行できます.

翻訳者にとってメッセージ群は高いレベルの作業対象です. どの単一のメッセージを翻訳するか選ぶには、先にメッセージ群を決めるのが手順で、翻訳検索をした場合とは異なります. メッセージ群単位で固有の識別子が付き、統計の対象にできます. 当然ながらメッセージ群は翻訳者が一度に取り掛かる最小の文の集合です. メッセージ単位で識別子を与えてあり、これを通常はkey (キー) と呼びます. キーは複数のメッセージ群で共有しても問題ありません.

標準のメッセージ群の設定形式
YAML 形式を使ったメッセージ群の追加が簡単です. に追加する設定ファイルに名前空間を定義すればいいのです. 詳細は設定ページを参照してください. 例:

ファイル自体では YAML 構文が使用されます. ここでは構文の説明はしませんが習得は簡単で、既製のメッセージ群のすべてを例として利用できます. ただし字下げはタブではなく空きスペースを使用します. 各ファイル内に複数のメッセージ群を定義できます. メッセージ群定義の区切りは空行にダッシュ 3 個 (---) を記入する形で、これは標準的な YAML の文書区切りです.

定義文は上位項目に分類します. BASICFILESMANGLERVALIDATORSINSERTABLESTAGSAUTOLOADLANGUAGES に加え、特殊な TEMPLATE を使用します. カスタム メッセージ群には、さらに上位項目を追加する場合があります. すべてのメッセージ群にすべての上位項目を定義する必要はありません.

BASIC (基本)
この節では、一意の ID や名前など、メッセージ群に関する基本的な情報を扱います. 使用できるキー (*印は必須キーを示す):

例:

FILES (ファイル)
この節ではメッセージファイルのグループ種別が FileBasedMessageGroup の場合のファイルシステムのレイアウトとメッセージファイルの書式を解説します. 使用できるキーは以下のとおり (必須のキーは * 印付き):

The path variables are:

例:

MANGLER
キー修飾は複数のメッセージ群間でメッセージ キーの衝突を避けるため、メッセージ キーに修飾をつける方法の 1 つです:

例:

VALIDATORS (バリデーター)
This section allows to define pre-defined or custom validators.

INSERTABLES
This section allows to define a class which suggests insertables or use pre-defined insertables. The classes can be autoloaded as described in the AUTOLOAD section.

TAGS (タグ)
メッセージにタグを定義できます. タグはそれぞれ (キー修飾後)メッセージ キーのリストを伴います. "*" (アスタリスク) を使用したワイルドカード指定ができます. サポートするタグは以下の通りです:

例:

AUTOLOAD (自動読み込み)
This item takes list of class names with filenames as values. This way custom classes can be bundled easily with your custom message groups. The path should be relative to the location of the group configuration file itself.

例:

TEMPLATE (テンプレート)
複数のよく似たメッセージグループを定義する場合は、便利なショートカットが使えます. 重複を避けるには、1番目の定義の冒頭にこのキーを書きます. これに対応させて、上位のキーはどれでもサブキーとして使用でき. その他のグループはこれらの定義を既定値として使用することになります. もちろん、グループ単位でテンプレートの既定値を上書きできます.

例:

GROUPS (メッセージ群、AggregateMessageGroup クラス対応)
このキーは、このメッセージ群を構成するメッセージ群 ID のリストのみを取ります.

例:

Wildcards are supported. In this case the aggregate group will not recursively include itself even if it matches a pattern. Example:

Wildcards can be problematic if you have nested aggregate groups, because some groups can be included multiple times: both directly and via the included aggregate groups.

LANGUAGES (言語)
This key makes it possible to allow and disallow translation into specific languages for the group. Translation into disallowed languages will be blocked.

Allowed ("include") entries override any values in the disallowed ("exclude") list. If an allowed entry is  that means all languages are allowed. The allowed list is also optional.

ご利用のウィキ固有のインターフェイスメッセージ向けのメッセージ群
そのウィキに固有の、カスタム化したUIのメッセージグループの例として、地域化したサイドバーがあります. 以下のコードをご利用の  に記入し、wikiname 部分を該当する名称に書き換えます.

MediaWiki 拡張機能のショートカット
MediaWiki の単位グループ (units group for MediaWiki) を参照してください.