API:Localisation/ja

このページはMediaWikiアクションAPI (api.php) の地域化に固有のものごとを記述します. MediaWiki 地域化に関する一般的なコメントは地域化を参照してください.

メッセージ ファイル
MediaWiki コアの地域化メッセージは 配下にあります. 拡張機能のメッセージは一般的な i18n ファイルに含まれるか、もしくは通常の複数のファイルのメカニズムを使う別のファイルにあります.

命名
API モジュール用のヘルプメッセージは「モジュールパス」つまりaction=helpの「モジュール」パラメータに用いる文字列を付けた名前空間に配します. モジュールを に追加した場合はその列に用いたキーと同一になり、追加先が、、 の場合は接頭辞「query+」を付けたキーを当てます.


 * 以前は[//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a49b8857e40e254e0af27fd281f3a2230 getDescription] 方式で返された説明文メッセージは、2分類されました. メッセージは1行でモジュールを要約したもの、 にはモジュールレベルの説明文があります. これらは対応するモジュールで上書きされる場合がありますが、それが必要な確率はとても低いです.
 * 1.30以前は、 メッセージを使用. これは[//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#aa0c499873fba5c934b98aae65e61a33d getDescriptionMessage]方式を適用すると上書きされるものの、それが必要な確率はとても低いです.
 * 以前は[//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a1d9406dc4a7b6e5b69554c492ee464f6 getParamDescription]方式で返されたパラメータ説明メッセージは、 になります (  は[//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams]に由来するキー. ) これは[//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams]から返ったデータ構造値を[//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#ab3a6e8b6e7cfbaf4f8bf4339a13d76c5  ]に設定すると上書きされます.
 * Parameters with a description similar to "When more results are available, use this to continue" should use api-help-param-continue instead of redefining a duplicate message.
 * Sorting parameters taking values "newer" and "older" (with related "start" and "end" parameters) should use api-help-param-direction instead of redefining a duplicate message.
 * Modules using CSRF tokens by implementing [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a9bd9dd747c20665d94b5939373b3f40c ] do not need to document the token parameter; this is automatically handled by ApiBase.
 * Several additional constants are available for use in [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a6806d2768e2bf6ea57e6b081bf4a9f9f getAllowedParams]; see ApiBase for details.
 * Parameters with an array for [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a345d7963199abd8893bd88015f7d4ed6 ] may use [//doc.wikimedia.org/mediawiki-core/master/php/classApiBase.html#a5a023b82d4aa17a44e33c1e8e2abdd6b  ] to specify that each value is individually documented. These messages are by default  . If the messages are named according to the default, there is no need to map messages to values in the   array (it still has to exist but can be left empty).
 * All examples must have a descriptive text. Message names should be along the lines of.

メッセージの説明文
内でメッセージの説明文を記述する際は、, ,  ,  ,   の各テンプレートを使用してください.

メッセージの整形
すべてのメッセージは、ピリオドで終わるようにすべきで、文法的な意味で「文」になるようにすべきです. 既定でメッセージに渡されるパラメーターについては、#メッセージの説明文 からリンクされているテンプレートを参照してください.

Use semantic wikitext markup in messages:


 * for mention of parameter keys, and also references to variables like $wgMiserMode.
 * for the possible values of parameters, mention of parameters with values (including references to other modules), and the mention of the input values in example docs.
 * for mention of keys or values in the API output.
 * for anything else that's computer code, e.g. "the  header" or "the page ".
 * You don't need additional quotation marks when using semantic markup.

If you need to reference other API modules, pipe a link to Special:ApiHelp and the help formatter will do the right thing. For example, " " is used in the documentation for various token parameters. The Special:ApiHelp link properly renders as an in-page anchored link if it's on the same help page (example). Similarly, reference to MediaWiki configuration variables such as $wgMiserMode should link to the documentation on mediawiki.org.

Pages referenced in examples should generally not be linked, as these links are unlikely to exist on many wikis.

エラーと警告
Errors are raised by calling  and the message can be localized in the usual way. Likewise for warnings with. 詳細は を参照してください.

慣習上、メッセージキーの先頭はAPI エラーメッセージが 、警告文は でそれぞれ始まります.

API レスポンス内のテキスト
ApiBaseおよびすべての API モジュールはそれ自体がコンテキストのソースでもあります. 一般に を使ってメッセージにアクセスする必要があり、API モジュール自体はIContextSourceが必要な場面で渡されます.

クライアントがそれを有用だと思うかもしれませんが、メッセージを任意に出力に含めるべきではありません.

translatewiki で地域化を改善
APIヘルプメッセージの翻訳は translatewiki.net,で追加や改善ができ、その他のMediaWikiコアのメッセージとやり方は同じです. 関連するメッセージグループには次のものを含みます.


 * MediaWiki 操作 API
 * API 機能の使用法

関連項目

 * API/Architecture_work/i18n – 草稿、旧来の API モジュールを新方式に変換する情報を含むもの.