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.

オプション
You can specify extra dependencies for your gadgets, for example:

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

Here, we ask ResourceLoader to load modules  and   with mygadget. Note that gadgets can't depend on scripts from pages, static files or external URLs, only on modules already registered in ResourceLoader. To make a script from a page depend on another script from a page, each should be a gadget which registers itself as a module in ResourceLoader, then they can be made to have dependencies using the following syntax:

* childgadget[ResourceLoader|dependencies=ext.gadget.parentgadget]|childgadget.js To enable a gadget by default, use " ": * mygadget[ResourceLoader|default|dependencies=mediawiki.util]|mygadget.js|mygadget.css To make the gadget available only to users with appropriate permissions, set the  option, for example: * ImprovedDeletion [rights=delete] | ImprovedDeletion.js Makes the gadget available only to users who can actually delete pages.

Note that restrictions are based on permissions, not user groups like administrators or bureaucrats. Here are some real examples:

* 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 – ガジェット全件を一覧にして短くまとめを添える