Extension:Popups

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Popups and the translation is 83% complete.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎dansk • ‎español • ‎polski • ‎português do Brasil • ‎svenska • ‎русский • ‎हिन्दी • ‎中文 • ‎日本語 • ‎한국어
MediaWiki manüel uzantıları
OOjs UI icon advanced.svg
Popups
Sürüm durumu: kararlı
Hovercard english.png
Uygulama Görünüm
Açıklama Kullanıcılar madde bağlantılarının ve dipnot işaretlerinin üzerine geldiğinde açılır pencerelere görüntüler
Yazar(lar)
  • Prateek Saxena (user:Prtksxna),
  • Yair Rand,
  • Sam Smith,
  • Joaquín Oltra Hernández,
  • Bahodir Mansurov,
  • Jon Robson,
  • Piotr Miazga,
  • Jeff Hobson
  • WMDE Engineering
MediaWiki 1.30+
PHP 5.6+
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
  • $wgPopupsVirtualPageViews
  • $wgPopupsOptInDefaultState
  • $wgPopupsRestGatewayEndpoint
  • $wgPopupsHideOptInOnPreferencesPage
  • $wgPopupsTextExtractsIntroOnly
  • $wgPopupsConflictingRefTooltipsGadgetName
  • $wgPopupsPageDisabled
  • $wgPopupsEventLogging
  • $wgPopupsStatsvSamplingRate
  • $wgPopupsReferencePreviewsBetaFeature
  • $wgPopupsConflictingNavPopupsGadgetName
  • $wgPopupsOptInStateForNewAccounts
  • $wgPopupsGateway
  • $wgPopupsReferencePreviews
Translatewiki.net adresinde mevcutsa, Popups uzantısını çevirin

Kullanım ve sürüm matrisini kontrol edin.

Sorunlar Açık görevler · Hata bildir

'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 Yardım:Referans Önizlemeleri altında edinilebilir.

Bağımlılıklar

Bu uzantının Extension:TextExtracts ve Extension:PageImages sıkı bir bağımlılığı var. Ayrıca Beta Özellikleri (Kaynak Önizlemelerini beta özelliği olarak etkinleştirmek istiyorsanız) ve Extension:EventLogging ve Extension:WikimediaEvents (enstrümantasyon için) için isteğe bağlı bağımlılıklar vardır.

Kurulum

  • Dosyaları indirin ve extensions/ klasörünüzdeki Popups adlı dizine yerleştirin.
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'Popups' );
    
  • 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.25 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.25 ve önceki sürümler) yüklemeniz gerekirse, wfLoadExtension( 'Popups' ); yerine kullanmanız gerekir:

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

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

wfLoadExtensions( [
    'TextExtracts',
    'PageImages',
    'Popups'
] );
$wgPopupsHideOptInOnPreferencesPage = true;
$wgPopupsReferencePreviewsBetaFeature = false;

Page previews API

Every project is different, and what displays in your previews is highly dependent on the content inside your wiki.

Extension:Popups has been optimised to work with Wikipedia-like content (e.g. wikitext). If your wiki is using a different kind of content handler (for example as is the case for Wikibase ) it will need to provide its own API.

The API can be written in any language, but the response of the API must match the spec defined here:

Specs/Summary/1.2.0

Defining new APIs is out of scope for the Popups extension.

Once defined, you can configure page previews to point to your API using $wgPopupsRestGatewayEndpoint configuration option.

Yapılandırma seçenekleri

