Fandom Developers Wiki
Advertisement

ReferencePopups — фэндомская реализация одного из гаджетов Википедии, позволяющего просматривать содержимое сноски по наведению на ее маркер. Это позволяет читать сноски прямо в контексте статьи без необходимости "прыгать" в самый ее конец. На работу скрипта можно посмотреть здесь.

Инструмент включает в себя гибкую цветовую схему для всплывающего окна, которая будет подстраиваться под тему вики автоматически, используя цвета из конструктора тем. При этом, если для дизайна был использован CSS, цветовая схема подсказки может не совпасть.

Установка[]

Примечания по использованию[]

Всплывающие окна настраиваются через встроенный пользовательский интерфейс. Можно натроить задержку перед показом окна, включить и выключить анимацию, а также указать способ активации — наведение курсора или клик по маркеру сноски. Кроме того, можно отключить скрипт для отдельных пользователей, которые не хотят его видеть.

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

Справка по настройке[]

Окно может быть настроено по следующим параметрам:

  • "Отключить всплывающие подсказки": окна сносок появляться не будут, кроме тех, что были добавлены вручную пользователями. Эту настройку можно отменить, повторно зайдя в меню настроек через ссылку "Настройки всплывающих подсказок".
    • На некоторых вики подсказки могут быть настроены так, что пользователь не сможет их отключить. В таком случае этот вопрос необходимо обсудить с местной администрацией.
  • "Задержка перед появлением подсказки": количество времени в миллисекундах, в течение которого курсор должен находиться на маркере сноски, чтобы открылось всплывающее окно. По умолчанию это 200 миллисекунд, но его можно настроить на свой вкус. Стоит учитывать, что слишком маленькая задержка может очень раздражать, особенно при прокрутке страницы.
  • "Оставлять подсказки открытыми до касания мышью": если этот параметр активен, окно будет оставаться открытым, пока его снова не коснутся мышью (то есть не наведут и затем уберут курсор).
  • "Подсказка появляется при...": по умолчанию окно будет показано при наведении на маркер, но можно заставить его открываться по клику.
    • Если в режиме вызова по клику повторно нажать на маркер сноски, открытое окно закроется, а маркер сработает как обычно, перенеся читателя к списку сносок.
  • "Включить/Выключить анимацию": по умолчанию всплывающие окна появляются и исчезают с простой анимацией, длящейся 300 миллисекунд. Этот параметр позволяет отключить ее.

Настройки для администраторов[]

Администраторы могут перевести ReferencePopups в "заблокированный" режим. Это удалит ссылку с настройками со страницы, а также запретит выключать подсказки.

Для активации блокировки на страницу MediaWiki:Common.js необходимо вставить следующий код (перед строкой импорта скрипта!):

((window.dev = window.dev || {}).ReferencePopups = dev.ReferencePopups || {}).lockdown = true;

Также можно указать стандартные настройки. Например, это отключает анимацию:

((window.dev = window.dev || {}).ReferencePopups = dev.ReferencePopups || {}).defaults = { animate: false };

Пользовательские подсказки[]

Механизм всплывающего окна можно использовать для показа любого необходимого контента. Для этого создан дополнительный скрипт и несколько шаблонов. Импортируйте этот модуль на свою вики:

Чтобы добавить пользовательские подсказки, для начала импортируйте скрипт для кастомных подсказок:

dev:ReferencePopups/custom.js

А также скопируйте эти два шаблона:

На страницах шаблонов описано как их использовать.

Руководство по их использованию написано в их документации.

Всплывающее окно можно стилизовать. На этой странице можно увидеть пример редизайна, а на этой — код CSS, который дает такой эффект.

Advertisement