Manual:Parameters to index.php/ja

このページはMediaWikiソフトウェアのメインスクリプトであるindex.phpへのパラメータの一部のリストです. これらの多くの引数はURLにおいて通常GETパラメータとして与えられますが、POSTデータとしても渡されます. POSTは匿名ユーザのためのpurgeアクションといったいくつのケースにおいて実際に要求されます.

'''注意: このページの情報は完全ではありません. '''

フォームを投稿するクライアントはHTMLで表されるすべてのフォームパラメータを投稿します -- 静的なリストを当てにすることは将来の破損につながるかもしれません.

アクション
次の内容は パラメータのために許可された値のリストです.

アクションの中には、 で専用の設定を使用することによって有効になったり、無効になったりするものもあります. 例えば、 アクション以外は、$wgDisabledActionsに設定を追加することで無効にできます. デフォルトの$wgDisabledActionsの値は空です. この設定はアクションごとに決められた設定より優先されます. 例えば、 アクションを無効化した場合、$wgAllowPageInfoがtrueに設定されているとしてもinfoページを見ることはできません.

また、検索が有効で パラメータが提供されている場合(空白ではない)すべてのアクションは無視され検索が実行されます.


 * view : デフォルトのアクション. アクションが明示的に与えられない時に使用される.
 * watch : ウォッチリストに該当ページを追加します.
 * unwatch : ウォッチリストから該当ページを除去します.
 * delete : ページを削除します.


 * デフォルトでは、ユーザのために削除と確認して理由を指定するためにフォームを返します.
 * 正しいedit tokenが の値として渡される場合、削除はPOSTリクエスト上で実行されます. ユーザが削除を確認するときに起きます.
 * 削除の理由は引数 の値として渡されます; この文字列は削除ログ(logging tableの フィールド)に記録されます.
 * 画像の単独のバージョンを削除するときも削除が実行されます; パラメータ と への正しい編集トークンに渡されるidバージョンが求められます; この場合、リクエストはGET経由でも渡されます;
 * revert : 画像を以前のバージョンへ差し戻します. 他に2つのパラメータが要求されます.
 * …差し戻しするバージョンのid.
 * …編集トークン.
 * rollback : 該当ページの最終編集者によって最後の編集を巻き戻します. 言い換えると、編集は細部の編集としてマークされ、編集要約はMediaWikiによってあらかじめ定められている文になります.
 * …差し戻しされた編集を行った利用者.
 * …巻き戻しトークン. リンクに追跡するもしくは外部のウェブサイトにあるボタンをクリックすることで望まないロールバックをユーザが実行することを防止するために使用される.
 * オプションの 引数が渡される場合、デフォルトの値の代わりにその値が編集の要約として使用されます.
 * オプションの 引数が渡される場合、編集はbotのものとしてマークされます(編集はrecentchanges table)で とマークされます)
 * protect : 該当ページの保護レベルを表示、変更します.
 * デフォルトでは、該当ページの現在の保護レベルを表示するフォームを返し、該当ページの保護レベルを利用者が変更することを許可します.
 * リクエストがPOSTで、妥当な値編集トークンが として渡される場合、これらのレベルは と の値に変更されます. も渡され、カスケード保護が適用される場合(すべてのトランスクルードされたページが同じ保護レベルに設定されます) パラメータはページログに記録される保護もしくは保護の解除のために理由を加えます
 * より一般的には、制限されるアクションは$wgRestrictionTypes配列でリスト表示されたものです. この配列は に初期化され、LocalSettings.phpで変更することが出来ます. protectionアクションは配列でそれぞれのアクションのために パラメータを受け取ります.
 * info :
 * 当該ページをウォッチリストに登録しているユーザ数、編集回数、著者の人数等、ページに関連した情報を表示します.
 * このアクションは )の 変数経由でデフォルトでは無効にされています;
 * markpatrolled : 編集にパトロール済マークを付けます. meta:Help:Patrolled editをご覧下さい.
 * …recentchanges tableにおける編集のid.
 * render : ページを描写するHTMLを表示します; アクションと同様に、単に記事の内容を表示するのみですが、ツールボックス等は表示されません.


 * deletetrackback : ...
 * トラックバックに関連します.
 * このアクションは によりデフォルトでは無効にされています.
 * purge : 当該ページのキャッシュをクリアし、ソースからページを再構築することを強制します.
 * このアクションはログインユーザには直接実行されます.
 * ログインしていないユーザのために、このアクションはPOSTリクエスト経由でリクエストされた時のみに実行されます. さもなければパージングを確認するフォームが表示されます(OKボタンを押すことでパージリクエストを投稿し、そしてリクエストが実行されます)
 * print : 'view'と同等です.
 * dublincore : ...
 * $wgEnableDublinCoreRdf経由でデフォルトで無効にされています
 * creativecommons :
 * $wgEnableCreativeCommonsRdf経由でデフォルトで無効にされています
 * credits : ...
 * submit : ページ変更に関連する様々なアクションの補助アクションです（詳細は下記を参照）.
 * デフォルトでは、編集フォームを表示します.
 * ページの変更、プレビュー、差分の表示等様々に使用されます（詳細については下記の編集/投稿セクションをご覧下さい）.
 * edit : 一般的にページから編集を返すために使用されます. 実際には投稿とほぼ同じ機能を実行します;
 * history : ページの履歴を表示します（下記を参照）.
 * raw : ページのソースコードを表示します（下記を参照）.
 * ajax : 有効な場合、$wgAjaxExportList経由で登録したPHP関数を呼び出します; Manual:Ajax/jaをご覧下さい.
 * $wgUseAjaxをtrueにすることが要求されます; 呼び出し可能な関数は$wgAjaxExportList配列にあるもののみです ($wgAjaxSearch もしくは$wgAjaxWatchが設定されている場合は暗黙です)
 * 追加パラメータ: は関数名です(例えば  ); the  配列はこの関数の引数のリストです(例えば、 は 文字列を関数に渡します).
 * Ajax関数を呼び出すためのJavaScriptのsajax_do_callはajax.jsで定義されたAjax関数です.

