Extension:CommonsMetadata
 リリースの状態: 安定 |
|
|---|---|
| 実装 | API |
| 説明 | コモンズのページからメタデータの抽出を試みる |
| 作者 | Brian Wolff (bawolffトーク) |
| 互換性の方針 | MediaWiki とともにリリースされるスナップショット。 master には後方互換性がありません。 |
| MediaWiki | 1.25+ |
| PHP | 5.4+ |
| データベースの変更 | いいえ |
| ライセンス | GNU 一般公衆利用許諾書 2.0 以降 |
| ダウンロード | |
|
|
| 四半期ごとのダウンロード数 | 75 (Ranked 69th) |
| 使用中の公開ウィキ | 1,055 (Ranked 247th) |
| translatewiki.net で翻訳を利用できる場合は、CommonsMetadata 拡張機能の翻訳にご協力ください | |
| 問題点 | 未解決のタスク · バグを報告 |
CommonsMetadata 拡張機能はウィキメディア・コモンズのページからメタデータを抽出する試みで、ウィキメディアの他のどのプロジェクトでも同じデータを入手できます。 画像情報 API (imageinfo API) に情報を追加する基準として、画像の説明文にあるテンプレートやカテゴリを使います。 取得したメタデータはさまざまな拡張機能やツールで利用すると、ライトボックスあるいは画像選択のダイアログが改善されます (例: Extension:MultimediaViewer、Extension:VisualEditor、Extension:MobileFrontend、Mobile-Content-Service (MCS))。
拡張機能の現在の形式は、暫定的な対策を意図したもので、のちにウィキデータのメディア情報（Wikidata on Commons）と交換されました。
インストール
- ダウンロードして、ファイルを
extensions/フォルダー内のCommonsMetadataという名前のディレクトリ内に配置します。
開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CommonsMetadata - 以下のコードを LocalSettings.php ファイルの末尾に追加します:
wfLoadExtension( 'CommonsMetadata' );
完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。
動機とデザインの選択肢
mailarchive:wikitech-l/2013-August/071593.html を参照してください
この拡張機能には次のような目的があります。
- 将来的には、コモンズのメタデータを扱う役割はウィキデータに変更されます。壊滅的な変更ですぐに再び修正する必要がないように、拡張機能はコモンズのメタデータを現在と同様に（新しいパーサ関数を導入しないで）扱う必要があります。したがって、スクリーンスクレイピングを採用します。
- コモンズの説明ページでは、多くの項目の内容に装飾付き書式を設定（具体的にはリンク、斜体、太字のこと。場合によっては埋め込み画像など複雑な要素）
- その結果、拡張機能は処理済みのHTMLを出力 （ウィキテキストは手間がかかり、平文はデータを取得不能）
- さらに、データは（例えば）機械可読な日付形式ではなく、人間が読解できる書式で表示される。日付のフィールドに「1600年代頃」と記述してあると、厳密な日付に変換不可能（他方、変換可能な例も少なくない）。
- これをさらに進めて exif metadata 形式を当ててウィキ側で管理できるようにする（例えばコモンズではカメラの名称をウィキペディアの記事にリンク）
- 説明文書のページから情報を抽出できなくてもファイルの作者がexif/XMP/iptcメタデータでタグ付けされている場合は、それをフォールバックに使わなければいけません。
- 理想としては、そのようなシステムは可能な限りコモンズに特化せず標準化すべきで、コモンズ固有の部分とコモンズ外の部分を分離します。
- コモンズの説明文書のページは多言語で記述されます。大部分の利用者には単一の言語で十分でしょう。
- この実装では日付と物事に言語ごとの規則を適用します。 また、明示的に多言語のフィールド（説明）の場合、すべてを返すか、単一の言語だけ返すか選択肢があります。 単一言語モードであっても、いくつかの要素は言語固有です（数千とあるセパレータが好例）
設定
| parameter | default | description |
|---|---|---|
$wgCommonsMetadataSetTrackingCategories
|
false
|
Add the following tracking categories to file pages when the corresponding information is not provided either via templates on the file page of (for some of these) EXIF metadata:
|
$wgCommonsMetadataPublicDomainPageUrl
|
https://commons.wikimedia.org/wiki/Help:Public_domain
|
Link used for 'license' attribute in schema.org markup for files in the public domain. |
$wgCommonsMetadataForceRecalculate
|
false
|
Force calculation of metadata even when the image is from a foreign repository that would provide it. This is meant for local development. |
テスト
 警告: | もしこの拡張機能の開発やテストに取り組むのなら、画像のメタデータを利用するためにコモンズのテンプレートをコピーしないよう助言します。コンパイル処理にあまりにも時間がかかるのと、Scribuntoなどとの複雑な依存関係があるためです。代わりに、ウィキテキストとHTMLだけで構成された拡張版を入手して、手動でさまざまな引数のレファレンスを追加する（もしくはしない）ようにしてください。（特別ページ:インポートと一緒に用いる）使用例はこちらにあります。 あるいはまた、既定でいくつかのテンプレートを同梱しているVagrantを使用してください。 |
