Wikipedia:ガジェット
出典: フリー百科事典『ウィキペディア（Wikipedia）』
ウィキペディアにおけるガジェットとはJavaScriptやCSSで構成され、チェックボックスをチェックするだけで利用可能な個人設定のツールのことです。ガジェットの機能はMediaWikiの拡張機能 (extension) であるExtension:Gadgetsを使って実現されています。
目次 |
[編集] ガジェットとするための基準
ガジェットは最低限以下のような条件をクリアしていなければなりません。
- ガジェットは、設定無しに動くものである必要があります。monobook.js などのユーザースクリプトで設定変更ができることはかまいませんが、それらの設定を一切しなくても動くことが必要です。
- ガジェットは全てのメジャーなブラウザで動作するものである必要があります。エラーで終了するようなことがあってはなりません。
- ガジェットは多くのブラウザで機能するものであるべきです（ブラウザ互換）。例外がある場合ははっきりと表明されていることが必要です。
- 同様の機能を持ったガジェットは、複数あることに筋が通っているときだけ導入すべきです。
- 様々なスクリプトを集めることは個人で行うべきです（様々なスクリプトの集合をガジェットとするのは避けるべきです）。
- ガジェットの使用に必要な権限は明記しなければなりません。また、そこに記載されていないアクセス権で試用した場合、必ず失敗するものでなければなりません。
- 特定のスキンでのみ動作する場合は明記しなければなりません。
[編集] ガジェットの新規提案、評価
提案: 新たにユーザースクリプトをガジェットとしたい場合の提案場所
評価: 個々のユーザースクリプトの評価を行うページ
[編集] インストール方法
この節は管理者向けの情報です。
ガジェットをインストールするには以下の手順で行います。
- MediaWiki:Gadget- で始まる名前のページ、MediaWiki:Gadget-scriptname.js などにヘッダを先頭に保存し、その後（下）にスクリプトを保存します。
- CSSが必要な場合は同じヘッダを付けてMediaWiki:Gadget-scriptname.css などにCSSを保存します。
- スクリプトの詳細を MediaWiki:Gadget-scriptname に記述します。元々のスクリプトのあった箇所にリンクし、動作に必要な環境などを記述してください。
- 便宜的にガジェットに名前をつけます。MediaWiki:Gadgets-definitionに
* scriptname|scriptname.js[|scriptname.css|otherscript.js|...]
など、スクリプトの名前と、それに対応したスクリプトを保存したMediaWiki名前空間のページ名を指定してください。フォーマットは* ガジェットの名前|スクリプトのページ名
になります。 - 下記にあるガジェットの一覧を更新してください。
以上で、個人設定→ガジェットを開くとガジェットが追加されます。特別:ガジェットも確認して下さい。
[編集] ヘッダ
ガジェットのファイルには以下のヘッダを付加してください。
// _________________________________________________________________________________________ // | | // | === WARNING: GLOBAL GADGET FILE === | // | Changes to this page affect many users. | // | Please discuss changes on the talk page or on [[Wikipedia_talk:Gadget]] before editing. | // |_________________________________________________________________________________________| // // Imported from version XXXX as of DATE from [[SCRIPT_SOURCE]] // SHORT_DESCRIPTION, see [[SCRIPT_HOME_PAGE]] // _________________________________________________________________________________________ // | | // | === 注意 サイト全体に影響するファイルです === | // | このページを変更すると多数の利用者にその影響が及びます | // | 変更する前に[[Wikipedia‐ノート:ガジェット]] でよく議論し、動作テストを行ってください。 | // |_________________________________________________________________________________________| // // このガジェットは [[SCRIPT_SOURCE]] から version XXXX を （日付）に取り込んだものです。 // 簡単な説明、詳細は[[SCRIPT_HOME_PAGE]]を参照してください。
[編集] 利用可能なガジェット一覧
2011年2月1日時点
[編集] 他言語版で導入されているガジェット
[編集] 関連項目
- 特別:ガジェット - MediaWiki:Gadgets-definitionの設定に従い表示される特別ページ。特別:個人設定のガジェット・タブで表示されるものと同じ。
- Wikipedia:ツール 外部ツール
- Wikipedia:カスタムJS
- Help:Pywikipediabot 編集用スクリプト
- Wikipedia:AutoWikiBrowser Windows向け編集補助ブラウザ
- 特別:前方一致ページ一覧/MediaWiki:Gadget
