Manual:Special pages/ja

特別ページ(Special page)は特別な機能を実行するソフトウェア上の要求によって作成されます. 例えば、特別ページが一つの外部サイトへのリンクを一つか複数のすべてのページを表示する、もしくはユーザが投稿したフィードバックのためのフィードバックフォームを特別ページが作成することが出来ます. 特別ページは独自の名前空間であるSpecial:(日本語版では特別:)に設置され、他のページと同様に直接編集することは出来ません. 開発者も新しい特別ページを作成することが出来ます. これらのページはユーザがアクセス可能でSpecial:Allpagesですべての特別ページのリストを表示されます. 特別ページの中には制限されて特定のタイプのユーザだけがアクセスできるものがあります. 他の特別ページでは特別ページリスト上にはまったく現れないでwiki内部だけで使用されるものもあります.

一般的な情報
MediaWikiに組み込みの約70ほどの特別ページは と呼ばれ、 ディレクトリに設定されています. 特別ページはサードパーティの開発者によって作成され ディレクトリもしくはより大きなエクステンションの一部として保存されます. すべての特別ページは で定義されたSpecialPageと呼ばれるクラスから継承します. 新しい特別ページが作成されたとき、定義されたページにアクセスするためにユーザ権限が必要です. 他のことの中で、Special:specialpages上でページが表示されるかとそのページが他のページに含まれるのかについてこれらの権限が指定します.

特別ページはカスタマイズされたユニークな名前を持つことが出来ます. 一般的なフォームは"Special:Pagename"で"Special"と"Pagename"の両方ともカスタマイズ可能です. 特別な見せかけの名前空間は異なる言語のために定義できるようにするためにwiki上でシステムメッセージに変更することが出来ます. この再定義された名前空間はwikitextの     で作成することが出来ます. このwiki上では"   "を与えます. 特別ページの名前はサイトの言語のためにIDとして特別ページの一般的な名前によって、システムメッセージで再定義することが出来ます.

特別ページは入力の許可をする、もしくはしないことがあります. 例えば、Special:ExportはSpecial:Export/Sunを呼び出すことでエクスポートする特定のページを定義するユーザトップを許可します. 特別ページが複雑な入力を許可する場合、ページURLのパラメータは次のように変更します. 例えば http://www.mediawiki.org/w/index.php?title=Special:Recentchanges&days=3&limit=250

ノート:
 * 特別ページを作成するためには様々な方法がありますが、下記のものは大部分がオフィシャルなエクステンションによって使用されるもので、MediaWikiのSVNに受け入れられるためにはこのスタイルに固有なものが必要です. また、'specialpage'のために新しい特別ページの中にクレジットブロックを含むことを確認して下さい. 詳細については$wgExtensionCreditsをご覧下さい.
 * 新しい特別ページを作成した後に、他の人が見つけられるようにこれをCategory:Special page extensionsとExtension special page registryに追加して下さい.
 * 下で使用されるメソッドはPHP4では動作しません: PHP5で導入された"クラスのオートローディング"に依存するからです. このスタイルで書かれた特別ページはそれゆえMediaWiki 1.7.0以前のものと必ずしも互換性がありません:最近のバージョンのPHP上でより前のMediaWikiのバージョンを使用している場合は、アップグレードを検討して下さい.

基本的な特別ページのテンプレート
大抵の特別ページは3つのファイルが必要です: MediaWikiが動作を始めるたびに読み込まれる小さなセットアップファイル、国際化ファイル、と大部分がコードであるファイルです. それらのすべてはMediaWikiの内側のextensionsディレクトリ内部の新しいディレクトリに設置されます. MediaWikiのコーディング規約は3つのファイルを以下のように定義します:


 * - セットアップファイル
 * - 国際化ファイル
 * - 特別ページのコード

下記の例において、はMyExtensionです.

セットアップファイル
セットアップファイルは次のように見えます:

