Extension:MultimediaViewer/ja

MultimediaViewer (マルチメディアビューアー) 拡張機能は、ウィキの利用者に対して、別ページの読み込みによる手間や混乱をなくしつつ、ブラウザー内で元のサイズまたはそれに近い画像を表示できるような、別のユーザー インターフェイスを提供します.

インストール
選択肢 A: Vagrant を使用. 手順は のページを参照して、Vagrant 仮想マシンシステム経由で MediaWiki をインストール.

次に と、続いて を実行.

選択肢 B: 手動インストール.

先に のインストールを検討してください. 個人設定でメディアビューアー機能を非表示にするとよいかもしれません. ただしこれを意図的にインストールしなくても、有効にすることができます. この個人設定を登録するには、BetaFeaturesからフック ( フック) の生成と起動を実行してMultimediaViewerに使用します.

また合わせて のダウンロードも検討しましょう - 絶対に必要ではありませんが、それがないとライトボックスで利用できる情報が限られてしまいます.

設定

 * を"true"を指定すると、個人設定でBetaFeaturesが有効になります.
 * ならびに により、既定でだれでも、つまりログインしない匿名利用者でもマルチメディアビューアーを使用できるか決定します. 既定では両方とも「true」.   の代わりに を使用可能.
 * を有効にするとパフォーマンスが向上しますが、ウィキの設定によっては脆弱になりかねません（404 handlerを使用した場合なら問題なく作動するはずです）.


 * 強制ダウンロード

Vagrantを利用する場合を除き、「…をダウンロードする」というボタンを押したときに利用者のブラウザで表示するだけでなく、ほんとうにダウンロード用ファイルが提供されているか確認するには、サーバの設定が必要です.

要求した画像のディレクトリのURLに クエリ引数が含まれる場合、 -ヘッダは に設定してください. その手順はApacheと互換性のあるサーバでファイルで mod_rewrite および mod_headers を使用すると実行します. Varnishの設定はこういう表示になります.

この拡張機能の利用
試用する前提として、最初にログイン状態であること、個人設定が有効かどうかを次のように確認します. ウィキにログインして「特別ページ:個人設定」を開き、「ベータ機能」タブへ移動して対応するチェックボックスにレ点を入れます.

次に、サムネイル画像が含まれたページを開きます. 画像もしくは周辺にある「拡大」アイコンをクリック. ライトボックスが別のウィンドウで開き、画像を拡大して表示します.

もし興味があればテスト環境を書き出し用に用意してありますので、Special:Importを経由すると、テストに適した環境を手軽に設定できます. （訳注：「他のウィキからのページの取り込み」には管理者あるいは同等の権限が必要です. ）

ユーザースクリプトで拡張
機能を追加したい場合は、ほぼ手作業でクラスを順に調べて機能を変更することになります. この作業をもっと快適にするために取り組んでいるのですが、これまでに構築したクラスとメソッドの系統に照らすと、それほど困難な取り組みではないと考えています.

そうは言うものの左記の作業の繰り返しは避けてください. 内部的に変更が行われるとせっかく書いたコードが壊れてしまい、予想外の展開にあなた（とあなたのツールのユーザー）がびっくりする可能性があるからです. そういう事態を予防するには、製品拡張のもっと安定した手法が確立するまでお待ちください.

例については /Extension:Metadata を参照してください.

テンプレート
マルチメディアビューアーとアップロードウィザード（Upload Wizard）は画像のデータを表示するにはいくつかテンプレートを使います. こちらのコードをxmlファイルに保存し、ご利用のウィキにインポートするだけです.