Extension:CommonsMetadata

From mediawiki.org
This page is a translated version of the page Extension:CommonsMetadata and the translation is 86% complete.
MediaWiki manüel uzantıları
CommonsMetadata
Sürüm durumu: kararlı
Uygulama API
Açıklama Ortak sayfalardan meta veri ayıklama dener
Yazar(lar) Brian Wolff (bawolffmesaj)
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.25+
PHP 5.4+
Veritabanı değişiklikleri Hayır
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
  • $wgCommonsMetadataForceRecalculate
  • $wgCommonsMetadataPublicDomainPageUrl
  • $wgCommonsMetadataSetTrackingCategories
Quarterly downloads 71 (Ranked 85th)
Public wikis using 1,055 (Ranked 247th)
Translatewiki.net adresinde mevcutsa, CommonsMetadata uzantısını çevirin
Sorunlar Açık görevler · Hata bildir

CommonsMetadata uzantısı, Wikimedia Commons sayfalarından meta verileri çıkarma girişimidir ancak diğer tüm Wikimedia projelerinde de mevcuttur. Resim açıklamasındaki şablonlara ve kategorilere göre imageinfo API'ye bazı ekstra bilgiler ekler. Daha iyi ışık kutuları veya resim seçim diyalogları sağlamak için bir dizi uzantı/araç tarafından kullanılır (örneğin Extension:MultimediaViewer , Extension:VisualEditor , Extension:MobileFrontend , Mobile-Content-Service (MCS)).

Mevcut biçimindeki uzantının geçici bir çözüm olması amaçlanmıştır ve sonunda Commons'ta Vikiveri ile değiştirilmiştir.

Kurulum

  • Dosyaları indirin ve extensions/ klasörünüzdeki CommonsMetadata 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/CommonsMetadata
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'CommonsMetadata' );
    
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

Motivasyon ve tasarım seçenekleri

mailarchive:wikitech-l/2013-August/071593.html sayfasına bakın

Bu uzantının varsayımları aşağıdaki gibidir.

  • Gelecekte bir noktada, Vikiveri meta verilerin işlenmesini üstlenecek. Yakında yeniden değiştirilmesi gerekecek olan anlaşmazlık değişikliklerden kaçınmak için, uzantı şu anda olduğu gibi ortak meta verilerle çalışmalıdır (bu nedenle yeni ayrıştırıcı işlevlerini tanıtmaz). Bu nedenle ekran kazıma.
  • Ortak bir açıklama sayfasındaki alanların çoğunun içeriği zengin biçimlendirme içerir (Özellikle: Bağlantılar, eğik, kalın. Bazı durumlarda gömülü resimler gibi daha karmaşık şeyler)
    • Sonuç olarak, uzantı çıkışları html'yi ayrıştırdı (vikimetin berbat, düz metin verileri yakalamıyor)
    • Ayrıca, veriler (örneğin) makine tarafından biçimlendirilmiş tarihler yerine insan görüntüsü için biçimlendirilme eğilimindedir. Tarih alanı "yaklaşık 1600'ler" gibi bir şey söylediğinde, bunu kesin bir tarihe dönüştürmek zordur (otoh, birçok örnek olabilir).
    • Bunu ileriye taşımak için, vikide kontrol edilen exif meta verilerine biçimlendirme de uygulayın (Örneğin, commons kamera adını bir Vikipedi maddesine bağlar)
  • Açıklama sayfasından bilgi alamıyorsak, ancak dosyanın yazarı exif/XMP/iptc meta verilerinde etiketlenmişse, bunu bir yedek olarak kullanmalıyız.
  • İdeal olarak, böylesi bir sistem, Commons ve ortak olmayanlar kısımları ayrı olacak şekilde, olabildiğince ortak-denetimsel olacaktır.
  • Commons açıklama sayfalarında çok dilli açıklamalar bulunur. Pek çok kullanıcı muhtemelen yalnızca bir dil istiyor.
    • Bu uygulamada, tarihlere ve şeylere dil kurallarına göre uygulanır. Ek olarak, açıkça çok dilli alanlar (açıklama) için, tümünü veya yalnızca tek bir dili döndürme seçeneği vardır. Tek dil modunda bile, bazı şeyler yine de dile özgüdür (sayılar üzerindeki binlik ayırıcı gibi)

Configuration

parameter default description
$wgCommonsMetadataSetTrackingCategories false Add the following tracking categories to file pages when the corresponding information is not provided either via templates on the file page of (for some of these) EXIF metadata:
  • Files with no machine-readable license (commonsmetadata-trackingcategory-no-license)
  • Files with no machine-readable description (commonsmetadata-trackingcategory-no-description)
  • Files with no machine-readable author (commonsmetadata-trackingcategory-no-author)
  • Files with no machine-readable source (commonsmetadata-trackingcategory-no-source)
  • Files with no machine-readable patent (commonsmetadata-trackingcategory-no-patent) (for 3D files)
$wgCommonsMetadataPublicDomainPageUrl https://commons.wikimedia.org/wiki/Help:Public_domain Link used for 'license' attribute in schema.org markup for files in the public domain.
$wgCommonsMetadataForceRecalculate false Force calculation of metadata even when the image is from a foreign repository which would provide it. This is meant for local development.

Test

