Extension:WikidataPageBanner

MediaWiki manüel uzantıları

WikidataPageBanner Sürüm durumu: kararlı
Uygulama	Ayrıştırıcı işlevi
Açıklama	Viki sayfalarının en üstüne geniş başlık resimleri ekler.
Yazar(lar)	(under the mentorship of User:Jdlrobson and User:Syced). (Sumitmesaj)
En son sürüm	0.0.3
MediaWiki	>= 1.43
PHP	5.4+
Lisans	GNU Genel Kamu Lisansı 2.0 veya üstü
İndir	Uzantıyı indir Git [?]: Git master'ı indir depoyu göz at (GitHub) geçmişi işleyin veri deposu katkıda bulunanlar (GitHub) kod incelemesi README
Parametreler $wgWPBDisabledNamespaces $wgWPBEnableHeadingOverride $wgWPBSkinDisabled $wgWPBBannerProperty $wgWPBEnablePageImagesBanners $wgWPBStandardSizes $wgWPBImage $wgWPBDisplaySubtitleAfterBannerSkins $wgWPBNamespaces $wgWPBEnableMainPage $wgWPBEnableDefaultBanner
Etiketler pagebanner
Kullanılan kancalar BeforePageDisplay OutputPageParserOutput ParserFirstCallInit ParserOutputPostCacheTransform SiteNoticeAfter
Quarterly downloads	23 (Ranked 110th)
Translatewiki.net adresinde mevcutsa, WikidataPageBanner uzantısını çevirin
Sorunlar	Açık görevler · Hata bildir

WikidataPageBanner uzantısı, viki sayfalarının en üstüne başlık resimleri ekler. Bunları belirtilen ad alanlarının her sayfasına veya yalnızca tek tek sayfalara ekleyebilir. The image filenames can be stored on Wikidata (with page banner (P948)) instead of in the local wiki.

Sayfa başlık resimleri, Vikigezgin projelerinde yaygın olarak kullanılmaktadır. Bu uzantı büyük ölçüde Vikigezgin'in sayfa başlığı şablonundan esinlenmiştir.

Kurulum

• Dosyaları indirin ve extensions/ klasörünüzdeki WikidataPageBanner adlı dizine yerleştirin.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikidataPageBanner
• LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:

  wfLoadExtension( 'WikidataPageBanner' );
  

•  Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

Kullanım

There are a few different ways to set a banner image on a page:

1. File:Image_name.jpg özel bir başlık resmi olarak kullanmak için sayfada ayarlayın: {{PAGEBANNER:Image_name.jpg}}
2. Uzantı, $wgWPBImage yapılandırma değişkeni aracılığıyla belirlenen, belirtilen ad alanlarının tüm sayfalarına aynı başlık resmini otomatik olarak ekleyebilir.
3. Viki Vikiveri'ye bağlıysa, oradan her sayfanın başlığını da getirebilir. In this case, the Template:PAGEBANNER must exist (but it can be empty). İngilizce Vikigezgin, işleme mantığı ve ek şablon bağımlılıkları olan karmaşık bir Template:Pagebanner örneğine sahiptir.

{{PAGEBANNER}} işlevinin parametreleri

{{PAGEBANNER}} ayrıştırıcı işlevi için aşağıdaki parametreler desteklenir:

• |pgname= — Büyük bannera özel bir başlık ekler.
• |icon-*= — To add custom icons, add the parameter |icon-<icon_name>=<Article about icon> (where <icon_name> is any icon name that you want). Then define a background-image on .oo-ui-icon-<icon_name>, in MediaWiki:Common.css to use as the icon. Do this for any number 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 section #Styling below.
• |extraClass= — Use |extraClass=<css-class names> (separated by spaces) to add additional classes to banners which can be used to customize it using styles in MediaWiki:Common.css
• |origin= — See section #origin below.
• |link= — Sets the target of the banner link and operates the same as the link parameter for images (e.g. |link=Event name will link to the 'Event name' page rather than the banner image page). Set to no value to remove the link, i.e. |link=.

