MediaWiki 1.16.x इंजन में निर्मित jQuery लाइब्रेरी को अक्षम करें और इसे एक नए, अद्यतन और अद्यतन विकी व्यवस्थापक के साथ बदलें

जैसा कि मीडियाविकि वेबसाइट पर पढ़ना आसान है, स्थिर संस्करणों (1.16.x) की वर्तमान पंक्ति एक अंतर्निहित jQuery लाइब्रेरी के साथ आती है, जिसका कोड "खाल / आम / jquery.min.js" पर स्थित है। यह एक अपेक्षाकृत पुराने संस्करण का jQuery है (1.3.2, फरवरी 2009 में जारी किया गया), इसके एक कीड़े को दूर करने के लिए थोड़ा पैच किया गया था, और यह संगतता मोड (" noConflict () ") में चलता है ताकि यह $ $ के बजाय चर $ j में फिट हो जाए । इस jQuery कोड में कोई प्लगइन्स नहीं है और सार रूप में वैकल्पिक है, केवल पेज से कनेक्ट होने पर ही जब MediaWiki कोड में $ wgOut-> शामिलJJQuery () विधि का कॉल होता है । मान लीजिए कि प्रयोज्यता पहल के अंतर्गत "UsabilityInitiative.hooks.php" फ़ाइल की लाइन 128 पर ऐसी ही कॉल आती है, इसलिए jQuery कुछ खाल (जैसे वेक्टर) में प्रकट होता है जब UsabilityInitiative एक्सटेंशन विकि से जुड़ा होता है।

मेरा सुझाव है कि आप एक विकी तकनीशियन के दृष्टिकोण को लेते हैं, अर्थात, मीडियाविकि सर्वर का प्रशासक, जिसमें सीधी पहुंच होती है (जैसे SSH) और विकी सेटिंग्स को बदलने की क्षमता (LocalSettings.php), विन्डोज़ी एक्सटेंशन को पुनः स्थापित करें और अन्य समान क्रियाओं को करें। किन परिस्थितियों के कारण MediaWiki 1.16.x विकी पिछले पैराग्राफ में उल्लिखित स्थिति को बेहतर बनाने के लिए प्रयास करने का प्रयास कर सकता है? इस आकांक्षा की प्राप्ति में विकी तकनीक संचालित करने का सबसे उपयुक्त तरीका क्या है?

इस इच्छा का पहला आवेग प्राकृतिक और लगभग अपरिहार्य बोध है कि पेज कोड में jQuery की उपस्थिति कितनी असुविधाजनक है, जो डिफ़ॉल्ट रूप से कॉन्फ़िगर किया गया है। हर विकी तकनीशियन, यदि उसके पास विचार के लिए पर्याप्त अवकाश है, तो जल्दी या बाद में यह समझ में आता है कि फ़ंक्शन $ की सादगी और शक्ति ( ... ) , अगर यह हमेशा विकिस के लिए स्क्रिप्ट लिखने वाले प्रशासकों के निपटान में होता है, तो निश्चित रूप से बहुत अधिक कॉम्पैक्ट जेएस कोड को जन्म देगा। पूर्व की तुलना में। उदाहरण के लिए 22 मई, 2011 के "मीडियाविकि: कॉमन.जेएस" पृष्ठ को रूसी भाषा के विकिपीडिया के संस्करण से लें। इसमें यह देखना आसान है कि फ़ंक्शन कोड क्या है:

function editZeroSection(){ var body = document.getElementById('bodyContent') if (!body) return var h2s = body.getElementsByTagName('H2') var h2 = h2s[0] if (!h2) return if (h2.parentNode.id == 'toctitle') h2 = h2s[1] if (!h2) return var span = h2.firstChild if (!span || span.className != 'editsection') return var zero = span.cloneNode(true) body.insertBefore(zero, body.firstChild) var a = zero.getElementsByTagName('a')[0] if (a.href.indexOf('§ion=T') == -1 ) a.title = a.title.replace(/:.*$/,': 0') else a.title = ' : 0' a.setAttribute('href', wgScript + '?title='+encodeURIComponent(wgPageName) + '&action=edit§ion=0') } 

कोई भी jQuery प्रशंसक जानता है कि यह लाइब्रेरी फ़ंक्शन के लेखकों को पूरी तरह से getElementById () और getElementsByTagName () के साथ-साथ कुछ अन्य तरीकों और फ़ील्ड्स के संक्षिप्त रूप प्रदान करने से बचाएगी। लेकिन इस तरह के एक से अधिक फ़ंक्शन हैं। एक और ऐसी विकी नहीं: समान बोझिलता को देखना आसान है, कहते हैं, "एब्सर्डडोपेडिया" के "मीडियाविकि: कॉमन.जेएस" पृष्ठ के 28 मई 2011 के संस्करण में ।

