Extension:Popups/tr

Popups uzantısı, bir maddeye veya sırasıyla bir kaynağa bağlantı üzerinden geldiğinde sayfa ve kaynak önizlemelerini görüntüler. Birincisi bir maddenin içeriğinin özetlerinden oluşur, ikincisi kaynağın tam içeriğini gösterir.

Uzantı, popüler Gezinti pencereleri küçük araçtan esinlenerek Tasarım ekibinin bir girişimidir. Şu anda bu özellik, oturumu kapatılan kullanıcılar için varsayılan olarak tüm Vikipedi'lerde kullanılabilir. Uzantının nasıl çalıştığına ve Wikimedia projelerinde kullanımına ilişkin daha fazla bilgiye Sayfa Önizlemeleri sayfasından ulaşılabilir.

Kaynak Önizleme özelliği sonunda eklendi ve Almanca konuşan topluluğun Teknik İstek Listesinden bir istek yerine getirmeyi amaçlıyor. Daha ayrıntılı bir açıklama ve kullanımı hakkında daha fazla bilgi altında edinilebilir.

Bağımlılıklar
Bu uzantı, varsayılan  ağ geçidiyle kullanıldığında  ve  ile sıkı bir bağımlılığa sahiptir. Ayrıca (Kaynak Önizlemelerini beta özelliği olarak etkinleştirmek istiyorsanız) ve  ve  (enstrümantasyon için) için isteğe bağlı bağımlılıklar vardır.

Kurulum

 * Bağımlılıkları kurun.



Test dışı bir site için son LocalSettings yapılandırması örneği (normal viki)


Sayfa önizlemeleri API'si
Her proje farklıdır ve önizlemelerinizde görüntülenenler büyük ölçüde vikinizin içindeki içeriğe bağlıdır.

Popups uzantısı, Vikipedi benzeri içerikle (ör. vikimetin) çalışacak şekilde optimize edilmiştir.

Vikiniz farklı türde bir içerik işleyici kullanıyorsa (örneğin, için olduğu gibi) kendi API'sini sağlaması gerekir.

API herhangi bir dilde yazılabilir, ancak API'nin yanıtı burada tanımlanan spesifikasyonla eşleşmelidir:

Yeni API'ler tanımlamak, Popups uzantısının kapsamı dışındadır.

Tanımlandıktan sonra, yapılandırma seçeneğini kullanarak sayfa önizlemelerini API'nizi gösterecek şekilde yapılandırabilirsiniz.



Yapılandırma seçenekleri


Sayfa önizleme içeriği
Sayfa önizleme açılır pencereleri bir resim (varsa) ve küçük bir metin alıntısı gösterir.

Resim
Resim, bir maddeye ilişkili en uygun küçük resmi döndüren üzerinden gelir. Bakım şablonlarını, taslakları, işaret simgelerini vb. yok sayar.

Metin
Sayfa önizlemeleri, kullanılarak Sayfa içerik hizmeti özeti bitiş noktası ile uyumlu herhangi bir uyumlu API ile yapılandırılabilir. Üçüncü taraflar için, açılır pancereler yerel vikinizle kullanmanın keyfini çıkarmak için Sayfa İçerik Hizmeti'ni kullanmanızı öneririz.

uzantısını da kullanabilirsiniz. Bu uzantı çeşitli uyarılar içeriyor ve bu API'nin kullanımını aktif olarak desteklemiyoruz.



Kaynak önizleme içeriği


Kaynak önizleme açılır pencerelerindeki içerik doğrudan sayfanın kendisindeki referans bölümünden alınır. Burada herhangi bir harici hizmet yoktur. İçerik pop-up boyutunu aşarsa, her şeye bakılabilecek şekilde kaydırma çubukları gösterilir.



Kaynak türleri
Görüntülenen referans türleri, etiketindeki bir kaynağın içeriğini kapsüllemek için kullanılabilen belirli CSS sınıfları kullanılarak ayarlanır. . Şu anda aşağıdaki türler desteklenmektedir:,  ,  ,  ,. Bunun dışında ne cite etiketi bulunmuşsa ne de uygun bir sınıf kullanılmışsa, her zaman genel bir geri dönüş vardır. Lütfen CSS sınıflarını doğrudan vikimetinde kullanmanızın önerilmediğini, bunun yerine şablonlar oluşturarak tavsiye edildiğini unutmayın.

İşleyenler
Bu uzantıların şu anda yalnızca bir oluşturucusu var, yani normal sayfalar için.

