Fandom Developers Wiki
Register
Advertisement

रेफरेंसपॉप्स विकिपीडिया के रिफरेन्स पॉपअप गैजेट का एक री-इम्प्लीमेंटेशन है, एक ऐसा फीचर जो आपको एक साइटेशन के ऊपर कर्सर मंडराकर उस रिफरेन्स की कंटेंट्स को एक मंडराती बॉक्स में दिखता है। इसका लाभ यह है की यह आपको रेफरेन्सेस उसी जगह पे दिखा देता है नाकि आपको एकदम नीचे जाके नोट को देखना होगा या साइटेशन पर क्लिक करने के बाद आप ढूंढ न पाओ आप कहाँ पढ़ रहे थे।

इस गैजेट में एक समझदार रंग-स्कीम है जो अपने आप आपके विकी के थीम से एडजस्ट हो जाता है, यानि आपको इसे CSS से बदलने की भी ज़रुरत नहीं। यह इस कार्य के लिए आपके विकी के यह इस कार्य के लिए आपके विकी के Special:ThemeDesigner से सहायता लेती है; यदि आपने ThemeDesigner के बजाय CSS का इस्तेमाल करके विकी के रंग बदल दिए हैं तो यह ठीक से काम नहीं कर सकता है।

स्थापना

बहुत सारे स्क्रिप्ट्स आयात कर रहे हैं? यह त्वरित गाइड दिखाता है आयातों को एक साथ कैसे जोड़ें।
  • पूरे साइट के इस्तेमाल के लिए एक प्रबंधक इसे MediaWiki:ImportJS पर जोड़ सकते हैं।
dev:ReferencePopups/code.js
  • व्यकितगत इस्तेमाल के लिए नीचे दिए गए स्निपेट को अपने global.js में (सारे विकियों में इस्तेमाल के लिए) या अपने common.js में (किसी एक विकी में इस्तेमाल के लिए) जोड़ें। ध्यान रखें कि आपके अकाउंट के लिए व्यक्तिगत JS सक्षम होना चाहिए।
importArticles({
    type: 'script',
    articles: [
        'u:dev:MediaWiki:ReferencePopups/code.js',
    ]
});

काम के नोट्स

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

जब पॉपअप डिसएबल हो जाते हैं, तो पृष्ठ के अंत में एक लिंक होता है, श्रेणियों के ठीक नीचे, जिसे बाद में चालू करने के लिए कॉन्फ़िगरेशन UI को फिर से खोलने के लिए क्लिक किया जा सकता है।

स्थापना के लिए सहायता

पॉपअप कॉन्फ़िगरेशन के विकल्प हैं:

  • रिफरेन्स पॉपअप बंद करना — यह पॉपअप को बंद कर देता है जिससे स्क्रीन पर ऐसे पॉपुपस नहीं आते, कस्टम पॉपअप को छोड़कर। इन्हे पृष्ठ के नीचे पाए जाने वाले "Configure Reference Popups" बटन से वापस चालु किया जा सकता है।
    • कुछ विकी इस ऑप्शन को लॉक करके रखते है, जिससे कि आप पॉपअप को बंद नहीं भी कर सकते। ऐसे हालात में आप उस विकी के किसी एडमिनिस्ट्रेटर से बात कर सकते हैं।
  • होवर डीले — वह समय (मिलीसेकंड में) जितना आपको उस साइटेशन पर कर्सर को मंडराना होगा ताकि पॉपअप आए। इसका डिफ़ॉल्ट 200ms होता है पर आप इसे एडजस्ट कर सकते हैं अगर यह आपके इच्छानुसार ज़्यादा लंबा या ज़्यादा छोटा है। ध्यान रखे की छोटे डिले स्क्रॉल करते समय आपको परेशां भी कर सकते हैं, जब वह कर्सर के नीचे आते ही आ जाते हैं।
  • पॉपअप को खुला रखना जब तक कर्सर से न छुआ जाए — पॉपअप सामने आने के बाद खुले ही रहेंगे, जब तक आप पॉपअप के ऊपर फिर से कर्सर मंडराकर उसे न हटाए।
  • एक्टिवेशन के तरीके — डिफ़ॉल्ट से, पॉपअप कर्सर मंडराने पर खुलते हैं; लेकिन, आप क्लिक और मंडराने के बीच चुन सकते हैं। क्लिक मोड में आपको पॉपअप को खोलने के लिए साइटेशन पर क्लिक करना होगा।
    • क्लिक मोड में रिफरेन्स को दो बार क्लिक करने से यह पॉपअप को बाईपास कर देता है (बंद कर देता है) और आपको पृष्ठ के नीचे के रिफरेन्स शाखा में ले जाता है, सामान्य तरीके से।
  • खोलने/बंद होने के एनिमेशन्स बदले — डिफ़ॉल्ट में, खोलने और बंद होने के लिए एक स्लाइडिंग एनीमेशन होता है जो 300ms लंबा होता है। यह आँखों के लिए सज्जन होता है पर अगर आपको कोई फर्क नहीं पड़ता तो आप इसे बंद कर सकते हैं।