मान लें कि एक विकी तकनीशियन ने यह सुनिश्चित किया कि आधिकारिक निर्देशों का पालन करके और स्थानीयSettings.php फ़ाइल में उपयुक्त कोड जोड़कर jQuery पेज कोड में दिखाई देता है:

 // Include jQuery function wfIncludeJQuery() { global $wgOut; $wgOut->includeJQuery(); } $wgExtensionFunctions[] = 'wfIncludeJQuery'; 

विकी एडमिनिस्ट्रेटर के पास, "MediaWiki: Common.js" पृष्ठ को संपादित करने के अधिकार हैं, जो jQuery पर स्थानीय कार्यों को फिर से लिखना शुरू कर दिया, addOnloadHook ( ... ) के बजाय $ ( ... ) का उपयोग करें , और इसी तरह। भविष्य में इस प्रक्रिया में कौन से दो ठोकर का इंतजार है?

सबसे पहले, जब आप jQuery के इतिहास से परिचित हो जाते हैं, तो यह निश्चित रूप से उस संस्करण को प्रकट करेगा 1.3.2 (जैसा कि मैंने थोड़ा अधिक उल्लेख किया है) एक लंबे समय पहले दिखाई दिया - पहले से ही फरवरी 2009 में । हबराब्रिज jQuery ब्लॉग के नियमित पाठकों को यह बताने की आवश्यकता नहीं है कि पिछले 2 वर्षों में पुस्तकालय का विकास कितना महान और महत्वपूर्ण रहा है; बाकी सभी के लिए, मैं केवल संस्करण १.४.३ में एनीमेशन त्वरण का एक उदाहरण देता हूँ , संस्करण १.५ में नए आस्थगित इंटरफेस ([ १ ], [ २ ]) , संस्करण १.५.१ में IE9 के लिए पूर्ण समर्थन ... और १४ पृष्ठों में सामान्य रूप से संस्करण १.४ में परिवर्तन। सेट हो गया।

दूसरे, मौजूदा लिपियों को एक jQ- आधारित ढांचे में स्थानांतरित करना मुश्किल से समाप्त हो रहा है , विकी प्रशासक स्वाभाविक रूप से इस बारे में सोचेंगे कि ऑटोमेशन (स्क्रिप्टिंग) के लिए क्या संभावनाएं हैं। यह लगभग अपरिहार्य है कि वे jQuery प्लगइन्स के रूप में इस तरह के एक भयानक उपकरण से परिचित हो जाएंगे जो कुछ ही समय में महत्वपूर्ण, प्रभावशाली सुधार के साथ साइट की आपूर्ति करने के लिए एक सरल विधि ("कॉपी-पेस्ट") का उपयोग करने की अनुमति देते हैं। उदाहरण के लिए, बस jQuery.ScrollTo और jQuery.LocalScroll जोड़ें - और तुरंत सभी इन-पेज हाइपरलिंक तुरंत एक साधारण स्क्रिप्ट का उपयोग करके शानदार पेज स्क्रॉलिंग एनिमेशन के साथ प्रदान किए जा सकते हैं:

 $(function(){ $.localScroll({ hash: true, onAfter: function(target){ location = '#' + ( target.id || target.name ); } }); }); 

मीडियाविकि इंजन विकी के लिए, सामग्री की स्वचालित तालिका के साथ, व्यवहार में इस तरह का सुधार अमूल्य है।

हम देखते हैं: इस स्तर पर, घटनाओं का कोर्स एक फाइल बनाने के लिए विकी पर जोर दे रहा है (सबसे अच्छी बात, एक फ़ाइल ताकि सर्वर के लिए अतिरिक्त अनुरोधों पर समय बर्बाद न हो), जिसमें jQuery लाइब्रेरी का नया संस्करण और इसके लिए सभी वांछित प्लगइन्स शामिल हैं। । क्या खाल / आम / jquery.min.js ऐसी फ़ाइल की भूमिका के अनुरूप होगी? यह संभावना नहीं है, और दो कारणों से। सबसे पहले, जैसा कि आप जानते हैं , MediaWiki के नए संस्करण के लिए कोई भी संक्रमण (यहां तक ​​कि संस्करण 1.16.x से संस्करण 1.16.x + 1 तक) में पुरानी पर नई फाइलें लिखना शामिल है - अपडेट करने की थोड़ी सी लापरवाही से फाइल की खाल / आम हो सकती है। /jquery.min.js ” को फिर से प्रतिस्थापित किया जाएगा, जिसे मीडियाविकि (1.3.2, प्लगइन्स के बिना) के साथ jQuery संस्करण के साथ भेज दिया जाएगा। दूसरी बात, विकी तकनीक को अपडेट करने के लिए jQuery और प्लगइन्स को सौंपना बिल्कुल भी तर्कसंगत नहीं है और इसके लिए विकी सर्वर तक सीधी पहुंच की आवश्यकता है , क्योंकि कई अन्य MediaWiki javascripts (जैसे कि उपरोक्त "MediaSiki: Common.js", उदाहरण के लिए) ) कोई भी प्रशासक विकी के इंटरफेस के माध्यम से संपादित कर सकता है, इसके अलावा, यह संस्करण नियंत्रण के लिए एक सुविधाजनक अंतर्निहित प्रणाली और संपादन के अंतर को देखने के साथ सुसज्जित है। यह पता चला है कि यह अधिक तार्किक और jQuery के साथ होगा, सभी प्लगइन्स के साथ जो एक विशेष विकी में उपयुक्त हैं, "MediaWiki: jQuery.js" नाम के साथ एक पृष्ठ पर रखने के लिए, लेकिन शांत।

