एक्सटेंशन:Popups

the feature that is powered by this extension के लिए Page Previews देखें।

मीडियाविकि एक्सटेंशन मैन्युअल

Popups प्रकाशन की स्थिति: स्थिर
कार्यान्वयन	स्किन
विवरण	लेखों की कड़ियों और फ़ुटनोट मार्कर्स पर होवर करने पर सदस्य को पॉपअप्स दिखाता है
लेखक	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.37+
PHP	5.6+
लाइसेंस	GNU साधारण सार्वजनिक लाइसेंस 2.0 या अधिक
डाउनलोड करें	एक्सटेंशन डाउनलोड करें गिट [?]: गिट master डाउनलोड करें रिपॉज़िटरी देखें (Phabricator · GitHub) कमिट्स का इतिहास रिपॉज़िटरी पर योगदानकर्ताएँ (GitHub) कोड निरीक्षण
उदाहरण	English Wikipedia
पैरामीटर $wgPopupsVirtualPageViews $wgPopupsTextExtractsIntroOnly $wgPopupsStatsvSamplingRate $wgPopupsRestGatewayEndpoint $wgPopupsHideOptInOnPreferencesPage $wgPopupsPageDisabled $wgPopupsGateway $wgPopupsConflictingNavPopupsGadgetName
उपयोग किए गए हुक BeforePageDisplay GetPreferences MakeGlobalVariablesScript ResourceLoaderGetConfigVars
Quarterly downloads	297 (Ranked 14th)
Public wikis using	947 (Ranked 282nd)
Popups एक्सटेंशन को अनुवादित करें अगर यह translatewiki.net पर उपलब्ध है
मुद्दे	अधूरे कार्य · बग की रिपोर्ट करें

Popups एक्सटेंशन (जिसे Special:Version में Previews कहा जाता है) एक्सटेंशन किसी पृष्ठ या फिर सन्दर्भ की कड़ी पर होवर करने पर क्रमशः पृष्ठ या सन्दर्भ का पूर्वावलोकन दिखाता है। लेख की कड़ी में लेख की सामग्री का एक सारांश होता है, और सन्दर्भ की कड़ी में सन्दर्भ की पूरी सामग्री होती है।

यह एक्सटेंशन डिज़ाइन दल की एक परियोजना है, जो प्रसिद्ध नेविगेशन पॉपअप्स गैजेट से प्रेरित है। वर्तमान में यह सुविधा सभी विकिपीडियाओं पर लॉग-आउट किए हुए सदस्यों के लिए डिफ़ॉल्ट से सक्षम होता है। इस एक्सटेंशन के कार्य, और विकिमीडिया परियोजनाओं पर इसके उपयोग के बारे में अधिक जानकारी Page Previews पृष्ठ पर उपलब्ध है।

सन्दर्भ पूर्वावलोकन सुविधा जर्मन समुदाय की तकनीकी इच्छासूची में से एक इच्छा को पूरा करने के लिए जोड़ा गया था। इसके बारे में अधिक विस्तार और इसके उपयोग के बारे में अधिक जानकारी, Reference Previews पर उपलब्ध है।

निर्भरताएँ

यह एक्सटेंशन Extension:TextExtracts पर निर्भर है, और डिफ़ॉल्ट mwApiPlain गेटवे के साथ इसका इस्तेमाल किए जाने पर Extension:PageImages पर। बीटा सुविधाएँ (अगर आप सन्दर्भ पूर्वावलोकन को एक बीटा सुविधा के रूप में उपलब्ध कराना चाहते हैं), Extension:EventLogging और Extension:WikimediaEvents (उपकरणों के लिए) पर वैकल्पिक निर्भरताएँ भी हैं।

स्थापना

• निर्भरताएँ स्थापित करें।

• फ़ाइलों को डाउनलोड करें और अपने extensions/ फ़ोल्डर के Popups नामक डिरेक्ट्री में डालें।
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Popups
• अपने LocalSettings.php फ़ाइल के अंत में निम्न कोड जोड़ें:

  wfLoadExtension( 'Popups' );
  

•  पूर्ण – अपने विकि पर Special:Version पर जाकर देखें कि एक्सटेंशन को सफलतापूर्वक स्थापित किया गया है कि नहीं।

=== एक गैर-परीक्षण साइट (साधारण विकि) के लिए अंतिम LocalSettings कॉन्फ़िगरेशन का उदाहरण ===

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

