Extension:Popups/ja

Popups拡張機能はページプレビューを表示します - ユーザーがその記事へのリンクをたどると、記事のコンテンツの要約が表示されます.

これは、人気のあるナビゲーション・ポップアップガジェットに触発されたデザインチームのイニシアチブです. 現在、ログアウトしたユーザーはこの機能をすべてのウィキペディアで利用できます. 拡張機能の働き、ウィキメディアプロジェクトでのその使用に関する詳細情報は、ページプレビューで入手できます.

依存関係
この拡張は、（テキスト抽出）と（サムネイル表示）に強く依存しています. （BetaFeaturesなしだとすべての利用者が読み込み可能）と（利用ログ＝インタフェース用）と（同＝ウィキメディア用）との選択的な依存関係もあります.

インストール

 * 依存関係をインストールしてください.


 * ベータ版機能を有効にする

API
Every project is different, and what displays in your previews is highly dependent on the content inside your wiki.

Extension:Popups has been optimised to work with Wikipedia-like content (e.g. wikitext). If your wiki is using a different kind of content handler (for example as is the case for Wikibase) it will need to provide its own API.

The API can be written in any language, but the response of the API must match the spec defined here:

https://www.mediawiki.org/wiki/Specs/Summary/1.2.0

Defining new APIs is out of scope for the Popups extension.

Once defined, you can configure page previews to point to your API using $wgPopupsRestGatewayEndpoint configuration option.

本文
ポップアップ画面に（存在する場合）画像1てんとテキストを要約した短文、最終編集のタイムスタンプを表示します.

画像
Extension:PageImages経由で表示される画像は、その記事に最もふさわしい画像のサムネイルです. 保守テンプレートやスタブ記事、国旗のアイコンなどは対象外です.

テキスト
ポップアップは適合する API からなら設定でき、その適合の条件とは を使用するPage content service（PCS）要約エンドポイントで使用できることです. サードパーティの皆さんは、ポップアップをご利用のウィキで使うためにぜひPCSの導入をお奨めします.

またテキスト抽出の拡張機能Extension:TextExtractsも利用できます. ただし注意事項がいろいろあることから、ウィキメディアではこの API はサポート外です.

レンダリングエンジン
この拡張機能には現在、レンダリングエンジンが1件当てられ、対象は通常ページです.

他の種類のページあるいは出典を対象とする個別のレンダリングエンジンの追加は、難しくありません.

新しいオプジェクトを以下の手順で作成する必要があります.


 * init
 * createPopup
 * getOffset
 * getClasses
 * processPopup

手順の詳細はext.popups.renderer.article.jsもしくは出典にレンダリングエンジンを追加するパッチで確認してください.

既知の問題点

 * Translate 拡張機能の利用者の場合、ページプリビューが表示にページのコンテンツ表示言語を呼び出す点にご留意ください. プリビューが完全に処理可能なブロックを含む場合、処理します. ただしブロックが翻訳対象として不完全な場合 – 例えば未完結な文 – 処理されず、ページのコンテンツの言語で表示されます. この挙動を監視するなら、リード文内の文を1つずつマークアップする必要があります.


 * T167852 は技術系の閲読者対象ですが、根本的な問題に関する情報は含みません.


 * 文字数が長すぎるためにプリビューでは短縮されて表示された数式 - 長い数式もしくは化学式（文字数の上限はプリビューの既定値）はプリビューで短縮して表示されます. 勾配を付け、数式が記事中ではもっと長いと示すことはできませんでした.

プリビューから直接テキストをコピペできないのはなぜですか？
この原稿執筆の段階では、不利な点が利点よりも大きいからです. 突き詰めると、記事全文を閲読するのに触れる部位を減らすかどうかが、焦点になります. 英語版とドイツ語版のウィキペディアでこの拡張機能を実装した段階で、もういちど、このタスクを開いてみてください. あいにく、それまで修正などは計画がありません.

プリビューで表示される画像を変更したいのですが、その方法は?
Extension:PageImages#画像の選択を参照してください.

ページプリビューからコンテンツを削除する方法は?
クラスが付いた要素はすべて要約から削除されます.

これらの要素は何に由来するの？
Summary REST API（JSON エンドポイントの要約）に由来します.

カッコ内の記述が削除された理由は?
議論がファブリケータのチケット T91344で白熱しています. この課題、もしくは関連の問題に関するご意見は、ぜひ先のチケットに投稿してください.