Help:Magic words/ja

マジックワードとは、「値」(日時、サイトの詳細、ページ名のようなものを返す)及び「関数」を表す特別な文字列です. このページでは、標準のマジックワードについてのみを説明します. 技術的な詳細は、 を参照してください.

マジックワードには以下の 3 種類があります:


 * 挙動スイッチ: 通常、大文字の語句を2本ずつの下線で挟んだ形式です. 例:  
 * 変数: 大文字の語句を二重の括弧で挟んだ形式です - 例:  . この形式はテンプレートと非常に類似しています.
 * パーサー関数: パラメーターを指定できるもので、  と   のいずれかの形式です (例: ). および  も参照してください.

変数とパーサー関数では、テンプレート同様に subst 展開を使用できます. 既定では、ページに依存するマジックワードの"現在の"ページに対して影響するか、または"現在の"ページに関するデータを返します. これは、(変数やパーサー関数が) 参照読み込みされたテンプレートやシステム メッセージによって追加された場合も該当します.



挙動スイッチ
挙動スイッチは、ページのレイアウトや挙動を制御するものであり (選択中の外装でサポートされている場合)、コンテンツの情報を省いたり含めたりすることを指定するためによく使用されます. ただし、以下のうち一部はMinerva 外装においてサポートされていません.

変数
変数は、現在のページ、現在のウィキ、現在日時の情報を返します. 変数の構文はテンプレートと類似しています. 「 [高負荷] 」の印がある変数（の使用）はソフトウェアが追跡し、ページ内で使用できる回数には上限があります.

テンプレート名が変数と競合する場合は、変数が使用されます (参照読み込みをするテンプレートの に  を記述する必要があります). 場合によっては、パラメーターの追加でテンプレートを呼び出すためにパーサーが強制されます. 例えば、$tpl-currentdayname-code は変数ではなく $tpl-currentdayname-result を参照読み込みします.



日付と時刻
以下の変数は現在の日付と時刻を UTC で返します.

MediaWiki およびブラウザーのキャッシュが働くため、これらの変数は、現在の日時ではなくページが キャッシュされた 日時を返します.

これらの変数を使用すると、ページがより制限された秒数の間キャッシュされます. これはMagicWordFactoryで構成されます.

日付と時刻のマジック ワードは、ウィキ コンテンツの言語でフォーマットされます. 以降では、ページコンテンツの言語に依存します.

以下の変数は上記と同じことを行ないますが、サイトのサーバー設定や の値を使用します.



より詳細に時刻をフォーマットする、または現在の年と週をISO-8601にきちんと準拠して出力させるには をインストールして  のパーサー関数を使用することで実現.



統計
これら変数が返す数字は通常、区切り文字 (使用言語の規定する句読点や半角アキ、カンマやドットなど) を含むものの、「:R」フラグを使うと数字のみ出力します ( &rarr;、 および   &rarr; ).

「|R」はPAGESINCATEGORYなどの引数を要するマジックワードに用いられます (例、 と 、 と ). 前出の にも適用可能.

数値を示すマジックワードの書式は使用されたウィキページの言語に従います. 以降、ページの言語に依存するようになりました.



ページ名
を使って表示名を変更しても、影響を受けません. 戻り値は変更前のページ名のままです.

マジックワード と は下位ページが有効な時のみ作動します. 有効にする方法は を参照してください.

1.15+ 以降、これらはすべて、(単に現在のページではなく) 適用するページを指定するパラメーターを設定できます:





URL エンコードされたページ名
MediaWiki URLで使用するためエンコードした例を以下に示します. 空白のスペースをアンダーバーに、特定の記号はNCR (en) （訳注: 文字参照）に置換してHTMLを回避します. :



、 、 はそれぞれ実装法が異なります. 詳細は を参照してください.

名前空間
MediaWiki URLで使用するには、以下のようにエンコードします（スペースはアンダースコア(_)でに置換、特殊文字はパーセントでエンコード）.



1.15+ では、完全なページ名のパラメーターを指定でき、(現在のページではなく) 指定したページの名前空間名を返します:

パラメーターには名前空間名は指定できません:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

その他


パーサー関数
パーサー関数は変数とずいぶん酷似していますが、1つ以上の引数を要し（技術的には、引数を要するマジックワードはいずれもパーサー関数となります）、テンプレートとの区別のため名称は時にハッシュ記号（#）で始まります.

このページはMediaWikiにもともとあるパーサー関数についてのみ解説しています. その他パーサー関数はなどで追加される可能性があります. そちらの詳細はをご覧ください.



別のページの技術的なメタデータ


名前空間
はその時点の名前空間に対するローカル言語での名前と、そのインデックスや正規名、あるいはローカルの別名を返します. つまり 6、 -file、 -img (ファイルの名前空間の旧称) はすべて「    」を返します. 例えば本文言語がフランス語のウィキでは (フランス語訳の) -file-de も有効ですが、(ドイツ語訳の)  -file-incorrect は無効です. Thus,  , and   (an old name for the File namespace) all return "    ". On a wiki where the content language is French,  is also valid, but   (the localisation of "File" in German) is not.

The main namespace has no name, i.e.  returns an empty string. For explicitly referring to the main namespace,  can be used, resulting in "".

はMediaWikiのURL用にエンコードした同等の機能です. ただし空白はアンダーバーに置換し、外部リンクとして使用できるようになります.

翻訳した名前空間とカスタム名前空間を混同しないよう注意.

整形
関連項目:

地域化
以下は主要な地域化ツールとして使われるマジックワードです. 他のマジックワードはしばしばウィキの地域（ロケール）と環境設定あるいは言語の選択に依存しており、#日付と時間や#フォーマット、 #Miscellaneousが実例です. により、さらにマジックワードが追加されます.

上記マジックワードの使い方は非常に複雑であり、また、当説明文書は現時点では完成していない可能性があります. 付随する情報は以下のページに説明があります. 複数形、文法、性.



参照読み込み修飾子
を用いると、通常は既定で Template:namespace (名前空間) の設定により、別のページを参照読み込み (トランスクルージョン) します. 以下のマジックワードを用いると、その挙動を操作できます.

その他
パーサー関数 #invoke については、w:Wikipedia:Lua を参照してください.