क्या ऐसा प्लेसमेंट तकनीकी रूप से प्राप्त करने योग्य है? हाँ, काफी प्राप्त; इसके लिए, फ़ाइल को "LocalSettings.php" से निकालने के लिए पर्याप्त है कि उस कोड के साथ उस कोड को शामिल करें JJQuery () विधि जो पिछले चरण में वहां जोड़ा गया था - और इसके बजाय ऐसे MediaWiki एक्सटेंशन पर कॉल कनेक्ट करें जो स्क्रिप्ट के कनेक्शन को सक्षम करेगा "MediaWiki: jQuery.js" , हाँ, इसके अलावा, मैं स्क्रिप्ट में " कॉल / कॉन्स / कॉमन / jquery.min.js" शामिल करने के लिए कॉल को काटूंगा , अगर इसमें कॉल शामिल है तो JJQuery () विधि अभी भी कुछ अन्य एक्सटेंशन से आती है ।

ऐसे मीडियाविकि एक्सटेंशन कोड को लिखने का कार्य जो प्रत्येक विकी पेज पर "MediaWiki: jQuery.js" को कनेक्ट करेगा, मेरे द्वारा लंबे समय से हल किया गया है - इसका उत्तर (इसका कोड) इस प्रकार है (एमआईटी लाइसेंस सहित):

 <?php /* * jQuery.php - Adds jQuery script to the <head> . . . </head> * @author Mithgol the Webmaster * @version 0.2 * @copyright Copyright (C) 2010 Mithgol the Webmaster * @license The MIT License - http://www.opensource.org/licenses/mit-license.php * --------------------------------------------------------------------------------------- * Copyright (c) 2010 Mithgol the Webmaster * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights to * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of * the Software, and to permit persons to whom the Software is furnished to do * so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR * OTHER DEALINGS IN THE SOFTWARE. * ----------------------------------------------------------------------- * Version notes: * version 0.2: * erase MediaWiki's internal jQuery call, which lacks plugins * version 0.1: * initial release * ----------------------------------------------------------------------- */ # Confirm MW environment if (defined('MEDIAWIKI')) { # Credits $wgExtensionCredits['other'][] = array( 'name' => 'jQuery', 'author' => 'Mithgol the Webmaster', 'url' => 'http://traditio.ru/wiki/JQuery_%D0%B4%D0%BB%D1%8F_MediaWiki', 'description' => 'Adds jQuery to the list of scripts (HEAD element).', 'version' => '0.2' ); function jQueryMyHook( &$output, &$skin ) { $output->mScripts = "\t\t". '<script type="text/javascript" src="/w/index.php?title=MediaWiki:jQuery.js&action=raw&ctype=text/javascript"></script>'. "\n" . preg_replace('/<script src="\/w\/skins\/common\/jquery\.min\.js\?\d+"><\/script>/', '<!-- jQuery double, erased -->', $output->mScripts); return true; } $wgHooks['BeforePageDisplay'][] = 'jQueryMyHook'; } # End MW Environment wrapper ?> 

कृपया ध्यान दें कि काटने की फाइल "खाल / आम / jquery.min.js" मीडियािकी को जोड़ने के तरीके को ध्यान में रखती है "?" और स्क्रिप्ट के URL पर एक नंबर ।

"MediaWiki: jQuery.js" फ़ाइल को भरते समय, jQuery नाम प्रारूप में "खाल / आम / jquery.min.js" के साथ पिछड़े संगतता प्रदान करना उचित है। इस उद्देश्य के लिए, "MediaWiki: jQuery.js" फ़ाइल में निम्न कोड डालना पर्याप्त है:

 /*      MediaWiki: * 1) /skins/common/edit.js * 2) /skins/common/preview.js *   ,  jQuery    $j. *     : */ $j=$; 

जाहिर है, मुझे उम्मीद है कि इस पर्यायवाची को jQuery लाइब्रेरी कोड के बाद ही बनाया जाना चाहिए।

उपरोक्त विस्तार को 2010 में रूसी विकि-एनसाइक्लोपीडिया "परंपरा" में पेश किया गया था और व्यवहार में इसकी उपयुक्तता को पूरी तरह से साबित करने में कामयाब रहा। लिपियों द्वारा बनाए गए कुछ सुधार और सुविधाएं जो MediaWiki में jQuery का उपयोग संभव बनाता है, वह Habrahabr पर शायद अलग ब्लॉग पोस्ट के लायक है, लेकिन मेरी वर्तमान कहानी खत्म हो गई है।