Extension:PageImages

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:PageImages and the translation is 100% complete.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎français • ‎polski • ‎русский • ‎中文 • ‎日本語
Bu uzantı MediaWiki 1.34 ve üstü ile gelir. Böylece tekrar indirmek zorunda değilsiniz. Ancak, verilen diğer talimatları izlemeniz gerekir.
MediaWiki manüel uzantıları
OOjs UI icon advanced.svg
PageImages
Sürüm durumu: kararlı
Uygulama API , Ayrıştırıcı uzantısı
Açıklama Bir sayfayı temsil eden resimler hakkında bilgi depolar
Yazar(lar) Max Semenik (MaxSemmesaj)
En son sürüm güncellemeler devam etmekte
Uyumluluk politikası sürüm dalları
MediaWiki 1.25+
PHP 5.4+
Veritabanı değişiklikleri Hayır
Lisans WTFPL 2.0
İndir
  • $wgPageImagesNamespaces
  • $wgPageImagesBlacklistExpiry
  • $wgPageImagesScores
  • $wgPageImagesBlacklist
  • $wgPageImagesLeadSectionOnly
  • $wgPageImagesAPIDefaultLicense
  • $wgPageImagesExpandOpenSearchXml
Translatewiki.net adresinde mevcutsa, PageImages uzantısını çevirin
Kullanım ve sürüm matrisini kontrol edin.
Sorunlar Açık görevler · Hata bildir

PageImages uzantısı bir sayfada kullanılan resimler hakkında bilgi toplar.

Amacı, bir madde ile ilişkilendirilmiş en uygun küçük resmi döndürmektir.

MediaWiki 1.29'dan bu yana, PageImages, Facebook gibi üçüncü tarafların çıkarması için vikideki maddeler için OpenGraph protokolü meta verileri sağlar.

Kurulum

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

MediaWiki 1.27 veya önceki bir sürümü çalıştıran kullanıcılara:

Yukarıdaki talimatlar, bu eklentiyi wfLoadExtension() kullanarak kurmanın yeni yolunu açıklar. Bu uzantıyı önceki sürümlerine (MediaWiki 1.27 ve önceki sürümler) yüklemeniz gerekirse, wfLoadExtension( 'PageImages' ); yerine kullanmanız gerekir:

require_once "$IP/extensions/PageImages/PageImages.php";

API

PageImages uzantısı, action=query için properties API'sine bir prop=pageimages ekleyerek resim bilgileri sağlar.

prop=pageimages (pi)

(main | query | pageimages)
  • This module requires read rights.
  • Source: PageImages
  • License: WTFPL

Returns information about images on the page, such as thumbnail and presence of photos.

Parameters:
piprop

Which information to return:

thumbnail
URL and dimensions of thumbnail image associated with page, if any.
original
URL and original dimensions of image associated with page, if any.
name
Image title.
Values (separate with | or alternative): name, original, thumbnail
Default: thumbnail|name
pithumbsize

Maximum width in pixels of thumbnail images.

Type: integer
Default: 50
pilimit

Properties of how many pages to return.

Type: integer or max
The value must be between 1 and 50.
Default: 50
pilicense

Limit page images to a certain license type

One of the following values: any, free
Default: free
picontinue

When more results are available, use this to continue.

Type: integer
pilangcode

Code for the language the image is going to be rendered in if multiple languages are supported

Example:
Get name and 100-pixel thumbnail of an image on the Albert Einstein page.
api.php?action=query&prop=pageimages&titles=Albert%20Einstein&pithumbsize=100 [open in sandbox]

Yanıt

{
  // piprop.name (and image exists)
  pageimage?: string // Source image filename (basename of original.source).
  // piprop.thumbnail (and image exists)
  thumbnail?: {
    source: string // Thumbnail image URL.
    width: number // Thumbnail image width in pixels.
    height: number // Thumbnail image height in pixels.
  }
  // piprop.original (and image exists)
  original?: {
    source: string // Source image URL.
    width: number // Source image width in pixels.
    height: number // Source image height in pixels.
  }
}

Örnek istek

Bir madde için sayfa resmi isteyin.

Yapılandırma

$wgPageImagesBlacklist, resim kara listeleri için bir dizi kaynaktır. Kara listeye alınan resimler asla sayfa resimleri olarak seçilmeyecektir. Örnekler:

$wgPageImagesBlacklist = [
	// Page on local wiki
	[
		'type' => 'db',
		'page' => 'MediaWiki:Pageimages-blacklist',
		'db' => false,
	],
	// Page on Wikimedia Commons, for other Wikimedia projects using direct DB access
	[
		'type' => 'db',
		'page' => 'MediaWiki:Pageimages-blacklist',
		'db' => 'commonswiki',
	],
	// Page on Commons, for third-party sites using web access
	[
		'type' => 'url',
		'url' => 'http://commons.wikimedia.org/w/index.php?title=somepage&action=raw',
	],
];

Aynı anda birden fazla kaynak kullanılabilir.

Kara listenin kendisi, kara listeye alınan dosyalara bir viki bağlantısı içermelidir, içeriğin geri kalanı alakasızdır (ve diğer sayfalara bağlantılar içerebilir). Örneğin:

* [[:File:First blacklisted file.png]]
* [[:File:Second blacklisted file.jpeg]]
...

Sayfaya resim eklenmesiyle sonuçlanan dosya bağlantılarının çalışmayacağını unutmayın (bu dosyalar bir nedenle kara listeye alınmıştır, değil mi?), bu nedenle bağlantıların önündeki : ifadesini unutmayın.