Farklı türdeki sayfalar veya kaynakça gibi şeyler için yeni oluşturucular kolayca eklenebilir.

Aşağıdaki yöntemlerle yeni bir nesne oluşturulması gerekir:



Bu yöntemlerin ayrıntılarını ext.popups.renderer.article.js içinde veya bu kaynakça için bir oluşturucu ekleyen yamada görebilirsiniz.



Bilinen sorunlar

 * uzantısı kullanıcıları, Sayfa Önizlemeleri'nin sayfanın içerik dilinde önizleme istediğini belirtmelidir. Önizleme tam bir çevrilebilir blok içeriyorsa, çevrilecektir. Bununla birlikte, önizleme tamamlanmamış tercüme edilemeyen bir blok içeriyorsa, bir cümle kesildiğinden, diyelim ki, çevrilmez ve sayfanın içerik dilinde görüntülenir. Bu davranışı gözlemliyorsanız, müşteri adayı bölümünüzdeki tek tek cümleleri işaretlemeyi düşünmelisiniz. T167852 teknik bir kitle içindir, ancak altta yatan sorun hakkında daha fazla bilgiye sahiptir.
 * Önizlemede kesilen daha uzun matematik formülleri - uzun matematik veya kimyasal formüller (önizleme genişliğinden daha geniş formüller) önizlemelerde kesilmiş olarak görüntülenir. Formülün makalenin kendisinde devam ettiğini göstermek için bir gradyan ekleyemedik.
 * Small files may be in the "Рage information" (action=info), but not in the "Popups". Some requirements are set here - for a portrait image: exact (min) height 250 px & max width 203 px; for a landscape image: exact (min) width 320 px &  max height 200 px . To display, images must be able to become a thumbnail that is larger or equal to these "exact" sizes. (If you are cropping a large image to make a leading picture for an article, be sure that the picture you are creating is not smaller than the specified sizes.)

Extensibility
In MediaWiki 1.40, extensions and skins can extend the page previews functionality with their own custom preview types. It does this by registering a PluginModules attribute in its extension.json or skin.json file that points to a ResourceLoaderModule that can register a preview type. The plugin module should export information about when the preview should be displayed (via selector), and how the preview data should be retrieved (via gateway library). This feature is still in its infancy, has a few bugs (example) and feedback/bug reports via Phabricator are encouraged.

SSS


Neden bir önizlemeden metin kopyalayıp yapıştıramıyorum?
Yazma sırasında bunu yapmanın eksileri artılarını aşmaktadır. Esasen maddeyi tam olarak okumak için dokunma alanını azaltmaya kaynar. Sayfa Önizlemeleri İngilizce ve Almanca Vikipedi'ye dağıtıldıktan sonra, bu görevi yeniden açmaktan ve tartışmayı yeniden ele almaktan çekinmeyin, ancak şu anda planımız yok.



Önizlemede gördüğüm resmini nasıl değiştirebilirim?
Extension:PageImages#Resim seçimi sayfasına bakın.



Bir sayfa önizlemesinden içeriği nasıl kaldırabilirim?
sınıfıyla işaretlenmiş tüm öğeler özetten çıkarılır.



Özetler nereden geliyor?
Bunlar, vikinizin varsayılan  ağ geçidini kullanması durumunda özet REST API veya  API tarafından sağlanır.



Parantez neden soyulur?
T91344 Phabricator'da iyi bir tartışma var. Bununla ilgili herhangi bir görüşünüz varsa veya bununla ilgili herhangi bir sorun görürseniz, lütfen bize bildirin.



Neden içerik ad alanlarının dışında açılır pencereler görmüyorum?
Açılır pencereler yalnızca içerik ad alanlarındaki sayfaların bağlantılarında görünür. Bu açılır pencerelerin bir sınırlamasıdır; TextExtracts diğer ad alanlarından edinilebilir. daha fazla ad alanı ekleyerek bu sorunu çözebilirsiniz.

Bağlantılar

 * MediaWiki.org'da Sayfa Önizlemeleri yardım sayfası ve merkezi geri bildirim sayfası
 * MediaWiki.org'daki Kaynak Önizlemeleri yardım sayfası ve merkezi geri bildirim sayfası
 * Meta'da Kaynak Önizlemeleri ana proje sayfası
 * İlgili araştırma: Wikimedia Performans Ekibi/Yazma Açılır Pencereleri: En İyi Uygulamalar