Extension:PageImages/ja

PageImages拡張機能は、ページ上で使用されるイメージに関する情報を収集します.

その目的は、記事に関連付けられた単一の最も適切なサムネイルを返すことです.

MediaWiki 1.29以降、PageImageによりウィキに掲載した記事のOpenGraph プロトコルメタデータをFacebookなどサードパーティ向けに抽出して提供します.

API
PageImages拡張機能は、 の APIに を追加することによって画像情報を提供します.

設定
$wgPageImagesBlacklistはイメージブラックリストのソースの配列です. ブラックリストに載っているイメージはページのイメージとして決して選択されません. 例:

複数のソースを同時に使用することができます.

$wgPageImagesBlacklistExpiryは、ブラックリストがキャッシュされる期間を秒単位で指定します. 既定値: 15 * 60 (15分)

$wgPageImagesExpandOpenSearchXmlがtrueに設定されている場合、PageImagesは APIモジュール内のイメージ検出を、より正確な結果で上書きします. 既定値: false

$wgPageImagesNamespacesはPageImagesが有効になる名前空間の配列です. 既定値: NS_MAIN

ブラックリスト自体に、ブラックリスト指定したファイルのウィキリンクを格納すべきで、それ以外の内容は不適切（であり他のページへのリンクを含めることができます）. 例:

注意したいのは、ページに追加した画像から発生したファイルリンクは無効（そういうファイルは理由があってブラックリスト指定されましたよね？）なため、リンクの先頭に半角コロン の入力を忘れないでください.

動作の仕組み
ローカル画像を含むページを保存するとパーサは と のフックを実行します. PageImages拡張機能はこれら（とその他のフック）に反応して テーブルにそのページの新しい属性を挿入します. 属性は という名前で値にはその画像の名前が入ります.

拡張機能が保存するのは選択した画像のファイル名のみです. 例えばPage informationやHovercardsなどその他の拡張機能や、モバイル版では検索語を入力中に画像が表示されることがあります.

どの画像が特定のページに関連付けされたか識別する方法は？
ページ画像の一覧は ?action=info ページにあります.

どのように画像を選択しているのか?
ページ内の画像をすべて集め、1点ごとに採点します. その中で最も得点が多かった画像をページ画像に選びます. もし画像がライセンスフリーではないとするメタデータをウィキが検出した場合、ライセンスフリーで最も得点が高い画像も合わせて保存します. もし適する画像が見つからない、あるいはどの画像も得点が低い（例えばマイナス点であるなど）場合には、ページ画像を保管しない状態になります.

$wgPageImagesLeadSectionOnlyが真の場合は、処理の対象をリード文内の画像のみに限定します. 現状で真が既定なのはウィキペディアのプロジェクト群だけであり、その他すべてのプロジェクト群では指定する画像の範囲はリード文に限定されません.

画像はどのようにスコアリングされるのか?
ウィキメディアの理想的なページ画像とは縦か横のサイズが400-600px、横か縦がその2倍、記事内の1–4番目に置かれた画像です.


 * The algorithm is configurable.
 * Scores are calculated by a combination of:
 * Image widths as defined in $wgPageImagesScores['width']
 * In Wikimedia wikis, images smaller than 119 pixels are weighted highly negatively. Images with widths between 400px-600px are favoured, with a preference for the lower bound.
 * Images inside galleries are scored separately using $wgPageImagesScores['galleryImageWidth']
 * In Wikimedia wikis gallery images which are smaller than 100 are disregarded.
 * Position in document is also considered as defined in $wgPageImagesScores['position']
 * On Wikimedia wikis, only the first 4 images that appear in the document are considered.
 * The ratio of the image's width to height is considered $wgPageImagesScores['ratio']
 * On Wikimedia wikis the best possible images are images where the height is half the width or the height is double the width. Any images for which the ratio is less than 0.5 will score negatively and be discarded.

処理の手順だけ説明してください...
パージ画像拡張機能は、LinksUpdateフックを実行するごとに画像をデータベースに登録します.

パージ画像拡張機能はその処理をLinksUpdateHookHandler::doLinksUpdateで実行します.

特定のページ画像を除外できますか？
できます！ どのウィキにもブラックリストがMediaWiki:Pageimages-blacklist（example）にあり、管理者が編集します. ここに載った画像はどの記事でもページ画像にはなりません.

==== 特定の記事1件に限定してページ画像を除外できますか？ ====

残念ですが現段階ではできません. ブラックリストの利用もしくは該当する画像をリード文内から移動してください.

特定のページのページ画像を見るには？
サイドメニューにあるリンクを使用（もしくはURLの末尾に を追加）すると、現状で選択された画像を表示します.

不適切な画像をパージしたいのですが方法は？
ページ画像は記事内のリンクを修正した時のみ変更されます. 緊急の場合にはページにあるリンクの追加や削除、必要なら特定版の巻き戻しをします. キャッシュの廃棄（パージ）では効果はありません. 緊急の処理を要する問題の規模が大きい場合はPhabricatorにチケットという作業依頼を投稿します.

ページ画像がただの四角い箱になってしまった理由は？
おそらくページの動画コンテンツと関係があると考えられます. 動画ファイルの冒頭に白紙の部分があると、それが規定のサムネイルに指定されるため、ページ画像に使用すると、ページに白紙を表示してしまいます. この現象は修正作業中で、動画のサムネイルを利用者が選べるようにする予定です. 詳細はphab:T92457とphab:T22647を参照してください.