遠隔の画像を使ってテストする（例えば$wgUseInstantCommonsを有効にしてコモンズにある画像を使う）場合は、CommonsMetadataが強制的に画像の説明ページを解析してメタデータを抽出するように$wgCommonsMetadataForceRecalculate = true;を設定することができます（通常は遠隔のリポジトリにCommonsMetadataもインストールされているとそこからAPIの出力のみを転写します）。
使用法
imageinfo API を使用し、extmetadata 経由で画像データの属性を特定する iiprop を加えます。
使用例:
この使用例を API サンドボックスで閲覧する：
戻り値
この拡張機能は現在、戻り値の extmetadata フィールドに下記の項目を出力します (フィールド名は可能な限り EXIF のヘッダーに用いる IPTC-IIM 形式に従う)。
情報テンプレートが内蔵する機械可読データに基づくデータ：
- ImageDescription - 画像の説明
- Artist - 作者の名前（複雑なHTMLや複数の執筆者名などを含む）
- Credit - 情報源
- DateTimeOriginal - 作成時点（可能な限り、半角スペースで区切ったISO 8601タイムスタンプを使用だが、日付を文字で記述したもので、HTMLを含んでいれば可。）
- ObjectName - 題名（書物や絵画の場合。その他ならファイル名のみ）
- Permission - テンプレートの許諾欄。多くの要素が可能（ライセンステンプレート、ORTSのID、属性の詳細...）
- AuthorCount - テンプレート件数と作者（例：書籍、写真...）。テンプレートの1行に複数の作者名が記された場合には、合計人数は表示よりも多い可能性がある。
machine-readable data in the Location template（位置テンプレートに内蔵する機械可読データ）に基づく情報:
- GPSLatitude - 経度
- GPSLongitude - 緯度
- GPSMapDatum - 座標タイプ（現状では
WGS-84にのみ対応）
ライセンステンプレートが設定する機械可読データに基づくデータ：
- LicenseShortName - 人間が読み取れる短いライセンス名称
- LicenseUrl
- UsageTerms
- Copyrighted -
TrueまたはFalse（パブリックドメイン画像の場合）
複合ライセンスの画像の場合、現在は値が提供されません。
For multi-licensed images, these values are currently unreliable.
- Attribution - 撮影者 + 権利関係の表示に代わる、帰属の特記事項（情報テンプレートから取ることも可能）
(can also originate from the Information template)
- AttributionRequired - booleanish (phab:T86726), tells whether there is a legal requirement to attribute
- NonFree - 真偽値に似た値で「true」の場合、画像はフリーライセンスではない（対象はコモンズにない画像限定）
その他のデータ：
- CommonsMedadataExtension - メタデータのパーサバージョン番号； 主に内部利用向け
- License - a best guess at the license of the image （主にMediaViewerによる内部利用向けで、変更の可能性あり；信頼性は LicenseShortNameの方が勝ると考えられる
- Categories -
|で区切った画像のカテゴリ一覧。 - Assessments - 画像評価を
|で区切った一覧 (現在は5項目に対応： 年間大賞、今日の一枚、秀逸、良質、valued (高価値))。 パーシングのカテゴリ名に基づく。コモンズに置かれていない画像には当てはまらない可能性がある。 - Restrictions - 再利用の制限。商標や人格権など。キーワードの配列（こちらの表にあるクラス名から接頭辞
restriction-を除外したもの）。MediaViewerにあるrestrict-* icons（アイコン）も参照。 - DeletionReason - 有効にするとテンプレートを削除の対象とする。 （nukeテンプレートに基づく。コモンズ以外では信頼性が低い可能性がある。） It contains a deletion reason, but it is phrased to be applicable for a log entry, so it might be misleading (e.g. past tense when actually it is not yet decided whether the image will be deleted).
関連項目
- メタデータの追加方法
- Manual:File metadata handling
- Extension:MultimediaViewer - currently the main user of the information provided by CommonsMetadata.
- Request for comment on handling image information
- ローカルにアップロードしたファイルのあるローカルのウィキにおける、テンプレートの互換性（Template detection on local wikis with locally uploaded files） – メタデータ取得のためにテンプレートを準備する方法と、マルチメディアビューアー拡張期能を使用して表示する方法を解説します。
- Extension:CommonsMetadata/info template for 3rd-party wikis
| この拡張機能は 1 つ以上のウィキメディアのプロジェクトで使用されています。 これはおそらく、この拡張機能が安定していて高いトラフィックのウェブサイトでも十分に動作することを意味します。 この拡張機能がインストールされている場所を確認するには、ウィキメディアの設定ファイル CommonSettings.php および InitialiseSettings.php 内で、この拡張機能の名前を探してください。 特定のウィキにインストールされている拡張機能の完全な一覧は、そのウィキの Special:Version ページにあります。 |
| この拡張機能は以下のウィキ ファーム/ウィキ ホスト/パッケージに含まれています: これは正式な一覧ではありません。 一部のウィキ ファーム/ウィキ ホスト/パッケージは、ここに記載されていなくてもこの拡張機能を含んでいる場合があります。 必ずご利用のウィキ ファーム、ウィキ ホスト、バンドルで確認してください。 |