Uyarı Uyarı: Bu uzantıyı geliştiriyorsanız veya test ediyorsanız, derlenmesi çok uzun sürdüğünden ve Scribunto gibi karmaşık bağımlılıklara sahip olduğundan, Commons şablonlarını resim meta verileri için kopyalamanızı ÖNERMİYORUZ. Bunun yerine, yalnızca vikimetin/HTML içeren ve çeşitli parametre kaynakçasını manüel olarak yerleştiren (veya koymayan) genişletilmiş bir sürüm edinin. Bir örnek (Special:Import ile kullanılmak üzere) burada bulabilirsiniz. Veya varsayılan olarak belirli şablonları içeren Vagrant 'ı kullanın.

Uzak resimlerle test ederken (örneğin, $wgUseInstantCommons etkinleştirdiyseniz Commons resimleri), CommonsMetadata'yı resmini açıklama sayfasını ayrıştırmaya ve meta verileri çıkarmaya zorlamak için $wgCommonsMetadataForceRecalculate = true; ayarlayabilirsiniz (normalde, uzak depoda CommonsMetadata da yüklüyse, API çıkışını oradan kopyalar).

Kullanım

imageinfo API'yi kullanın ve extmetadata ile iiprop belirtilen bir resim bilgisi özelliği olarak ekleyin.

Örnek kullanım:

https://commons.wikimedia.org/w/api.php?action=query&prop=imageinfo&format=json&iiprop=extmetadata&iilimit=10&titles=File%3ACommon%20Kingfisher%20Alcedo%20atthis.jpg

Bu örneği API deneme tahtasında görüntüleyin:

https://www.mediawiki.org/wiki/Special:ApiSandbox#action=query&prop=imageinfo&format=json&iiprop=extmetadata&iilimit=10&titles=File%3ACommon%20Kingfisher%20Alcedo%20atthis.jpg

Verilen veriler

Uzantı şu anda yanıtın extmetadata alanında aşağıdaki öğeleri sağlamaktadır (alan adları, mümkün olduğunda, kullanılan IPTC-IIM biçimini EXIF başlıkları takip etmek için seçilmiştir):

Bilgi şablonundaki makine tarafından okunabilir verilere dayalı veriler:

  • ImageDescription - resim açıklaması
  • Artist - yazar adı (karmaşık HTML, birden çok yazar vb. içerebilir)
  • Credit - kaynak
  • DateTimeOriginal - oluşturma zamanı (mümkün olduğunda boşlukla ayrılmış ISO 8601 zaman damgası, ancak bir tarihin başka herhangi bir metinsel açıklaması olabilir, muhtemelen HTML karıştırılmış halde)
  • ObjectName - başlık (kitap/resim için; aksi takdirde yalnızca dosya adı)
  • Permission - şablonun İzin alanının içeriği. Pek çok şey olabilir (lisans şablonu, OTRS kimliği, nasıl atfedileceğine dair ayrıntılar...)
  • AuthorCount - yazarların olduğu şablonların sayısı (ör. Kitap, Fotoğraf...). Bir şablon tek bir dizede birden çok yazarı tanımlıyorsa gerçek yazarların sayısı daha yüksek olabilir.

Konum şablonundaki makine tarafından okunabilir verilere dayalı veriler:

  • GPSLatitude - enlem
  • GPSLongitude - boylam
  • GPSMapDatum - koordinat türü (şimdilik yalnızca WGS-84 desteklenmektedir)

Lisans şablonundaki makine tarafından okunabilir verilere dayalı veriler:

  • LicenseShortName - kısa insan tarafından okunabilir lisans adı
  • LicenseUrl
  • UsageTerms
  • Copyrighted - True veya False (kamu malı resimler için)

Çok lisanslı resimler için bu değerler şu anda güvenilir değildir.

  • Attribution - Sanatçı + Katkının yerini alması gereken özel ilişkilendirme (Bilgi şablonundan da kaynaklanabilir)
  • AttributionRequired - booleanish (phab:T86726), atıfta bulunmak için yasal bir gereklilik olup olmadığını söyler
  • NonFree - booleanish, true, görselin özgür bir lisans kapsamında olmadığı anlamına gelir. (Yalnızca Commons olmayan resimler için kullanılır.)

Diğer veri:

  • CommonsMedadataExtension - meta veri ayrıştırıcı sürüm numarasını içerir; çoğunlukla dahili kullanım için
  • License - resmin lisansına ilişkin en iyi tahmin (çoğunlukla MediaViewer tarafından dahili kullanım için değişebilir; LicenseShortName muhtemelen daha güvenilirdir)
  • Categories - resim kategorilerinin |-ayrılmış listesi.
  • Assessments - resminin değerlendirmelerinin |-ayrılmış listesi (şu anda beş değer desteklenmektedir: poty, potd, featured, quality, valued). Kategori adlarının ayrıştırılmasına bağlı olarak, Commons'ta barındırılmayan resimler için muhtemelen çalışmayacaktır.
  • Restrictions - ticari markalar veya kişilik hakları gibi kısıtlamaları yeniden kullanma; bir anahtar kelime dizisi (bu tablodan, restriction- öneki olmadan sınıf adları). MediaViewer'daki restrict-* simgelerine de bakın.
  • DeletionReason - ayarlanmışsa, şablon silinmek üzere değerlendirilir. (nuke şablonuna dayalıdır, muhtemelen Commons dışında güvenilir değildir.) Bir silme nedeni içerir, ancak bir günlük girişi için geçerli olduğu ifade edilir, bu nedenle yanıltıcı olabilir (örneğin, resminin silinip silinmeyeceğine henüz karar verilmediğinde geçmiş zaman).

Ayrıca bakınız