プリファレンス(オプション)のオーバーライド
次のパラメータはユーザのプリファレンス(オプション)をオーバーライドします. 他のセクションで説明される他のパラメータは"diffonly"、"internaledit"、と"externaledit"です.


 * useskin : skinを指定します
 * uselang : UI要素のために言語を指定します(例えば" my talk"リンクなど); これはアカウントを作成するために便利です、プリファレンス設定が適用するステージにおいて. 例えば、http://meta.wikimedia.org/w/index.php?title=Special:Userlogin&type=signup&uselang=de を使用します; MediaWikiのバージョンの範囲から選択するために言語に関係なくuselangは一般的なパラメータとしても使用されます. w:Wikipedia:Uploadとを参照して下さい;
 * variant : UI要素のために言語バリアントを指定します(例えば中国語のWikipediaで使用されています);
 * printable : が渡されたとき、ページは印刷に最適なフォームで表示されます;

上記の4つのパラメータは"render"と"raw"以外のすべてのアクションに影響します.

ページもしくはリビジョンを確認する
ページ(もしくはページのバージョン)は一つもしくは複数のパラメータを渡すことで指定することが出来ます:


 * title : ページのタイトル
 * curid : ページのid; タイトルの値をオーバーライドします(タイトルのパラメータが要求される、もしくはメインページで終わる)

アクション(ビューと編集)の中にはページの特定のリビジョンで動作するものもあります. リビジョンが2つの次のパラメータによって確認されます. タイトルとページのidを省略することが可能になります.

oldidによって与えられたリビジョンの代わりに使用します:
 * oldid : リビジョンのid;
 * : 前のもの
 * : 次のもの

ビューとレンダー
ビューはデフォルトのアクションです. 他のアクションが渡されない場合、 が明示的に想定されます. このアクションはページ、リビジョン、同じ、もしくは異なるページの2つのリビジョン間の差分を表示します. 次の内容は(部分的な)引数のリスト(このアクションに影響を与える)です.


 * diff : このパラメータの値はリビジョンを特定します; 他のリビジョンとこのリビジョン間の差分が返されます:
 * if が渡されない場合、同じ記事上のこのリビジョンと以前のリビジョン間の差分が表示されます;


 * さもなければ、 によるリビジョンとこのリビジョン間の差分が表示されます; このパラメータの値として取り得るのは、リビジョンid、 の値、 によって与えられたリビジョンと関連するリビジョンを特定する とページの最新リビジョンを特定する の値です;
 * それらは2つの異なるページの2つのリビジョンを比較することを可能にするので、 と は同じ記事の2つのリビジョンである必要はありません.


 * redirect : このパラメータの値が'no'の場合、リダイレクト先ではなくそのページ自身が表示されます. ; このパラメータは であり、尚且つ もしくは のパラメータが与えられない状態でリダイレクトを回避するために利用します;
 * rdfrom : ページが外部のwikiからリダイレクトを追跡した結果である時、"Redirected from ..."が表示されるようにこのパラメータはwikiがどちらにあるのか伝えます
 * diffonly : diffが要求されたときにページをレンダーするかどうかについてユーザのプリファレンスを上書きします
 * search : 空白ではない場合(かつ検索が有効になっている)、すべての他のパラメータを上書きして検索を実行します

次のパラメータはカテゴリだけに適用されます.


 * from : ページがカテゴリである場合、ソートキーが等しいもしくはこのパラメータに従うエントリーを表示します;
 * until : ページがカテゴリである場合、ソートキーがこのパラメータの値を優先するエントリーをリスト表示します; が渡されない場合のみに使用されます;

