Extension:Popups/ja

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

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

そこへドイツ語話者コミュニティの技術要望リストに採用された参考資料プレビュー機能の開発が追加されました. 詳細の説明と情報はをご参照ください.

依存関係
この拡張機能は、 と に強く依存しています. (ベータ版提供中の参考資料プレビューを有効にする場合) と と  との選択的な依存関係もあります.

インストール

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

Page previews API
プロジェクトはそれぞれ異なり、プレビューに表示される内容は、Wiki内のコンテンツに大きく依存します.

Popups拡張機能は、Wikipedia のようなコンテンツ (例: wikitext)で動作するように最適化されています.

If your wiki is using a different kind of content handler (for example as is the case for ) it will need to provide its own API.

APIはどのような言語で書かれていても構いませんが、APIのレスポンスはここで定義された仕様と一致する必要があります.

新しいAPIを定義することは、Popups拡張機能の範囲外です.

一度定義すれば、 設定オプションを使って、ページプレビューがあなたのAPIを指すように設定することができます.

ページプレビューのコンテンツ
ページプレビューのポップアップに (存在する場合) 画像1点とテキストを要約した短文を表示します.

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

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

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

参考資料プレビューのコンテンツ


リファレンスプレビューポップアップのコンテンツは、ページ自体のリファレンスセクションから直接取得されます. ここには外部サービスは含まれていません. コンテンツがポップアップサイズを超えると、スクロールバーが表示され、すべてを見ることができます.

参考資料の種別
表示される参照タイプは、 参照のコンテンツをカプセル化するために使用できるタグの特定のCSSクラスを使用して設定されます. . 現在以下のフォーマットが許容されています:, ,  ,  , それとは別に、citeタグが見つからず、適切なクラスが使用されなかった場合は、常に一般的なフォールバックがあります. CSSクラスをウィキテキストで直接使用することはお勧めしませんが、テンプレートを作成することをお勧めします.

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

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

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



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

既知の問題点

 * 拡張機能の利用者の場合、ページプレビューが表示にページのコンテンツ表示言語を呼び出す点にご留意ください. プレビューが完全に処理可能なブロックを含む場合、処理します. ただしブロックが翻訳対象として不完全な場合 – 例えば未完結な文 – 処理されず、ページのコンテンツの言語で表示されます. この挙動を監視するなら、リード文内の文を1つずつマークアップする必要があります. T167852 は技術系の閲読者対象ですが、根本的な問題に関する情報は含みません.
 * 文字数が長すぎるためにプレビューでは短縮されて表示された数式 - 長い数式もしくは化学式（文字数の上限はプレビューの既定値）はプレビューで短縮して表示されます. 勾配を付け、数式が記事中ではもっと長いと示すことはできませんでした.

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

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

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

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

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

コンテンツ名前空間を離れるとポップアップが表示されない理由は？
ポップアップは、コンテンツ名前空間のページへのリンクにのみ表示されます. これはポップアップの制限です. TextExtractsは、他の名前空間から利用できます. に名前空間を追加することで、これを回避できます.

関連リンク

 * ページプレビュー　MediaWiki.orgにある help pageとメインのフィードバック受付
 * 参考資料プレビュー　MediaWiki.orgにあるhelp pageとフィードバックの受付
 * 参考資料プレビュー 　Metaのプロジェクトのメインページ
 * 関連研究:Wikimedia Performance Team/Authoring Popups: Best Practices