Extension:WikidataPageBanner

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:WikidataPageBanner and the translation is 100% complete.
Other languages:
English • ‎Türkçe • ‎svenska • ‎русский • ‎中文 • ‎日本語
MediaWiki manüel uzantıları
OOjs UI icon advanced.svg
WikidataPageBanner
Sürüm durumu: kararlı
Banner ex.png
Uygulama Ayrıştırıcı işlevi
Açıklama Belirtilen ad alanlarındaki sayfaların üst kısmına sayfa çapında banner ekler
Yazar(lar) (under the mentorship of User:Jdlrobson and User:Syced). (Sumitmesaj)
En son sürüm 0.0.3
MediaWiki 1.25+
PHP 5.4+
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
README
  • $wgWPBDisabledNamespaces
  • $wgWPBEnableHeadingOverride
  • $wgWPBSkinDisabled
  • $wgWPBEnablePageImagesBanners
  • $wgWPBBannerProperty
  • $wgWPBImage
  • $wgWPBDisplaySubtitleAfterBannerSkins
  • $wgWPBNamespaces
  • $wgWPBStandardSizes
  • $wgWPBEnableDefaultBanner
pagebanner
Translatewiki.net adresinde mevcutsa, WikidataPageBanner uzantısını çevirin
Kullanım ve sürüm matrisini kontrol edin.
Sorunlar Açık görevler · Hata bildir

WikidataPageBanner uzantısı, vikinin belirtilen ad alanlarının her sayfasına sayfa genişliği bannerları ekler.

Pagewide bannerlar Vikigezgin projelerinde genel olarak kullanılmaktadır. Bu uzantı büyük ölçüde Vikigezgin'in Template:pagebanner tarafından esinlenmiştir.

Kurulum

  • Dosyaları indirin ve extensions/ klasörünüzdeki WikidataPageBanner adlı dizine yerleştirin.
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'WikidataPageBanner' );
    
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

Kullanım

Uzantı, belirtilen ad alanlarındaki sayfalara otomatik olarak bir banner resmi ekler. Özel bir banner resmi kullanmak için şunu kullanın:

{{PAGEBANNER:imagename.jpg}} with a set of parameters explained below.

Viki Vikiveri'ye bağlıysa, oradan da banner getirebilir.

Gerekli Şablon

Şablon:PAGEBANNER bulunmalıdır. Boş olabilir. Vikigezgin, oluşturma mantığı ve ek şablon bağımlılıkları olan bir karmaşık Şablon: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.
  • To add custom icons, add the parameter icon-icon_name=<Article about icon> to {{PAGEBANNER}}. 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 parametresi

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 sol üst köşedir ve origin=-1,1 sol alt köşedir. Daha fazla bilgi için bu grafiğe bakın.

Şu anda uygulandığı gibi, origin parametresinin hedef büyük başlıktan çok daha büyük görüntüler (ö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 parametreleri

Gerekli parametreler

$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 (Essential if Wikidata is enabled) - Banner property on wikidata which holds commons media file

$wgWPBBannerProperty = "P948";

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

$wgWPBEnableDefaultBanner = true;

İsteğe bağlı parametreler

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 = array( NS_MAIN );

$wgWPBDisabledNamespaces, belirli ad alanlarının banner gösterilmesini hariç tutar.

Bu parametrenin yalnızca $wgWPBNamespaces doğruysa geçerliliği olduğunu unutmayın.

Aksi takdirde, bu parametre dikkate alınmaz ve yalnızca $wgWPBNamespaces içindeki ad alanları dikkate alınır.

$wgWPBDisabledNamespaces = array( NS_FILE );

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

$wgWPBStandardSizes = array( 320, 640, 1280, 2560 );

$wgWPBEnablePageImagesBannerswhen 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;

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. Just use

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

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:

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

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.

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

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

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

Would reduce the vertcial spacing between lines of Table of contents

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

Would set some blank space between banner and toc.