MediaWiki में रिसोर्सलॉडर का उपयोग करना

संस्करण 1.17 से शुरू करते हुए, MediaWiki ने स्टाइल और स्क्रिप्ट को असेंबल करने और लोड करने के लिए एक नया तंत्र पेश किया - रिसोर्सलोडर । इस लेख में, मैं GoogleCodePrettify एक्सटेंशन का उपयोग एक उदाहरण के रूप में करने के लिए इसके उपयोग का वर्णन करूंगा , जो वाक्यविन्यास टैग को MediaWiki मार्कअप में जोड़ता है।

एक्सटेंशन के सभी लेखकों को अप्रचलित addScript आदि के बजाय नए तंत्र का उपयोग करने के लिए दृढ़ता से प्रोत्साहित किया addScript ।

सबसे पहले, लोड करने के लिए संसाधन मॉड्यूल को परिभाषित करें:

 $wgResourceModules['ext.GoogleCodePrettify'] = array( 'localBasePath' => dirname(__FILE__), 'remoteExtPath' => 'GoogleCodePrettify', 'styles' => array('google-code-prettify/prettify.css'), 'scripts' => array('google-code-prettify/prettify.js', 'init.js') ); 

अब विकी मार्कअप पार्सर को लोड करते समय, हम सिंटैक्सहिगलाइट टैग को संसाधित करेंगे:

 // Register parser hook $wgHooks['ParserFirstCallInit'][] = 'efGoogleCodePrettify_Setup'; /** * Register parser hook */ function efGoogleCodePrettify_Setup( &$parser ) { $parser->setHook('syntaxhighlight', array('GoogleCodePrettify', 'parserHook')); return true; } class GoogleCodePrettify { private static $prettified = false; public static function parserHook($text, $args = array(), $parser) { self::$prettified = true; return "<pre class=\"prettyprint\">$text</pre>"; } 

और अंत में, यदि आवश्यक हो तो आवश्यक शैलियों और लिपियों को जोड़ें:

 // Register before display hook $wgHooks['BeforePageDisplay'][] = 'GoogleCodePrettify::beforePageDisplay'; #   public static function beforePageDisplay(&$wgOut, &$sk) { if (self::$prettified) { $wgOut->addModules('ext.GoogleCodePrettify'); } // Continue return true; } 

शैलियों और लिपियों की असेंबली रिसोर्सलोडर ध्यान रखेगा। कृपया ध्यान दें कि यदि आपके पास क्वेरी स्ट्रिंग में डीबग = 1 विकल्प है, तो यह स्टाइल और स्क्रिप्ट "जैसा है" देगा।

हां, मैं लगभग भूल गया था। यह init.js स्क्रिप्ट जैसा दिखता है:

 (function($, window) { $(window.document).ready(function() { window.prettyPrint(); }); })(window.jQuery, window); 

---

यह भी देखें:

• गिटहब पर परियोजना भंडार ;
• Google कोड लाइब्रेरी को प्रीटेट करता है
• रिसोर्सलॉडर डॉक्यूमेंटेशन
• रिसोर्सलॉडर का उपयोग करते हुए एक सरल एक्सटेंशन का एक और उदाहरण: मीडियाविकि-माशाजेएस ।