Manual:Variable/ja


 * このページでは変数の作成方法について説明されています. 既定の変数については、Help:Variables/ja を参照してください. MediaWiki が内部的に使用する PHP グローバル変数については、Manual:wg variable/ja を参照してください. ''

変数は小さなwikitextでテンプレートのようなものですが、パラメーターを持たず、決め打ちされた値が割り当てられます. 標準的なwikiのマークアップ、例えば または などは変数の例です. 独自のカスタム変数を定義することでwikiマークアップを拡張することも出来ます.

用語は多少間違っています. 変数について変えられるものが存在しないからです. エンドユーザは変数の値を変更することは出来ません. 値を計算するたくさんのPHPコードによってあらかじめ決定されているからです. "変数(variable)"という用語は「変わる(vary)」に由来しています: php変数または変数に割り当てることができるもの、例えば、文字列、数字、式、または関数の戻り値です.

カスタム変数を定義する
変数はマジックワードの特別な場合で、最初の段階でマジックワードとして変数を定義します:


 * 1) 変数のためにマジックワードIDを選択する.  これは変数定義の様々な部分を結びつけるために使用される内部の識別子のみです: wikiテキストで現れる名前と値を変数に割り当てるPHPコードです. 拡張機能によって独自に関係にあるIDを選択することが最善で他の拡張機能によって使用される他のマジックワードIDと混同することはありそうにないでしょう. 共通の戦略は のようなものを使用することです. canonicalnameは拡張機能で登録する名前です(下記のをご覧ください).
 * 2) wikiテキストで現れる名前を定義する.  これを達成するために、フック関数を定義してLanguageGetMagicで登録する必要があります. フック関数は配列に渡されフック関数はキーが内部マジックワードIDで値が変数のために使用したいすべての名前を含む配列であるエントリを追加します. 名前は大文字と小文字を区別して独立した言語です. 詳細な情報についてはLanguageGetMagicとマジックワードをご覧ください.
 * 3) 値を変数に割り当てるPHPコードを準備する これを実現するためには、フック関数を定義してManual:Hooks/ParserGetVariableValueSwitchで登録する必要があります.

Note that the only difference between this process and the general process for defining magic words is the last step: defining a hook function for Manual:Hooks/ParserGetVariableValueSwitch. Parser functions have a different method for associating an ID with PHP code. See Manual:Parser functions/ja for more information.

カスタム変数を登録する
これは２つの段階のプロセスです:


 * 1) 変数が に含まれるように変数を定義します これはメンバーをManual:$wgExtensionCreditsに追加することが求められます. もっと詳細な情報については、MediaWikiで機能を登録するをご覧ください.
 * 2) マジックワードIDを変数として宣言する これを実現するためにフックを書いて 、この記事の題目に割り当てします. 　ノート: このフックは変数で使用するため のみ です. パーサー関数を定義するために使用してはなりません.

例
''注: コーディングテンプレートとしてこの例をしたい場合、MediaWikiまたは、他の拡張機能の名前との衝突をする危険性を減らすために を何かあなたのプロジェクトでユニークなものに置き換えてください. 例えば、拡張機能が という名前で'My'を'BEST'で置き換えたい場合、定数、変数、関数、または'BEST_'、'wgBEST'、'wfBEST'、または'BEST'を持っていることを確認してください. ''

ファイル

ファイル

詳細な情報

 * Help:Variables/ja - MediaWikiパッケージコアに組み込まれている既定の変数を検討します
 * Manual:Magic words/ja - 異なる種類のマジックワードとMediaWikiがどのように変数、パーサー関数、テンプレートを区別して伝えるのかを再検討しています.
 * Markup spec