このスタブファイルは4つの重要なことを登録しています:


 * myExtensionクラスの位置
 * 新しい特別ページとクラス名
 * LoadAllMessages hookはMyExtension(後で説明)のためにメッセージをロードする
 * LangugeGetSpecialPageAliases hookは特別ページのためのエイリアスを登録するためです. このエイリアスはページのタイトルを他の言語に翻訳することが出来ます. LoadMessages hookのおかげにも関わらず、ページタイトルは他の言語にカスタマイズすることが可能で、ページのURLはユーザの言語が英語ではないときでも.../Special:Myextensionのままです. これを修正するためには、 はエイリアスを登録するので、ページは.../Special:My_extension経由でアクセスできるようになります. 例えばドイツ語では.../Spezial:Meine_Erweiterungとなります.

ボディファイル
MyExtension_body.phpボディファイルはSpecialPageのサブクラスを含みます. 特別ページがリクエストされたときに自動的に読み込まれます. この例では、MyExtensionサブクラスが呼ばれます:

は特別ページがアクセスされたときに呼び出されるメイン関数です. 関数は 関数をオーバーロードします. 一つの パラメータ、現在のタイトルのサブページコンポーネントを渡します. 例えば、誰かがSpecial:MyExtension/blahへのリンクに従う場合 は"blah"を含みます. は現在のところ、少し込み入っていますが、願わしくはMediaWikiの将来のバージョンでは簡単になります. 国際化ファイル(MyExtension.i18n.php)で定義されたメッセージをロードします. それからこれらのメッセージをキャッシュに保存します. この関数はスタブファイルにあるLoadAllMessages、 MyExtension.setup.phpから呼び出されたので、MediaWikiは定義されたメッセージのすべてを見つけ、トランスレータにそれを渡します.

MyExtension.i18n.phpは、究極的には多言語に翻訳されるテキスト(例えばメッセージ)のスニペットを与えます. すべての特別ページが定義しなければならないとても重要なメッセージがあります: 特別ページの説明です. Special:Specialpages上と、特別ページの&lt;H1>要素に現れます. このメッセージの名前は小文字に変換された特別ページの名前です.

国際化ファイル
最小のi18nファイルは次のように現れます:

"My Extension"と等しいmyextension</tt>の英語(en</tt>)バージョンのメッセージを定義します. もちろん、他の言語のメッセージのバージョンを追加することが出来ます: この例ではドイツ語(de</tt>)を持ちます.

英語ページタイトルがIDと同じ場合は便利です. しかしながらIDは大文字で始まるべきではないことと、IDに空白が ある場合はアンダースコアとしてコードにかかれるべきであることを覚えておいて下さい. ページヘッダとページ名に適用する通常のルールにリンクするために: がtrueの場合、小文字は大文字に変換され、アンダースコアは空白として表示されます. 例:

ローカライズされたページ名のエイリアス無しでのこの例のバージョンがテストされ、 MediaWiki SVNにあるexamples/ThreeFileTemplateにチェックインしました.

コンストラクタ
独自のデータを初期化するためにコンストラクタをオーバーロードすることが出来ますが、 それをする主な理由はSpecialPageクラスの振る舞いを変更することにあります: 子クラスからベースクラスコンストラクタを呼び出す時、次のパラメータが利用可能です:


 * string  リンクとURLで見られる特別ページの名前
 * string  要求されたユーザの権限、例えば"block"もしくは"delete"
 * boolean  Special:Specialpagesでページがリスト表示されるかどうか
 * string  executeによって呼ばれた関数. デフォルトでは$nameからコンストラクトされる
 * string   を使用して他のページが特別ページを含むことができるかどうか

これは特別ページの名前と説明を伴うOutputPageオブジェクトの を初期化します. executeメソッドから呼び出されなければなりません.

これは特別ページが何のコンテキストから呼び出されたのかを示す論理型の値を返します. 個別のウェブページであるならfalse、他のウェブページの範囲内に含まれているのであればtrueです. 通常はページが含まれる場合、プレゼンテーションをいくばくか解体したい時に使用します.