कॉन्फ़िगरेशन के विकल्प

विकल्प:	डिफ़ॉल्ट वैल्यू	प्रलेख
$wgPopupsVirtualPageViews	false	एक्सटेंशन को वर्चुअल पृष्ठ-दृश्यों को लॉग करना है या नहीं।
$wgPopupsHideOptInOnPreferencesPage	false	पृष्ठ पूर्वावलोकन को सक्षम/अक्षम करने के विकल्प को वरीयताओं के पृष्ठ से छिपाना है या नहीं।
$wgPopupsOptInDefaultState	1	पुराने खातों के लिए पृष्ठ पूर्वावलोकन की डिफ़ॉल्ट दृश्यता। इसे बीटा सुविधा सेटिंग्स के साथ अनुकूलता के रूप में एक स्ट्रिंग होना होगा। अधिक जानकारी के लिए टास्क T191888 देखें। वैल्यू को आंतरिक रूप से Bool रूप में बदल दिया जाता है। इसलिए 2 के समान या इससे बड़े किसी वैल्यू का अर्थ 1 जितना ही है।
$wgPopupsOptInStateForNewAccounts	1	नए खातों (2018 के Q2 से) के लिए पृष्ठ पूर्वावलोकन की डिफ़ॉल्ट दृश्यता। अधिक जानकारी के लिए टास्क T191888 देखें।
$wgPopupsConflictingNavPopupsGadgetName	'Navigation_popups'	लोकल नेविगेशन पॉपअप्स नाम जिसका इस्तेमाल MediaWiki:Gadgets-definition में इसके पहचानकर्ता के रूप में किया जाता है। यह गैजेट पृष्ठ पूर्वावलोकन से अनुकूल नहीं है। गैजेट को सक्षम रखने वाले सदस्यों के लिए एक्सटेंशन अपने आप को अक्षम कर देगा।
$wgPopupsConflictingRefTooltipsGadgetName	ReferenceTooltips	लोकल Reference Tooltips गैजेट का नाम जिसका इस्तेमाल MediaWiki:Gadgets-definition में इसके पहचानकर्ता के रूप में किया जाता है। यह गैजेट सन्दर्भ पूर्वावलोकन से अनुकूल नहीं है। गैजेट को सक्षम रखने वाले सदस्यों के लिए सन्दर्भ पूर्वावलोकन अपने आप को अक्षम कर देगा।
$wgPopupsGateway	'mwApiPlain'	Popups डेटा प्राप्त करने के लिए किस गेटवे का इस्तेमाल करना है। उपलब्ध विकल्प: mwApiPlain, restbasePlain, restbaseHTML। src/gateway/page.js पर हमेशा अद्यत और पूरी एक सूची पाई जा सकती है।
$wgPopupsRestGatewayEndpoint	'/api/rest_v1/page/summary/'	एक REST एंडपॉइंट निर्दिष्ट करें जहाँ पर से सारांश प्राप्त किए जाएँगे। एंडपॉइंट को Specs/Summary/1.2.0 पर मानदंडों से मेल खाना होगा।
$wgPopupsReferencePreviews	true	अस्थायी सुविधा चिप्पी जिससे विकास के दौरान सन्दर्भ पूर्वावलोकन को अक्षम किया जा सकता है।
$wgPopupsReferencePreviewsBetaFeature	true	सन्दर्भ पूर्वावलोकन बीटा सुविधा के रूप में उपलब्ध होना चाहिए या नहीं। अगर false होता है, सन्दर्भ पूर्वावलोकन को सभी सदस्यों के लिए डिफ़ॉल्ट से सक्षम कर दिया जाता है।
$wgPopupsStatsvSamplingRate	0	statsv पर प्रदर्शन की डेटा को लॉग करने के लिए सैम्पलिंग की मात्रा।
$wgPopupsPageDisabled	Several special pages. See extension.json for the full list.	पृष्ठ जिनके लिए पॉपअप्स नहीं दिखाए जाएँगे। उपपृष्ठ शामिल होते हैं। इन पृष्ठों पर विकि के HTMl कैश नीति को लागू किया जाता है। इस कॉन्फ़िगरेशन वेरिएबल का प्रभाव देखने के लिए आपको इन पृष्ठों को एक बार पर्ज करना पड़ सकता है। छोड़े गए हर पृष्ठ को आधिकारिक नामस्थान से परिभाषित करें, जैसे Special:Userlogin।

