Extension:Popups/ja

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

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

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

インストール

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


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

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

画像
The image comes from the Extension:PageImages which returns the single most appropriate thumbnail associated with an article. It ignores maintenance templates, stubs, flag icons etc.

テキスト
Popups can be configured with any compatible API that is compatible with the Page content service summary endpoint using. For third parties we encourage using the Page Content Service to enjoy using Popups with your local wiki.

You can also use the Extension:TextExtracts extension. This extension has various caveats and we do not actively support use of this API.

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

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

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


 * init
 * createPopup
 * getOffset
 * getClasses
 * processPopup

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

既知の問題点

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


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


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

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

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

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

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

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