他のウェブページから含むことはコンストラクタに含めることが可能であるページを宣言した場合のみ可能です. 親クラスの初期化の後で メソッドに次のコードを追加することで行うことが出来ます:

これは子クラスがオーバーロードする関数です. 一つのパラメータを渡し、通常はひそかに として参照されます. このパラメータは現在のタイトルのサブページコンポーネントです. 例えば、誰かがSpecial:MyExtension/blahへの一つのリンクを追跡する場合、 は"blah"を含みます.

OutputPage.php
グローバル変数 はブラウザに出力を送る方法なのでもっと使用する変数です. ( もしくは を使用してはなりません) どこかで使用する場合、グローバル変数を宣言します:

を見ることでOutPutPageオブジェクトを調べるが出来ますが(本当に、それらのすべてを調べることが出来ます)、確実に知っておかなければならないいくつかのメソッドがあります.

基本的に のための速くて汚い代用品です. 入力を取得してバッファに追加します: 問答無用で. 下のアクションにおいて、 はユーザデータを含む場合、XSSや害を為すもの、もしくは注入されたSatanのスポーンを含む可能性があります. エスケープを使用するか、信用のある出力をビルドするXMLビルダークラスを使用した方がいいでしょう.

多くの出力のために、この機能を使用すべきです. これはちょっとしたブラックマジック機能です: wikitextが入力されると、HTMLが出力し、難解なコード全体とデーモン召還の両方が起こります.

価値がないものはパーサが密着した全体と結果的にパラグラフとしてチャンクを見ます. すなわり

一つの項目ごとに3つのリストを出力します. おそらくは意図されていませんが.

警告: 特別ページが他のページに含まれることが意図される場合、おそらくは を使用すべきではないでしょう. what seems to be a bug in MediaWikiのおかげで、含まれた特別ページはそれ以前はUNIQ10842e596cbb71daといったものを表示して含んだものをめちゃくちゃにします. 次善策としては、個別にParserオブジェクトを使用してWikitextをHTMLに変換し、それから を使用します. 例です:

多くの本当の特別ページにおいて、ひょっこり現れる 無しで を見ることはまれです.

エラーメッセージが表示されます. 引数の と はテキストではなくキーをwfMsgに指定します. 例です:


 * 'error'はテキストの"Error"を参照します.
 * 'badarticleerror'はテキストの"This action cannot be performed on this page."を参照します.

MessageCache.php
MessageCacheはメッセージをwikiで定義された値に変換するクラスです. もっと詳細な情報についてはm:Help:System messageをご覧下さい. 多くの環境では、システムメッセージは重要性に応じてこれらの場所から来ます:


 * 1) デフォルトの言語ファイル
 * 2) Messages defined in extension internationalization files
 * 3) エクステンションの国際化ファイルで定義されたメッセージ
 * 4) MediaWikiの名前空間

デフォルトの言語ファイルはすべてWikipediaに搭載されているものです. 我々はエクステンションを書いて、新しい機能を実装していますが、あまり有用ではありません. 次のエクステンションの文字列です. メッセージはこのページに含まれる によってエクステンションからアクセス可能です.

は通常メッセージを追加するために使用され、内部的にそのようなものとしてマークされる、構文はとてもシンプルです:

$messagesの配列は次のようなものです:

キーが何であれ、値は を使用して取得されます. MediaWikiデータベース、とりわけMediaWiki:Keyにあるページからカスタマイズされた文字列を渡すことを可能にします.

WebRequest.php
WebRequestクラスはGETとPOST配列から情報を取得するために使用されます. これを使用することは直接スーパーグローバルにアクセスすることよりもはるかにお勧めです. オブジェクトはmagic_quotesのクリーニングのようなものをからかわないからです. WebRequestオブジェクトはコードにグローバルな を含むことによってエクステンションからアクセス可能です.

名でフォームインプットに対応する一つの文字列を返します.