Seçenek Varsayılan değer Belgeleme
$wgPopupsVirtualPageViews false Whether the extension should log virtual pageviews.
$wgPopupsHideOptInOnPreferencesPage false Sayfa Önizlemelerini etkinleştirme/devre dışı bırakma seçeneğinin Tercihler sayfasında gizlenip gizlenmeyeceği. Varsayılan olarak false.
$wgPopupsOptInDefaultState 1 Eski hesaplar için varsayılan Sayfa Önizlemeleri görünürlüğü. Beta özellik ayarlarıyla uyumluluk olarak bir dize olmalıdır. For more information see T191888
$wgPopupsOptInStateForNewAccounts 1 Default Page Previews visibility for newly created accounts (from Q2 2018). For more information see T191888
$wgPopupsConflictingNavPopupsGadgetName Navigation_popups The local Navigation popups gadget name used as its identifier in MediaWiki:Gadgets-definition . This gadget is incompatible with page previews. The extension will disable itself for users with the gadget enabled.
$wgPopupsConflictingRefTooltipsGadgetName ReferenceTooltips The local Reference Tooltips gadget name used as its identifier in MediaWiki:Gadgets-definition . This gadget is incompatible with reference previews. Reference previews will disable itself for users with the gadget enabled.
$wgPopupsGateway mwApiPlain Popups verilerini almak için hangi ağ geçidinin kullanılacağı. Kullanılabilir seçenekler: [mwApiPlain|restbasePlain|restbaseHTML]. src/gateway/page.js içinde tam ve her zaman güncel liste mevcuttur
$wgPopupsRestGatewayEndpoint /api/rest_v1/page/summary/ Özetlerin kaynaklanması gereken bir REST bitiş noktası belirtin. Bitiş noktası Specs/Summary/1.2.0 altındaki spesifikasyonu karşılamalıdır
$wgPopupsReferencePreviews true Temporary feature flag to disable reference previews during developement.
$wgPopupsReferencePreviewsBetaFeature true Kaynak Önizlemelerin bir Beta özelliği olarak mevcut olup olmayacağı. false ise, Kaynak Önizlemeleri varsayılan olarak tüm kullanıcılar için etkinleştirilir.
$wgPopupsEventLogging false Etkinlikler günlüğe kaydetmemiz gerekip gerekmediği. Note if this is enabled without using that variable events will be logged for all users without any sampling! Be careful!
$wgPopupsStatsvSamplingRate 0 Performans verilerinin istatistiklere kaydedilmesi için örnekleme oranı
$wgPopupsPageDisabled [ "Special:CreateAccount", "Special:GlobalRenameRequest", "Special:Userlogin", "Special:MergeAccount", "Special:ChangeCredentials", "Special:OAuthListConsumers", "Special:GlobalUserRights", "Special:Notifications", "Special:UserRights", "Special:Upload", "Special:VipsTest", "Special:ApiFeatureUsage", "Special:ExpandTemplates", "Special:GadgetUsage", "Special:GraphSandbox", "Special:TemplateSandbox", "Special:MostLinkedFiles", "Special:Book" ] List of pages that should not show Popups. Includes subpages. Bu sayfalar, vikinin HTML önbellek politikasına tabidir. Bu yapılandırma değişkeninin etkisini görmek için bu sayfalarda bir temizlik gerekebilir. Dışarıda bırakılan her sayfa bir kurallı adla tanımlanmalıdır, örneğin: Special:Userlogin.

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 Extension:PageImages üzerinden gelir. Bakım şablonlarını, taslakları, işaret simgelerini vb. yok sayar.

Metin

Sayfa önizlemeleri, $wgPopupsRestGatewayEndpoint 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.

Extension:TextExtracts 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

A news source shown in the Reference Previews feature.png

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, <cite> etiketindeki bir kaynağın içeriğini kapsüllemek için kullanılabilen belirli CSS sınıfları kullanılarak ayarlanır. <cite class="journal">. Şu anda aşağıdaki türler desteklenmektedir: web, journal, book, news, note. 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. Please note, that it's not recommended to use the CSS-classes directly in wikitext, but rather by creating templates.

İş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:

  • init
  • createPopup
  • getOffset
  • getClasses
  • processPopup

Bu yöntemlerin ayrıntılarını ext.popups.renderer.article.js veya bu yamasını referanslar için oluşturucu ekleyen olarak görebilirsiniz.

Bilinen sorunlar

  • Translate 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.

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?

noexcerpt sınıfıyla işaretlenmiş tüm öğeler özetten çıkarılır.

Özetler nereden geliyor?

Bunlar Özet REST 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. $wgContentNamespaces daha fazla ad alanı ekleyerek bu sorunu çözebilirsiniz.

Bağlantılar