पृष्ठ पूर्वावलोकन की सामग्री

पृष्ठ पूर्वावलोकन पॉपअप्स एक चित्र (अगर उपलब्ध हो), और टेक्स्ट का एक छोटा हिस्सा दिखाते हैं।

चित्र

चित्र Extension:PageImages से आता है जो लेख के साथ सबसे अच्छा जँचने वाला अंगूठाकार लौटाता है। यह अनुरक्षण साँचें, आधार, झंडों के आईकॉन्स, आदि को अनदेखा करता है।

टेक्स्ट

पृष्ठ पूर्वावलोकन को $wgPopupsRestGatewayEndpoint की मदद से किसी भी API से कॉन्फ़िगर किया जा सकता है जो पृष्ठ सामग्री सेवा के सारांश एंडपॉइंट से अनुकूल हो। तृतीय-पक्षों के लिए हम अपने लोकल विकि पर पॉपअप्स पाने के लिए पृष्ठ सामग्री सेवा का इस्तेमाल करने की सलाह देते हैं।

आप Extension:TextExtracts एक्सटेंशन का भी इस्तेमाल कर सकते हैं। इस एक्सटेंशन में कई खामियाँ हैं और हम इस API के उपयोग को बढ़ावा नहीं देते हैं।

रेंडरर्स

इस एक्सटेंशन का इस समय एक ही रेंडरर है, जो साधारण पृष्ठों के लिए है।

अलग प्रकार के पृष्ठों, या सन्दर्भ जैसी चीज़ों के लिए नए रेंडरर्स आसानी से जोड़े जा सकते हैं।

आपको इन साधनों की मदद से एक नया वस्तु बनाना होगा:

• init
• createPopup
• getOffset
• getClasses
• processPopup

आप gerrit:139827 या फिर इस पैच में इन साधनों का विस्तार देख सकते हैं जो सन्दर्भों के लिए एक रेंडरर जोड़ता है।

पृष्ठ पूर्वावलोकन API

हर परियोजना अलग है, और आपके पूर्वावलोकनों में क्या दिखाया जाता है, यह आपके विकि की सामग्री पर काफ़ी हद तक निर्भर है।

Popups एक्सटेंशन को विकिपीडिया जैसी सामग्री (जैसे कि विकिटेक्स्ट) के साथ काम करने के लिए ऑप्टिमाइज़ किया गया है।

अगर आपका विकि किसी दूसरे प्रकार के सामग्री हैंडलर का इस्तेमाल करता है (जैसे Wikibase के मामले में), उस हैंडलर को अपना खुद का API प्रदान करना होगा।

API किसी भी भाषा में लिखी जा सकती है, मगर API का जवाब इन मानदंडों से मेल खाना चाहिए:

Popups एक्सटेंशन के अनुरक्षकों द्वारा नए API परिभाषित नहीं किए जाएँगे।

जब आप इसे परिभाषित कर लेते हैं, आप $wgPopupsRestGatewayEndpoint कॉन्फ़िगरेशन विकल्प की मदद से पृष्ठ पूर्वावलोकन को आपके API की तरफ इशारा कर सकते हैं।

ज्ञात समस्याएँ

• Translate एक्सटेंशन के उपयोगकर्ताओं को यह ध्यान में रखना चाहिए कि पृष्ठ पूर्वावलोकन पृष्ठ के सामग्री की भाषा में पृष्ठ पूर्वावलोकनों का अनुरोध करता है। अगर पूर्वावलोकन में एक पूरा अनुवाद-योग्य ब्लॉक होता है, उसे अनुवादित कर दिया जाएगा। लेकिन अगर पूर्वावलोकन में एक अधूरा अनुवाद-योग्य ब्लॉक होता है - क्योंकि शायद किसी वाक्य का आधा हिस्सा आता हो - तब उसे अनुवादित नहीं किया जाएगा और उसे पृष्ठ के सामग्री की भाषा में दिखाया जाएगा। अगर आपको यह स्वभाव दिख रहा है, आपको अपने शुरुआती अनुभाग में हर वाक्य को अपना मार्कअप टैग देना होगा। तकनीकी रूचि वाले सदस्यों के लिए T167852 है, मगर इसमें जड़ समस्या के बारे में अधिक जानकारी है।
• पूर्वावलोकन में लंबे गणित सूत्रों का कट जाना - लंबे गणित या रासायनिक सूत्र (जो पूर्वावलोकन की चौड़ाई से ज़्यादा चौड़े होते हैं), पूर्वावलोकन में अधूरे नज़र आते हैं। हम ऐसा कोई ग्रैडिएंट नहीं जोड़ पाए जो बताता हो कि सूत्र लेख पर इससे ज़्यादा बड़ा है।
• 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.

