Extension:Popups/hi

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

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

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

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

स्थापना

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



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


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

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

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

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

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

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



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


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

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

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

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



सन्दर्भ पूर्वावलोकन की सामग्री


सन्दर्भ पॉपअप्स की जानकारी सीधे पृष्ठ के सन्दर्भ अनुभाग से ली जाती है। इसमें किसी भी बाहरी सेवा का काम नहीं। अगर सामग्री पॉपअप के आकार से ज़्यादा बड़ी होती है, सब कुछ देखने के लिए स्क्रोलबार्स दिखाए जाते हैं।



सन्दर्भ के प्रकार
सन्दर्भ के दिखाए जाने वाले प्रकार टैग पर विशिष्ट CSS क्लासों की मदद से सेट किए जाते हैं ताकि सन्दर्भ की सामग्री को चिह्नित किया जा सकता है, जैसे  । वर्तमान में ये प्रकार समर्थित हैं:,  ,  ,  ,  । इसके अलावा अगर cite टैग नहीं मिलती है और उचित क्लास का इस्तेमाल नहीं किया जाता है, एक साधारण फ़ॉलबैक मौजूद होता है। कृपया ध्यान रखें कि CSS क्लासों का इस्तेमाल सीधे विकिटेक्स्ट के ज़रिए नहीं किया जाना चाहिए, बल्कि इन्हें साँचों की मदद से जोड़ा जाना चाहिए।

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

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

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



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



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

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

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


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



पूर्वावलोकन पर मुझे दिखने वाला चित्र मैं कैसे बदलूँ?
Extension:PageImages#Image choice देखें।



मैं पृष्ठ पूर्वावलोकन से सामग्री कैसे हटाऊँ?
क्लास में चिह्नित किसी भी तत्व को सारांश से अलग रखा जाएगा।



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



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



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

कड़ियाँ

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