एडमिनिस्ट्रेटर कॉन्फ़िगरेशन

एडमिनिस्ट्रेटर रिफरेन्स पॉपअप को "लॉकडाउन मोड" में रखकर विकी से गैजेट की कॉन्फ़िगरेशन लिंक हटा सकते हैं। यह पॉपअप को सक्षम रहने पर मजबूर करता है और पृष्ठ के नीचे का कॉन्फ़िगरेशन लिंक हटा देता है, पर यह पॉपअप से लिंक नहीं हटाता।

लॉकडाउन मोड़ सक्षम करने के लिए MediaWiki:Common.js पर ऊपर दिए गए इम्पोर्ट वाक्यों से पहले जोड़े।

((window.dev = window.dev || {}).ReferencePopups = dev.ReferencePopups || {}).lockdown = true;

आप नए सदस्यों के लिए डिफ़ॉल्ट भी बदल सकते हैं। आप इसे इस्तेमाल करके एनीमेशन अक्षम कर सकते हैं:

((window.dev = window.dev || {}).ReferencePopups = dev.ReferencePopups || {}).defaults = { animate: false };

कस्टम पॉपअप

इस स्क्रिप्ट का पॉपअप कॉम्पोनेन्ट पूरी तरह से पुन: प्रयोज्य है और जिसे आप रेफरेन्सेस के साथ-साथ चाहते हैं उसे प्रदर्शित करने के लिए फिर से तैयार किया जा सकता है। एक पूर्व-निर्मित स्क्रिप्ट और टेम्प्लेट सेट प्रदान किया जाता है यदि आप बस कुछ छोड़ना या इस्तेमाल करना चाहते हैं। वैकल्पिक रूप से, यदि आप अपना जावास्क्रिप्ट लिखने में सक्षम हैं, तो आप इसके बजाय पॉपअप के खिलाफ चीज़ो को AJAX करने के लिए और कुछ तत्वों के साथ इंटरैक्ट करने पर पॉपअप खोलने के लिए कोड कर सकते हैं।

कस्टम पॉपअप को इस्तेमाल करने के लिए आपको कस्टम पॉपअप स्क्रिप्ट इम्पोर्ट करना होगा:

dev:ReferencePopups/custom.js

और आपको यह दो टेम्पलेट अपने विकी पर कॉपी-पेस्ट करके बनाना होगा:

इन टेम्पलेट में लिखा है कि इसे कैसे इस्तेमाल करना है।

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

आप कस्टम पॉपअप के लिए कस्टम स्किन भी बना सकते हैं। इसका एक उदहारण इसके डेमो पृष्ठ पर है। आप इसका CSS यहाँ देख सकते हैं।

Advertisement