'origin' parametresi

Banner coordinate system.

Resminin önerilen bir odak alanını tanımlamak için bu parametreyi kullanın. Bu, küçük ekranlarda başlığı uygun şekilde kırpmak için kullanılır. Parametrenin değeri, virgülle ayrılmış bir x ve y koordinatından oluşmalıdır. Her koordinat, görüntünün merkezinden -1 ile 1 arasında bir değer olarak mesafeyi temsil eder. Örneğin, |origin=1,1 sağ üst köşe ve |origin=-1,1 sağ alt köşedir. See the image at right for a graphical representation of the coordinates.

|origin= hedef başlıktan çok daha büyük olan resimler (ör. panoramalar veya portre fotoğrafları) için olduğunu unutmayın. Yeniden konumlandırmanın, afiş alanı içinde boş boşluklara yol açtığı bannerları yeniden konumlandırmaz. Örneğin, banner 320 piksel genişlik ve 180 piksel yükseklikte oluşturuluyorsa, 320 piksel ve 180 piksel de olan bir resim hiç yeniden konumlandırılamaz; 600 piksel genişlik ve 180 piksel yükseklikte bir görüntü yatay olarak yeniden konumlandırılabilir ve 320 piksel genişlik ve 1000 piksel yükseklikte bir görüntü dikey olarak yeniden konumlandırılabilir.

Yapılandırma değişkenleri

$wgWPBImage kullanılacak varsayılan banner görüntüsünü ayarlamak için kullanılır. 'Dosya:' ad alanına önek eklemeden resim adı ekleyin. Vikinin varsayılan bannerlara ihtiyacı yoksa, bu alanı düzenlemeyin.

$wgWPBImage = "foo.jpg";

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

$wgWPBBannerProperty = "P948";

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

$wgWPBEnableDefaultBanner = true;

Başlığın görüntüleneceği $wgWPBNamespaces ad alanı dizisi. Varsayılan Ana ad alanıdır. Ayrıca true() değerine de ayarlanabilir; bu durumda $wgWPBDisabledNamespaces hariç tutulanlar hariç tüm Ad Alanlarında bannerı etkinleştirir.

$wgWPBNamespaces = [ NS_MAIN ];

$wgWPBDisabledNamespaces, belirli ad alanlarının banner gösterilmesini hariç tutar. Bu parametrenin yalnızca $wgWPBNamespaces, true ise etkili olduğunu unutmayın. Aksi takdirde, bu parametre dikkate alınmaz ve yalnızca $wgWPBNamespaces içindeki ad alanları dikkate alınır.

$wgWPBDisabledNamespaces = [ NS_FILE ];

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

$wgWPBStandardSizes = [ 320, 640, 1280, 2560 ];

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

$wgWPBEnablePageImagesBanners = true;

$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).

$wgWPBDisplaySubtitleAfterBannerSkins = [ 'minerva' ];

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

$wgWPBEnableHeadingOverride = true;

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

$wgWPBEnableMainPage = false;

Examples

A few use examples with explanation:

{{PAGEBANNER:Grand_canyon.jpg}}

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

{{PAGEBANNER:Grand_canyon.jpg|icon-star=<Name of star article>|icon-unesco=<Name of Unesco Article>}}

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.

{{PAGEBANNER:Grand_canyon.jpg|toc=yes|pgname=Some page}}

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.

{{PAGEBANNER:Grand_canyon.jpg|extraClass=class1 class2}}

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. Then leave the image name empty, and set any other required parameters:

{{PAGEBANNER:|other options...}}

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 $wgWPBImage is set).

Styling

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

.wpb-topbanner-toc {
    position: relative;
}

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 bottomtoc=yes as a paramter would only show the ToC at the bottom on the page it's used.

.wpb-topbanner .wpb-name {
    font-size: 1em;
}

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

.wpb-banner-toc {
    line-height: 1em;
}

Would reduce the vertical spacing between lines of the ToC.

.wpb-topbanner-toc {
    margin-top: 5px;
}

Would set some blank space between the banner and ToC.