Extension:PageImages

This extension comes with MediaWiki 1.34 and above. Böylece tekrar indirmek zorunda değilsiniz. Ancak, verilen diğer talimatları izlemeniz gerekir.

This extension is under code stewardship review and not actively maintained (görev T252249). No new feature requests will be considered during this period.

MediaWiki manüel uzantıları

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ı	MediaWiki ile birlikte anlık görüntüler yayımlanır. Master geriye dönük olarak uyumlu değil.
MediaWiki	1.37+
PHP	7.3.19+
Veritabanı değişiklikleri	Hayır
Lisans	WTFPL 2.0
İndir	Uzantıyı indir Git [?]: Git master'ı indir depoyu göz at (Phabricator · GitHub) geçmişi işleyin veri deposu katkıda bulunanlar (GitHub) kod incelemesi
Parametreler $wgPageImagesOpenGraphFallbackImage $wgPageImagesDenylist $wgPageImagesScores $wgPageImagesNamespaces $wgPageImagesAPIDefaultLicense $wgPageImagesExpandOpenSearchXml $wgPageImagesLeadSectionOnly $wgPageImagesOpenGraph $wgPageImagesDenylistExpiry
Kullanılan kancalar ApiOpenSearchSuggest BeforePageDisplay InfoAction ParserAfterTidy ParserModifyImageHTML ParserTestGlobals SearchResultProvideThumbnail SpecialMobileEditWatchlist::images
Quarterly downloads	120 (Ranked 49th)
Public wikis using	2,271 (Ranked 191st)
Translatewiki.net adresinde mevcutsa, PageImages uzantısını çevirin
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.

PageImages, Facebook gibi üçüncü tarafların çıkarması için vikideki maddeler için OpenGraph protokolü meta verileri de sağlar.

Kurulum

• Dosyaları indirin ve extensions/ klasörünüzdeki PageImages 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/PageImages
• LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:

  wfLoadExtension( 'PageImages' );
  

• Configure as required
• To initially assign the page images to the pages, run the "initImageData.php" script from the extensions maintenance directory (/path/to/extensions/PageImages/maintenance/)
•  Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

Yapılandırma

$wgPageImagesDenylist, resim reddetme listeleri için bir dizi kaynaktır. Listelenen resimler hiçbir zaman sayfa resmi olarak seçilmeyecektir. Örnekler:

$wgPageImagesDenylist = [
	// Page on local wiki
	[
		'type' => 'db',
		'page' => 'MediaWiki:Pageimages-denylist',
		'db' => false,
	],
	// Page on Wikimedia Commons, for other Wikimedia projects using direct DB access
	[
		'type' => 'db',
		'page' => 'MediaWiki:Pageimages-denylist',
		'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 denylisted file.png]]
* [[:File:Second denylisted 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.

$wgPageImagesDenylistExpiry, 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.

After the change, you'll have to run refreshLinks.php to generate the Page image information for those namespaces (hopefully, you can use the --namespace parameter to process only pages on the affected namespaces, since that script is very resource-intensive)

$wgPageImagesOpenGraph enables or disables the OpenGraph meta tags (could be useful if other extensions manage these tags) (1.39+). Default: true

$wgPageImagesOpenGraphFallbackImage, bir sayfada resim olmadığında gösterilecek olan yedek resmin URL'sidir. Varsayılan: false

Yükseltme notları

• MediaWiki 1.37'den beri $wgPageImagesBlacklist ve $wgPageImagesBlacklistExpiry, sırasıyla $wgPageImagesDenylist ve $wgPageImagesDenylistExpiry olarak yeniden adlandırılmıştır. Eski değişken adlarını kabul etmek için geriye dönük uyumluluk kodu eklenmemiştir; bu, yükseltme sırasında değişken adlarını değiştirmeniz veya yükseltmeye hazırlık için her iki değişkeni de önceden tanımlamanız gerektiği anlamına gelir.
• MediaWiki 1.37'den beri, $wgPageImagesDenylist için varsayılan sayfa değeri MediaWiki:Pageimages-blacklist üzerinden MediaWiki:Pageimages-denylist ile değiştirilmiştir. Vikinizde MediaWiki:Pageimages-blacklist içerik eklediyseniz, yükseltme sırasında onu yeniden adlandırmalısınız. Yükseltme için önceden hazırlanmak istiyorsanız, sayfayı yeni adla yeniden adlandırabilir ve ayrıca yeni sayfa adına $wgPageImagesBlacklist (eski değişken adı) ayarlayabilirsiniz ve yükseltme sırasında önceki değişikliğinizi eşleşmesi gereken varsayılan değer kullanılacaktır.

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.

• https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:PageImages#API

Specific parameters:

Other general parameters are available.

piprop

Which information to return:

thumbnail

URL and dimensions of thumbnail image associated with page, if any.

name

Image title.

original

URL and original dimensions of image associated with page, if any.

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:

free

Only free images.

any

Best image, whether free or non-free.

One of the following values: any, free

Default: free

picontinue

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.

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.

api.php?action=query&prop=pageimages&titles=Lightbox_demo [ApiSandbox'ta deneyin]

Sonuç

{ "query": { "normalized": [ { "from": "Lightbox_demo", "to": "Lightbox demo" } ], "pages": { "162510": { "pageid": 162510, "ns": 0, "title": "Lightbox demo", "thumbnail": { "source": "https://upload.wikimedia.org/wikipedia/commons/thumb/e/e9/Crystal_Clear_app_korganizer.png/50px-Crystal_Clear_app_korganizer.png", "width": 50, "height": 50 }, "pageimage": "Crystal_Clear_app_korganizer.png" } } } }

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 vikilerindeki 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 0.4 ile 3.1 arasında bir orana izin verilir ve tercih edilen 0.6 ile 2.1 arasındadır.
    • The default value is $wgPageImagesScores['ratio'] = ["3" => -100, "5" => 0, "20" => 5, "30"=> 0, "31"=> -100]; with the key representing the width divided by height, rounded to the tenths place, and the decimal shifted one position to the right. An image 400px wide by 300px high would have a value of 13. The key's value is the scoring multiple associated with that ratio. Keys are selected and increase from zero, with a new scoring multiple not taking effect until the key has met or exceeded its value but not exceeded the next key. Diğer tüm resimler olumsuz puan alacak ve atılacaktır.

How are page images updated?

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

Belirli sayfa resimlerini hariç tutabilir miyim?

Evet!

Tüm bir viki için, yöneticilerin MediaWiki:Pageimages-denylist altında düzenleyebileceği bir sayfa vardır (örnek). Burada görünen hiçbir resim, herhangi bir madde için sayfa resmi olmayacaktır.

Belirli sayfalar için, hariç tutmak istediğiniz her resme |class=notpageimage ekleyin. Örneğin, [[File:Example.png|class=notpageimage]]. Daha fazla ayrıntı phab:T301588 sayfasındadır.

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

• Extension:Popups