{
    "attributes": {
        "Popups": {
            "PluginModules": [
              "skins.skinjson.popup"
            ]
        }
    }
}

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).

module.exports = {
        // a unique ID representing your preview type.
        type,
        // CSS selector that matches your custom preview type
        selector: '.mycustomselector',
        // Gateway
        gateway: {
                fetchPreviewForTitle:  ( title, el ) => {
                	const deferred = $.Deferred();
                	deferred.resolve( {
                		title: 'Hello world',
                		extract: [
                			`Hi`
                		],
                		url: 'https://www.mediawiki.org/wiki/Extension:Popups',
                		type,
                		languageCode: 'en',
                		languageDirection: 'ltr',
                		thumbnail: undefined,
                		pageId: -1
                	} );
                	return deferred;
                }
        }
};

For real world examples, Extension:Math provide smath tooltips and Extension:Cite provides reference previews.

सामान्य प्रश्न

मैं किसी पूर्वावलोकन से प्रतिलिपि बनाकर चिपका क्यों नहीं पाता/पाती?

जब यह लिखा जा रहा है, ऐसा करने के अलाभ, लाभ से ज़्यादा हैं। बात इतनी है कि लेख को पूरा पढ़वाने के लिए छूने-योग्य जगह को घटाना होता है। जब पृष्ठ पूर्वावलोकन को पूरी तरह से अंग्रेज़ी और जर्मन विकिपीडिया पर तैनात कर दिया गया हो, इस टास्क को खोलकर चर्चा को दोबारा शुरू ज़रूर करें, लेकिन इस समय हमारे पास ऐसी कोई योजना नहीं।

पूर्वावलोकन पर मुझे दिखने वाला चित्र मैं कैसे बदलूँ?

Extension:PageImages#Image choice देखें।

मैं पृष्ठ पूर्वावलोकन से सामग्री कैसे हटाऊँ?

noexcerpt क्लास में चिह्नित किसी भी तत्व को सारांश से अलग रखा जाएगा।

Why is content removed from the summary?

Any HTML element marked with the class noexcerpt, mw-ref, reference, noprint, nomobile or sortkey will be removed from the summary. If the text should be displayed in the summary, you should under no circumstances use these classes in any templates that are used within the beginning section of an article.

सारांश कहाँ से आते हैं?

ये summary REST API द्वारा, या फिर अगर आपका विकि डिफ़ॉल्ट mwApiPlain गेटवे का इस्तेमाल कर रहा हो तो TextExtracts API द्वारा प्रदान किए जाते हैं।

पैरेंथेटिकल्स को क्यों हटा दिया जाता है?

Phabricator पर T91344 में एक अच्छी चर्चा चल रही है। अगर इस बारे में आपकी कोई विचार है या फिर आपको कोई समस्या नज़र आती है, कृपया हमें वहाँ सूचित करें।

मुझे सामग्री नामस्थान के बाहर कोई पॉपअप नज़र क्यों नहीं आ रही?

पॉपअप्स सिर्फ सामग्री नामस्थान में मौजूद पृष्ठों के लिए ही नज़र आते हैं। पॉपअप्स की यह एक सीमा है; दूसरे नामस्थानों से TextExtracts उपलब्ध हैं। आप $wgContentNamespaces पर अधिक नामस्थान जोड़कर इस समस्या के आर-पार जा सकते हैं।

कड़ियाँ

• MediaWiki.org पर पृष्ठ पूर्वावलोकन का सहायता पृष्ठ और केंद्रीय प्रतिक्रिया पृष्ठ
• MediaWiki.org पर सन्दर्भ पूर्वावलोकन का सहायता पृष्ठ और केंद्रीय प्रतिक्रिया पृष्ठ
• मेटा पर सन्दर्भ पूर्वावलोकन का मुखपृष्ठ
• संबंधित खोज: Wikimedia Performance Team/Authoring Popups: Best Practices

Notes