次のパラメータは画像のみに適用されます.


 * page : マルチページメディアにあるページ番号; 現在DjVuファイルのみ適用します; 最初のページは1と番号付けされます;

履歴

 * limit : リスト表示するページリビジョンの番号
 * dir : 履歴ページの相対的な順番です: は履歴のもっとも初期のページが最初のページとして表示されることを意味します; 他の値は履歴の最新のページが最初に表示されることを意味します; それぞれのページ範囲内で、両方の場合でエントリーはタイムスタンプが小さい順でソートされます
 * offset : 表示される履歴の部分を指定するために使用されるタイムスタンプです; デフォルトの場合において最新の返されたエントリはこのタイムスタンプより優先する最新のリビジョンです; が与えられ、他の回避方法で動作します; このフィールドの値は実際にはパフォーマンス上の理由からオフセットではありません(表示する最初のエントリーのインデックス)


 * feed : 指定された場合、履歴における変更のためのフィードが返されます; 許可された値は と です
 * go : (廃止予定) の値が渡された場合、最初の(初期の)ページの履歴が表示されます

Raw
はページもしくはリビジョンのソースコードを返します.


 * templates : の値で渡された場合、ページの範囲内のテンプレートが拡大されます;
 * ctype : 生の内容を返すときに、デフォルトの の代わりにHTTPヘッダで使用されるcontent-typeの値; これは次のタイプの一つのみを取り得ます. 現在は 、 、 と です
 * maxage : max-ageの値は名前のページを返すときにCache-Control HTTPヘッダフィールドでしようされるものです
 * usemsgcache : MediaWikiの名前空間でページのみに適用します; この引数が存在する場合、メッセージの内容はデータベースではなくメッセージキャッシュから返されます
 * oldid : 返すための特定リビジョンのid
 * direction : 、 のどれか; oldidによって指定されたリビジョンの代わりに、次のリビジョン、前のリビジョン、現在の(最後の)リビジョンを返します;
 * gen : この引数は もしくは の値を取ります; 返される値は生成されたユーザのCSSもしくはJavaScriptです

編集と投稿
編集と投稿アクションはほとんど同じアクションを実行します. デフォルトでは、それらはページのために"edit page"を返します. 異なる結果は他の引数を渡すことで取得されます; 結果の中には(ページの新しいバージョンを保存するなど)POSTを使用してのみ取得できるものがあります. このアクションはページもしくはページリビジョンを指定するための標準的な引数を取得します.

編集フォームに作用するオプション
次の3つのオプションは編集フォーム上の効果を生み出します(最初のものはページがどのように保存されるのかに作用します. )


 * section : 事前に読み込み編集するドキュメントの範囲内でセクションのインデックスを指定します; セッションは0からの連番です; セクション0は最初のセクションのヘッダの前の記事の部分です; はドキュメントで新しいセクションを追加するために使用されます;
 * preload : ページもしくはセクションが存在しない場合、編集フォームでテキストエリアの初期の値として使用されるwikitextのページを指定します; ページが場合、preloadコマンドは無視されます. (Bug 5210の2006-03-09以降の部分を参照: これは、includeonlyタグではなくnoinclude部分とタグを含む、ソースページのほとんどすべてのwikitextをプリロードします. )
 * editintro : 上記のフォームでレンダーされた存在する記事もしくはテンプレートのタイトル:
 * internaledit/externaledit : 外部エディタ上でデフォルトのユーザのプリファレンスを上書きします.
 * mode : このパラメータはfileの値で渡され、外部エディタを使用している場合に結果ページに作用します;
 * undo : 編集もしくは一連の編集をアンドゥーしようとします; 技術的には、これはこれらの編集の逆と一連のすべての後の編集を統合しようとすることでなされます; このパラメータの値はページの古いリビジョンのidです; 統合が可能ではない場合、そのリビジョンのために通常の編集フォームが返されます
 * デフォルトでは、アンドゥは与えられたリビジョンidを優先する編集上で試みられます;
 * if undoafterも与えられた場合、リビジョン と 間の変更がアンドゥされることが試みられます;

何をするのか
次のオプションは投稿する時にソフトウェアが何をすればよいのかを伝えます: 保存、プレビューを表示する、もしくは現在のバージョンとの差分です.


 * wpSave : サーバによって返された編集フォームの内容を保存するときにこの引数は生成されますが、投稿時に実際には使用されないもしくは要求されません(保存するｔまえに要求される引数については下記を参照);
 * wpPreview : あたかもwpTextbox1の値が保存されたように　ページもしくはセクションのプレビューをリクエストするためにPOSTリクエストを設定します;


 * デフォルトでは、wpTextbox1の値のプレビューで編集フォームを返します;
 * 追加の 引数が渡されたとき、wpTextbox1の値のレンダリングが表示されるだけで、フォームと他のGUI要素は返されません; 保存の結果と似ており、 でビューをします(ライブプレビューとアプリケーションの詳細については、en:User:Pilaf/Live Previewをご覧下さい);
 * はwpPreviewにとって理想的です; それゆえ、通常のプレビューは が渡されない場合に返されます;
 * wpDiff : あたかもwpTextbox1が保存されたかのように、ページもしくはセクションの現在のバージョンとバージョン間の変更を表示しながら、テーブルをリクエストするPOSTリクエストに設定します;

