Extension:WikidataPageBanner/ru

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

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

Использование
There are a few different ways to set a banner image on a page:


 * 1) Чтобы использовать   как собственное изображение баннера, используйте:
 * 2) Расширение может автоматически добавить такой баннер на все страницы в указанных пространствах имён, если задана конфигурационная переменная.
 * 3) Если вики связана с Викиданными, она также может получать оттуда баннеры.

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

Параметры для функции
Следующие параметры поддерживаются функцией парсера :


 * — Добавляет пользовательский заголовок к баннеру.
 * — To add custom icons, add the parameter  (where   is any icon name that you want). Then define a background-image on , in MediaWiki:Common.css to use as the icon. Do this for any number of icons to add to the page.
 * — Use  to show image description on hovering over image.
 * — Use  to enable a Table Of Contents within banner.
 * — Use  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  below.
 * — Use  (separated by spaces) to add additional classes to banners which can be used to customize it using styles in MediaWiki:Common.css
 * — See parameter below.
 * — Sets the target of the banner link and operates the same as the link parameter for images (e.g.  will link to the 'Event name' page rather than the banner image page). Set to no value to remove the link, i.e..

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

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

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

$wgWPBBannerProperty Banner property on Wikidata which holds a commons media file. Essential if Wikidata is enabled.

$wgWPBEnableDefaultBanner enables the default banner image on pages without the use of.

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

$wgWPBDisabledNamespaces исключает определенные пространства имен от показа баннера. Обратите внимание, что этот параметр действует только в том случае, если имеет значение. В противном случае этот параметр игнорируется, и рассматриваются только пространства имен в $wgWPBNamespaces.

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

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

$wgWPBDisplaySubtitleAfterBannerSkins is an array of names of skins that should have the banner displayed in the site-notice area, instead of in the page subtitle (which is the default).

$wgWPBEnableHeadingOverride determines whether the page title is displayed overlayed on the banner image. Defaults to true.

$wgWPBEnableMainPage determines whether a banner is allowed to be shown on the. Defaults to false.

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  is set to correct Wikidata banner property. Then leave the image name empty, and set any other required parameters:

This will use the banner image as set on the page's Wikidata item. If there is no banner image set for that item, or the page doesn't have a Wikidata item, a default image may be used (if  is set).

Styling
The extension has ample scope for styling the banner via Common.css. Here are some examples of common CSS changes.

This sets the ToC to appear just below the banner in case it's long. Note that doing this would cause every banner page on a wiki to have the ToC at the bottom of the banner. However, using  as a paramter would only show the ToC at the bottom on the page it's used.

Would set the font size of the banner name to 1 em (smaller than the default 2.2 em).

Would reduce the vertical spacing between lines of the ToC.

Would set some blank space between the banner and ToC.