Extension:Gadgets/ja

ガジェット拡張機能は他の利用者にJavaScriptやCSSベースのガジェットを提供することを可能にします.

ガジェットは MediaWiki 名前空間のページにある JavaScript と CSS で構成されています. 各ガジェットは MediaWiki:Gadgets-definition の1行で定義され、名前と説明、使用するJSとCSSスニペットのリストで構成されます(Usageセクションを参照).

ガジェットはMediaWiki名前空間(ガジェットを定義するリストと実際のコードスニペット)に存在するため、コードを編集できるのはシステム担当者(1.32以降のインターフェイス管理者)だけです. これは当然のことです. JavaScriptはアカウントの乗っ取りや人へのスパイに簡単に使用できるため、ウィキコミュニティから特に信頼されているユーザーのみが、他のユーザーが使用するJavaScript コードを編集できるようにする必要があります.

使用法
Once MediaWiki:Gadgets-definition is created with at least one valid gadget, a new "Gadgets" section will be shown on Special:Preferences for all users. Users can enable the gadgets they would like to use there. An overview of gadgets currently defined by MediaWiki:Gadgets-definition is also rendered on Special:Gadgets, along with helpful links to the relevant localisation and script/style pages for easy creation or editing. Statistics about gadget preferences are available at Special:GadgetUsage.



定義の書式
Each line on the MediaWiki:Gadgets-definition page should start with a "*" (asterisk) character to define a gadget. The line takes the following format:

* mygadget [ options ] | ページ名(群)

The first field (" mygadget " in the example) is the gadget's internal name. The label for the preferences page comes from an interface message page (MediaWiki:Gadget- mygadget ) where the proper name and a short description can be written, which also allows wikitext markup to be used.

オプションの書式:

[ResourceLoader | オプション1 | オプション2 | ... オプションN]

The ResourceLoader flag is required unless the gadget contains only styles. Options that are "flags" only need to have their name written to be turned on. Options that need a value are followed by an equals sign and a comma-separated list of values. All whitespace is optional and may be omitted.

[ResourceLoader | myflag | mykey = value1, value2, value3 ]

例: * mygadget[ResourceLoader]|mygadget.js|mygadget.css または * mygadget[ResourceLoader|package]| mygadget.js | mygadget-Foo.js | mygadget-data.json | mygadget.css または * mygadget[ ResourceLoader | rights=foo, bar ] | mygadget.js | mygadget.css

Using Gadget Definition Namespace
There are two ways to define gadgets depending on the. If It is  (the default value), the list of available gadgets is defined on MediaWiki:Gadgets-definition. In an alternative way, Gadget definitions are defined on pages in the Gadget definition namespace when  is set to.

Creation of the  page and putting in it the below JSON code have the same effect as.

In above example, the  and the   are used.

オプション
依拠関係をさらに定義するには、次の例があります.

* mygadget[ResourceLoader|dependencies=jquery.ui, jquery.effects.clip]|mygadget.js|mygadget.css

この段階で ResourceLoader にモジュールの  と   を mygadget とともに読み込むようリクエストします. 留意点として、ガジェット類は特定のページに書いたスクリプト、静的なファイルもしくは外部URLに依拠することは不可能で、ResourceLoader に登録済みのモジュールのみに規定されます. 特定のページにあるスクリプトを、他のページの特定のスクリプトに依拠させるには、どちらもガジェットであり ResourceLoader にモジュールとして定義する必要があり、その後、以下の構文を使って依存関係を定義します.

* childgadget[ResourceLoader|dependencies=ext.gadget.parentgadget]|childgadget.js 既定でガジェットを有効にするには" "を採用： * mygadget[ResourceLoader|default|dependencies=mediawiki.util]|mygadget.js|mygadget.css 適格な権限を預かる利用者のみガジェットを使えるようにするには、  オプションをたとえば以下のように設定します. * ImprovedDeletion [rights=delete] | ImprovedDeletion.js ガジェットの利用範囲は、実際にページ削除の権限がある人にのみ限定します.

制限は 許可に依拠し、管理者またはビューロクラットなどの利用者グループではありません. 実例をいくつかご紹介します.

* modrollback[ResourceLoader|rights=rollback]|modrollback.js * UTCLiveClock[ResourceLoader|rights=purge]|UTCLiveClock.js * Ajax_sysop[ResourceLoader|rights=patrol,rollback,markbotedits,delete]|Ajax_sysop.js



ページ
定義行の残りのフィールドにはガジェットのモジュールを構成する JavaScript、CSS、JSON のソースページ が入ります. これらの収容先は MediaWiki 名前空間で、インタフェース・メッセージとして記録されます（サンプルの MediaWiki:Gadget-mygadget.js と MediaWiki:Gadget-mygadget.css） ページ名の末尾には必ず ".css"、".js"、".json" のいずれかを書きます.

特定のガジェットごとに使えるソースページの数は無制限であり、例を示します.

* frobinator[ResourceLoader]|frob.js|frob.css|pretty.css * l33t[ResourceLoader]|l33t.js * foobar[ResourceLoader|package]|foo.js|bar.js|foobar-data.json

ご留意点として、ウィキ構文と読み取れる文字列がコードが含まれている場合（例：署名の記法である ）、その部分を で挟んでタグを JavaScript または CSS のコメントにして、走らせたときに解釈されないようにしてください.

MediaWiki:Gadget-externalsearch-bar.js の1行目と最終行を参照.

節
2個以上の "="（等号）で挟まれた見出しを手掛かりに、MediaWiki:Gadgets-definition にあるガジェットの一覧を切り分け、節の題名を定義するシステムメッセージ単位にまとめることができます. その例です.

== interface-gadgets ==

これで新しい節を定義し、ページのMediaWiki:Gadget-section-interface-gadgetsにある題名を添えます.



汎用されるガジェット
Gadgetsには、ウィキメディアのコミュニティ間で汎用されるガジェットをまとめてあります.



関連項目

 * Special:Gadgets – ガジェット全件を一覧にして短くまとめを添える