呼び出された関数に応じてini、boolなどを返します. チェックボックスの例では 関数は便利です.

Returns true if a form was posted.

Database.php
MediaWikiはデータベースでインタラクトするためにたくさんの便利な関数とラッパーを持ちます. 適切な場所にロードバランシングスキーマも持ちます. これらのラッパーを使用することをお勧めします. すべての関数リストを見るためには をチェックアウトして下さい、これらのドキュメントだけが明確ではないキャビートのために教えてくれます.

この名前が示すように、この関数はデータベースの参照を取得します. データベースオブジェクトを含むグローバルは存在しません.

この関数を呼び出す時、パラメータ、 もしくは として渡します. 一般的には、リードの実行時にスレーブのデータベースとインタラクトし、書き込みをするときにマスターにインタラクトします. するのは簡単で、一つのデータベースしかなくても行います.

User.php
Userクラスはシステム上のクラスを表示するために使用されます. グローバルな は現在ログインしているユーザを表示し、通常はユーザを操作するときに取り扱うものです.

ユーザが$rightをできるかどうかについてtrueもしくはfalseを返します.

ユーザがブロックされたときにtrueを返します.

Title.php
タイトルはwikiのページ名を表します. MediaWikiはURL関数へ独自の変換タイトルを転がす代わりに、面白いエスケーピングとページ名への特別なケースロジックのすべてのソートをするのでこれは便利です. ページ名でTitleオブジェクトを作成しこのページへのURLを取得するために を使用します.

エクステンションのタイトルを設定する
MediaWikiはエクステンションのタイトルを設定しません. これは開発者の仕事です. Special:Specialpagesが呼び出される、もしくは特別ページがロードされたときにエクステンションの名前を探します. (とりわけ登録されたwfSpecial*</tt>が呼び出される直前です)

エクステンションが見つかる場所(SpecialPageコンストラクタが渡されるものによって指定されます)はキー--exceptです. のため大文字化されません. 内部で使用される機能は特別ページのタイトル(もしくは説明)を見つける、名前を することです. "ThisIsACoolSpecialPage"のキーは"thisisacoolspecialpage."になります.

理論上、getDescription</tt>はメッセージキャッシュとのインタラクトを避けるためにオーバーロードすることが出来ますが、ソースコードは次のような内容を表示します: "派生クラスはこれをオーバーライドすることが出来ますが、通常デフォルトの振る舞いを保持することの方が簡単です. メッセージはrun-time--see MessageCache.phpに追加されます"さらに、これは下に示すようなMediaWikiの名前空間がメッセージをオーバーロードすることを防止します.

エクステンション名をローカライズする
輝く新しいMediaWikiエクステンションをインストールして気がつきます: "なんてこった、私のwikiはフランス語だが、ページは英語を表示する!" 多くの人は気にもしませんが、修正するのはとてもシンプルなタスクです(開発者がこのページで説明されているメソッドを使用している限り). ソースコードで遊び呆ける必要はありません. ページの名前は で、名前は"List of Dirty Pages"だが"Liste de Pages Sales"(フランス語)を表示したいとします. 次のようにシンプルです:


 * 1) MediaWiki:DirtyPagesにナビゲートして、このページは存在しないが、ともかく編集する
 * 2) "Liste de Pages Sales"を挿入して保存する

voilà (フランス語で「ほら」)、変更は適用されました:

言語の範囲内でwikiのためにタイトルをカスタマイズするために便利です: 例えば、開発者が"List of Dirty Pages"と読んでいるが、その名前が気に入らない場合、"List of Pages needing Cleanup"とリネームします. もっと学ぶためにはSpecial:Allmessagesを調べて下さい.

また、あなたのエクステンションが変更するテキストの大きなブロックを持つ場合、例えば警告など、直接テキストを出力しないで下さい:

それからこのメッセージもMediaWiki:Dirtypageshelpでカスタマイズすることが出来ます.

Help:System messagesも参照して下さい.