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ı, ve  çok bağımlı. (Kaynak Önizlemelerini beta özelliği olarak etkinleştirmek istiyorsanız) ve ve  (araç için) için isteğe bağlı bağımlılıklar da vardır.

Kurulum

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

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:

https://www.mediawiki.org/wiki/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.

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,  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
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 desteklenen dört farklı tür vardır:,  ,  ,. 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.

Renderers
This extensions currently has only one renderer, that is for ordinary pages.

New renderers for different kind of pages, or things like references can be easily added.

One needs to create a new object with the following methods:


 * init
 * createPopup
 * getOffset
 * getClasses
 * processPopup

You can see details of these methods in ext.popups.renderer.article.js or this patch that adds a renderer for references.

Known problems

 * Users of the Translate extension should note that Page Previews requests previews in the content language of the page. If the preview contains a complete translatable block, then it will be translated. If, however, the preview contains an incomplete translateable block – because a sentence is cut off, say – then it isn't translated and will be displayed in the content language of the page. If you are observing this behavior, then you should consider marking up individual sentences in your lead section.


 * T167852 is for a technical audience but has more information on the underlying problem.


 * Longer math formulas cutting off in preview - long math or chemical formulas (formulas wider than the preview width) display as truncated in previews. We were not able to add a gradient in order to indicate that the formula is continued on the article itself.

Why can't I copy and paste text from a preview?
At time of writing, the cons of doing so outweigh the pros. Essentially it boils down to decreasing the touch area to read the article in full. Once Page Previews is deployed on English and German Wikipedia, feel free to reopen this task and reignite the discussion, but right now we have no plans.

How can I change the image that I see on preview?
See Extension:PageImages#Image choice.

How can I remove content from a page preview?
Any element marked with the  class will be stripped from the summary.

Where do summaries come from?
These are provided by the Summary REST API.

Why are parenthetical stripped?
There's a good discussion going on in T91344 in Phabricator. If you have any views on this or see any problems relating to this, please let us know there.

Why don't I see Popups outside of content namespaces?
Popups appear on links to pages in content namespaces only. This is a limitation of Popups; TextExtracts are available from other namespaces. You may work around this by appending more namespaces into.

Links

 * Page Previews help page and central feedback page on MediaWiki.org
 * Reference Previews help page and central feedback page on MediaWiki.org
 * Reference Previews main project page on Meta