एक्सटेंशन:Popups

**मीडियाविकि एक्सटेंशन मैन्युअल**
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; $wgPopupsOptInDefaultState; $wgPopupsRestGatewayEndpoint; $wgPopupsHideOptInOnPreferencesPage; $wgPopupsConflictingRefTooltipsGadgetName; $wgPopupsStatsvSamplingRate; $wgPopupsConflictingNavPopupsGadgetName; $wgPopupsTextExtractsIntroOnly; $wgPopupsPageDisabled; $wgPopupsGateway;
	उपयोग किए गए हुक BeforePageDisplay; GetPreferences; MakeGlobalVariablesScript; ResourceLoaderGetConfigVars; UserGetDefaultOptions;
Quarterly downloads	302 (Ranked 12th)
Public wikis using	947 (Ranked 282nd)
	Popups एक्सटेंशन को अनुवादित करें अगर यह translatewiki.net पर उपलब्ध है
मुद्दे	अधूरे कार्य · बग की रिपोर्ट करें

This page is a translated version of the page Extension:Popups and the translation is 77% complete.

Outdated translations are marked like this.

This extension is maintained by the Web team.

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^[1]. 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

↑ https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/extensions/Popups/+/refs/heads/master/src/ui/thumbnail.js

इस एक्सटेंशन का इस्तेमाल एक या अधिक विकिमीडिया परियोजनाओं पर किया जा रहा है। इसका शायद मतलब है कि एक्सटेंशन स्थिर है और इस तरह के अधिक दर्शकों वाले वेबसाइटों द्वारा उपयोग किए जाने के लिए पर्याप्त रूप से काम करता है। विकिमीडिया की CommonSettings.php और InitialiseSettings.php कॉन्फ़िगरेशन फ़ाइलों में इस एक्सटेंशन का नाम खोजें, और यह वहीं स्थापित होगा। किसी विशिष्ट विकि पर स्थापित एक्सटेंशन्स की पूरी सूची को विकि के Special:Version पृष्ठ पर देखा जा सकता है।

इस एक्सटेंशन को निम्न विकि फ़ार्म्स/होस्ट्स और/या पैकेजिस में शामिल किया गया है:

यह कोई आधिकारिक सूची नहीं है। कुछ विकि फ़ॉर्म्स/होस्ट्स और/या पैकेजिस में यह एक्सटेंशन शामिल हो सकता है हालाँकि वो शायद यहाँ सूचीबद्ध न हों। सुनिश्चित करने के लिए हमेशा अपने विकि फ़ार्म/होस्ट से संपर्क करें या बंडल जाँचें।

[1] ttps://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/extensions/Popups/+/refs/heads/master/src/ui/thumbnail.js

[1]

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 $wgPopupsOptInDefaultState $wgPopupsRestGatewayEndpoint $wgPopupsHideOptInOnPreferencesPage $wgPopupsConflictingRefTooltipsGadgetName $wgPopupsStatsvSamplingRate $wgPopupsConflictingNavPopupsGadgetName $wgPopupsTextExtractsIntroOnly $wgPopupsPageDisabled $wgPopupsGateway
उपयोग किए गए हुक BeforePageDisplay GetPreferences MakeGlobalVariablesScript ResourceLoaderGetConfigVars UserGetDefaultOptions
Quarterly downloads	302 (Ranked 12^th)
Public wikis using	947 (Ranked 282^nd)
Popups एक्सटेंशन को अनुवादित करें अगर यह translatewiki.net पर उपलब्ध है
मुद्दे	अधूरे कार्य · बग की रिपोर्ट करें