$wgPageImagesBlacklistExpiry, kara listenin ne kadar süre önbelleğe alınacağını saniye cinsinden belirler. Varsayılan: 15 * 60 (15 dakika).

$wgPageImagesExpandOpenSearchXml, true olarak ayarlanırsa, PageImages, opensearch API modülündeki resim algılamasını kendi, daha doğru sonuçlarla geçersiz kılar. Varsayılan: false.

$wgPageImagesNamespaces, PageImages'ın etkinleştirileceği bir ad alanları dizisidir. Varsayılan: NS_MAIN.

Nasıl çalışır

Bir sayfa yerel bir resim ile kaydedildiğinde, ayrıştırıcı, kancanın ParserMakeImageParams ve LinksUpdate çalıştırır. PageImages uzantısı bunlara (ve diğer kancalara) yanıt verir ve page_props tablosuna sayfa için yeni bir özellik ekler. Özellik adı page_image_free ve değeri resminin adıdır.

Uzantı yalnızca seçilen resim adını saklar. Yazarken Sayfa bilgisi, Hovercards ve Mobil arama gibi diğer özellikler resmini görüntüleyebilir.

Resim seçimi

Hangi resminin bir sayfayla ilişkili olduğunu nasıl kontrol edebilirim?

Sayfa resimleri ?action=info sayfasında listelenecektir.

Resimleri nasıl seçiyor?

Sayfadaki tüm resimler toplanır ve her resim için bir puan hesaplanır. En yüksek puana sahip resim, sayfa resmini olarak seçilir. Viki, resimlerin özgürce lisanslanmadığını belirten meta veriler içerecek şekilde yapılandırılırsa, en iyi puana sahip olan ve yine özgürce lisanslanan resim de depolanır. Uygun bir resim bulunmazsa veya tüm resimler kötü puan alırsa (yani negatif bir puana sahipse), sayfada herhangi bir resim olmayacaktır.

$wgPageImagesLeadSectionOnly true ise, yalnızca öncü bölümdeki resimler dikkate alınacaktır. Şu anda yalnızca Vikipedi projeleri için geçerlidir, diğer tüm projeler öncülüğün dışından resim çekebilir.

Resimler nasıl puanlanır?

Wikimedia wivikilerindeki mümkün olan en iyi sayfa resmi, 400-600 piksel arasında bir genişlik/yüksekliğe ve diğer boyutun değerinin iki katı olan bir yükseklik/genişliğe sahip bir maddedeki ilk dört resimden biridir.

  • Algoritma yapılandırılabilir.
  • Puanlar aşağıdakilerin bir kombinasyonu ile hesaplanır:
    • $wgPageImagesScores['width'] içinde tanımlanan resim genişlikleri
      • Wikimedia wivikilerinde, 119 pikselden küçük resimler oldukça olumsuz olarak ağırlıklandırılır. 400px-600px arası genişliğe sahip resimler tercih edilir, alt sınır tercih edilir.
      • Galerilerin içindeki resimler $wgPageImagesScores['galleryImageWidth'] kullanılarak ayrı ayrı puanlanır.
        • Wikimedia'da 100'den küçük viki galeri resimleri dikkate alınmamaktadır.
    • Belgedeki konum ayrıca $wgPageImagesScores['position'] içinde tanımlandığı gibi kabul edilir.
      • Wikimedia vikilerinde, yalnızca belgede görünen ilk 4 resim dikkate alınır.
    • Resmin genişliğinin yüksekliğe oranı $wgPageImagesScores['ratio'] olarak kabul edilir.
      • Wikimedia vikilerinde mümkün olan en iyi resimler, yüksekliğin genişliğin yarısı veya yüksekliğin genişliğin iki katı olduğu resimlerdir. Oranı 0,5'ten az olan tüm resimler negatif olarak puanlanacak ve silinecektir.

Lütfen daha teknik olun...

LinksUpdate kancası çalıştırıldığında Pageimages resimleri doldurur.

PageImages'da bu, LinksUpdateHookHandler::doLinksUpdate içinde yürütülür

Belirli sayfa resimlerini hariç tutabilir miyim?

Evet! Her vikide, MediaWiki:MediaWiki:Pageimages-blacklist üzerinde hizmetlilerin düzenleyebileceği bir kara liste vardır (örnek). Burada görünen hiçbir resim, herhangi bir madde için sayfa resmi olmayacaktır.

Ya yalnızca belirli bir madde için ise?

Maalesef şu anda değil. Lütfen kara listeyi kullanın veya resmi kurşun bölümünün dışına taşıyın.

Bir sayfanın sayfa resmini nasıl görebilirim?

Kenar çubuğundaki Sayfa bilgisi bağlantısını kullanarak (veya URL'ye action=info ekleyerek) mevcut resim seçimini görebileceksiniz.

Kötü bir resmi nasıl temizleyebilirim?

Sayfa resmi yalnızca bir maddedeki bağlantı değiştiğinde değişir. Acil durumlar için, lütfen sayfadan bağlantı ekleyin/kaldırın, gerekirse geri alın. Temizleme çalışmayacaktır. Daha büyük acil durumlar için lütfen bir Phabricator bileti açın.

Sayfa resmim neden boş bir kutu?

Bu muhtemelen maddenizde ki video içeriğiyle ilgilidir. Bir video dosyası boş bir ekranla başlarsa, bu video için varsayılan küçük resim olur ve sayfa resmi olarak kullanılırsa, sayfa resmi olur. Şu anda bunun için bir videonun varsayılan küçük resmini değiştirmenize izin verecek bir düzeltme üzerinde çalışıyoruz. Daha fazla bilgi için phab:T92457 ve phab: T22647 sayfalarına bakın.

Ayrıca bakınız