保存される必要があるパラメータ
次のパラメータはユーザがページを保存するときに求められます. 編集要約フィールドはそのように設定されたときにも要求されることがあります(下記を参照).


 * wpTextbox1 : 新しいページ/セクションの内容;
 * wpStarttime : ユーザがページ編集を始めた時のタイムスタンプ; この瞬間と投稿時間の間にページが削除されたかどうかを確認するために使用されます(この場合、ユーザは保存をすることを確認されます)
 * wpRecreate : wpStarttimeの後でページが削除された場合、このフィールドはページが保存されていることを確認します;
 * wpEdittime :新しいページのために、wpStarttimeと等しいです; さもなければ、ページの最後のリビジョンのタイムスタンプです; 編集の衝突を確認するために使用されます;


 * wpEditToken : 編集トークン; リンクを追跡するもしくは外部サイトでリンクボタンを押すことによってページを保存することからユーザを回避させるために使用されます. ログインしていないユーザのために、revision 18112以降でwpEditTokenが要求されます; 現在はランダムな文字列よりも の文字列のみが含まれます(edit token suffixを参照して下さい)

保存するページのために、 、 、 と がPOSTリクエストで要求され、 もしくは のどちらも渡されません. の後でページが削除された後で、論理型のオプションである も要求されます.

オプションの追加データ
編集要約もしくは"ignore blank"パラメータは"warn on blank summaries"が設定されている場合義務になることもあります.


 * wpSummary : 編集要約;
 * wpMinoredit : 保存リクエストで設定されている場合、編集は細部の編集としてマークされます; プレビューと差分のために、編集フォームに"this is a minor edit"チェックボックスが初期の値になります;
 * wpWatchthis : 保存リクエストに渡された場合、ページにユーザのウォッチリストが追加されます; 保存リクエストに保存されない場合、ページはユーザのウォッチリストから除去されます; プレビューもしくは差分のために、これは編集ボックスの"watch this page"チェックボックスの初期の値です;
 * wpSection : 投稿するドキュメントの範囲内でセクションのインデックスを指定する; セクションは0から連番の数字を付けられます; セクション0は最初のセクションヘッダの前の記事の部分です; の値は新しいセクションをドキュメントに追加するために使用されます;
 * wpAutoSummary : 初期に編集フォームでユーザに表示されるものとして編集要約フィールドのMD5のハッシュを含みます; このフィールドは投稿する前にユーザが修正されたそのフィールドを持つかどうかを確認するために使用されます: の値のMD5ハッシュがこのフィールドと同じ場合、編集要約は修正されません;
 * wpIgnoreBlankSummary : ユーザが編集要約を修正しなかったとしてもページを保存します;
 * wpTextbox2 : 編集の衝突の場合、衝突を生成した保存リクエストのwpTextbox1の値を含みます;
 * safemode : ブラウザの中にはユニコードの文字を含むテキスト編集で問題を抱えるものがあることが知られています; そのようなブラウザから編集フォームのためのリクエストが来た場合、テキストエリアの初期の内容にあるアスキーではない文字は の形に変換され、 の値はフォームに隠されてしまいます; 投稿したとき、 フィールドは逆変換が実行されることを示します.
 * wpScrolltop : ???

特別ページ
多くの特別ページはそれらが実行する機能に特有の追加のパラメータを持ちます. 例えば、Special:ExportのためのパラメータはManual:Parameters to Special:Export/jaで要点が書かれています

ユーザスクリプトのパラメータ
ユーザスペースのw:JavaScriptはGETとPOST経由で渡された追加のパラメータを取得することがあります. ユーザが独自のスクリプトもしくはLupin's Autoedit ScriptのようなグローバルなJavaScriptを使用する場合、次のパラメータは自動編集のために使用されます: autoedit、autosummary、autoclick、とautominorです. Extension:Autoeditで詳細な説明がされているものがあります.

最大ラグのパラメータ
maxlag parameterはすべてのアクション、とりわけハイトラフィックの場合でリクエストが提供されないことを伝えることに適用されます. 値は数値です; この値が低い(0ではない)ほど、提供されないリクエストをもたらすトラフィックが低くなります. ソフトウェアが複製のデータベースクラスター上で動作しているときのみ適用されます.