Extension:Popups/ru

Отображает всплывающие окошки с описанием содержания страницы, когда пользователь наводит курсор на ссылку, ведущую на страницу.

Это инициатива команды дизайнеров, вдохновленных популярным гаджетом Navigation popups. В настоящее время эта функция доступна в виде Beta Feature на сайтах Wikimedia. Описание функций расширения и дополнительную информацию о его использовании в проектах Викимедиа доступно в Page Previews.

Зависимости
Это расширение имеет жесткую зависимость от и. Существуют также дополнительные зависимости от (без BetaFeatures, он загружается для всех пользователей),  и  (для инструментария).

Установка

 * Установите зависимости.


 * Включить бета-функцию

Содержимое
В всплывающем окне помещается изображение (если таковой имеется), небольшая текстовая выдержка и метка последнего редактирования.

Изображение
Изображение формируются при помощи Расширение:PageImages, которое возвращает одну наиболее подходящую миниатюру, связанную со статьей. Он игнорирует шаблоны обслуживания, незавершённые статьи и т.д.

Текст
The text comes from the Extension:TextExtracts from which a plain-text extract is requested (see that extension for exclusions). Two sentences are requested from the intro section and a limit is put through CSS that makes sure that text doesn't overflow from the card. This is done by applying a max-height on that element. This approach would provide the same visual solution regardless of the language's script. A major con is that the text stops abruptly and ellipses can't be added.

Показать/Скрыть временя
Время отображения и скрытия можно отрегулировать в user.js следующим кодом:

Renderers
This extensions currently has only one renderer, that is for ordinary pages. New renderers for different kind of pages, or things like references can be easily added. One needs to create a new object with the following methods:


 * init
 * createPopup
 * getOffset
 * getClasses
 * processPopup

You can see details of these methods in ext.popups.renderer.article.js or this patch that adds a renderer for references.

Known problems
Users of the Translate extension should note that Page Previews requests previews in the content language of the page. If the preview contains a complete translatable block, then it will be translated. If, however, the preview contains an incomplete translateable block – because a sentence is cut off, say – then it isn't translated and will be displayed in the content language of the page. If you are observing this behavior, then you should consider marking up individual sentences in your lead section.

T167852 is for a technical audience but has more information on the underlying problem.

Why can't I copy and paste text from a preview?
At time of writing, the cons of doing so outweigh the pros. Essentially it boils down to decreasing the touch area to read the article in full. Once Page Previews is deployed on English and German Wikipedia, feel free to reopen this task and reignite the discussion, but right now we have no plans.

How can I remove content from a page preview?
TextExtracts will strip any element that is marked with the  class. This class is one of the classes in the  configuration variable.