Extension:WikidataPageBanner/ru

Расширение WikidataPageBanner добавляет широкие баннеры вверху страниц в указанных пространствах имён вики.

Широкие баннеры используются в проектах Wikivoyage. Это расширение главным образом вдохновлено Шаблоном:Pagebanner в Wikivoyage.

Использование
Расширение автоматически добавляет изображение баннера на страницы указанных пространств имен. Чтобы использовать собственное изображение баннера, используйте:   with a set of parameters explained below. Если вики связана с викиданными, она также может получать оттуда баннеры.

Обязательный шаблон
Шаблон:PAGEBANNER должен существовать. Он может быть пустым. В Wikivoyage есть пример сложного Template:PAGEBANNER с логикой рендеринга и дополнительными зависимостями шаблона.

Параметры для функции
Следующие параметры поддерживаются функцией парсера  :
 * pgname - Добавляет пользовательский заголовок к баннеру.
 * To add custom icons, add the parameter icon-icon_name=&lt;Article about icon> to  . Then define a background-image on .oo-ui-icon-icon_name, in Mediawiki:Common.css to use as the icon. Do this for any no. of icons to add to the page.
 * tooltip - Use tooltip=image-caption to show image description on hovering over image.
 * toc - Use toc=yes to enable a Table Of Contents within banner.
 * bottomtoc - Use bottomtoc=yes to push Table Of Contents below banner. This will affect only the page on which its used. To set site-wide toc at bottom, see Styling below.
 * extraClass - Use extraClass=name_of_css_classes(separated by space) to add additional classes to banners which can be used to customize it using styles in MediaWiki:Common.css
 * origin - (see below)

параметр origin
Используйте этот параметр, чтобы определить предполагаемую область фокусировки изображения. Это используется, чтобы обрезать баннер соответствующим образом на маленьких экранах. Значение параметра должно состоять из координат x и y, разделенных запятой. Каждая координата представляет расстояние от центра изображения в виде значения от -1 до 1. Например, origin=1,1 - верхний левый угол, а origin=-1,1 - нижний левый угол. Смотрите этот график для получения дополнительной информации.

Обратите внимание, что в настоящее время реализован параметр источника, предназначенный для изображений, которые намного больше целевого баннера (например, панорамы или портретные фотографии). Он не будет перемещать баннеры там, где изменение положения приводит к пустому пробелу в пространстве баннера. Например, если баннер отображается с шириной 320px и высотой 180px, изображение, которое также имеет размеры 320px и 180px, не может быть перемещено вообще; изображение шириной 600 пикселей и высотой 180 пикселей можно перемещать по горизонтали, а изображение шириной 320 пикселей и высотой 1000 пикселей можно перемещать по вертикали.

Обязательные параметры
$wgWPBImage используется для установки изображения баннера по умолчанию. Добавить название изображения без префикса пространства имён 'Файл:'.

$wgWPBBannerProperty (Essential if Wikidata is enabled) - Banner property on wikidata which holds commons media file

To see default banners on pages even without the use of, set $wgWPBEnableDefaultBanner to true

Необязательные параметры
$wgWPBNamespaces массив пространств имён для отображения баннера. По умолчанию используется основное пространство имен. Он также может быть установлен в true, и в этом случае он включит баннер во всех пространствах имен, кроме исключенных $wgWPBDisabledNamespaces.

$wgWPBDisabledNamespaces исключает определенные пространства имен от показа баннера.

В противном случае этот параметр игнорируется, и рассматриваются только пространства имен в $wgWPBNamespaces.

$wgWPBStandardSizes is an array of standard predefined screen widths in increasing order of size.

$wgWPBEnablePageImagesBannerswhen set to true and is installed will use a page image when no Wikidata image or locally defined image is set.

Examples
A few use examples with explanation:

Will add a banner using image Grand_canyon.jpg as source locally or from wikimedia commons.

Will add a banner using image Grand_canyon.jpg as source locally or from wikimedia commons. Additionally will add icons with class names oo-ui-icon-star, oo-ui-icon-unesco. Set background-image property on theses classes in Mediawiki:Common.css to your desired icon.

Will add a banner using image Grand_canyon.jpg as source locally or from Wikimedia Commons. Additionally adds a Table of Contents inside banner. Sets the name displayed on banner as Some page.

This will add a banner using the Grand_canyon.jpg image as source either locally or from Wikimedia Commons. It additionally adds CSS classes class1 and class2 to the .wpb-topbanner div.

Example usage for banner from wikidata
Make sure $wgWPBBannerProperty is set to correct wikidata banner property. Just use

Will add a banner trying to fetch banner image from wikidata property specified above if exists. If it does not exist, tries to add a default banner only if $wgWPBImage is set.

Styling
The extension has ample scope of styling the banner from Mediawiki:Common.css For example, putting the codes given below in Mediawiki:Common.css would result as explained below:

This would set the toc to appear just below the banner in case its long. Note that doing this would cause every page on wiki to have toc at bottom. However using bottomtoc=yes as a paramter would only show toc at the bottom on the page its used.

Would set the font size of Banner Name as 1em.

Would reduce the vertcial spacing between lines of Table of contents

Would set some blank space between banner and toc.