Jump to content

मैनुअल:$wgResourceModuleSkinStyles

From mediawiki.org
This page is a translated version of the page Manual:$wgResourceModuleSkinStyles and the translation is 86% complete.
Outdated translations are marked like this.
ResourceLoader: $wgResourceModuleSkinStyles
मौजूदा रिसोर्सलोडर मॉड्यूल के लिए अतिरिक्त स्किन-प्रदत्त स्टाइलशीट की सरणी।
Introduced in version:1.24.0 (Gerrit change 141259; git #3971d064)
Removed in version:Still in use
Allowed values:(बहु आयामी सरणी)
Default value:[]
यह कॉन्फ़िगरेशन विकल्प एक्सटेंशन द्वारा उपयोग नहीं किया जाना चाहिए। उन्हें प्रति-त्वचा शैली प्रदान करने के लिए अपने स्वयं के संसाधन लोडर मॉड्यूल की skinStyles संपत्ति का उपयोग करना चाहिए। यह केवल क्सिन के लिए है ताकि मौजूदा मॉड्यूल को खुद के लिए अनुकूलित किया जा सके।

$wgResourceModuleSkinStyles वैश्विक मौजूदा रिसोर्सलोडर मॉड्यूल को अनुकूलित करने के लिए अतिरिक्त स्टाइलशीट प्रदान करने के लिए स्किन को सक्षम बनाता है। स्किन skin.json में रिसोर्समॉड्यूलस्किन स्टाइल्स कुंजी को संपादित करके इसे संशोधित कर सकते हैं। एक्सटेंशन अपने रिसोर्सलोडर मॉड्यूल परिभाषाओं पर skinStyles कुंजी सेट करके अपनी मॉड्यूल शैलियों को खाल द्वारा अनुकूलन योग्य बना सकते हैं।

यह दोनों डिफ़ॉल्ट शैलियों को ओवरराइड करना आसान (या बिल्कुल संभव) बनाता है और अधिकांश पृष्ठों पर अप्रयुक्त शैलियों को लोड न करके त्वचा के स्टाइल पदचिह्न को कम करता है। उदाहरण के लिए, यदि किसी स्किन में Special:UserLogin पृष्ठ के प्रकटन को ओवरराइड करने के लिए बहुत अधिक सीएसएस कोड है, तो यह इसे एक अलग सीएसएस या कम फ़ाइल में रख सकता है जो 'mediawiki.special.userlogin.login.styles' को ओवरराइड करता है और रिसोर्सलोडर केवल उस त्वचा सीएसएस को लोड करेगा जब पेज को इस मॉड्यूल की आवश्यकता होगी।

$wgResourceModuleSkinStyles एक बहुआयामी सरणी है। पहले स्तर पर इसमें पैकेज (स्किन/विस्तार) का नाम होता है, जो अतिरिक्त शैलियों को जोड़ता है (निम्नलिखित उदाहरण में "फू" कहा जाता है)। दूसरे स्तर पर इसमें की-वैल्यू-जोड़े होते हैं:

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

वेक्टर इस पद्धति का उपयोग करने वाली स्किन में से एक है, और एक अच्छा व्यावहारिक उपयोग प्रदर्शन प्रदान करता है। परिभाषा कुंजी ResourceModuleSkinStyles के अंतर्गत पाई जा सकती है।

$2 मॉड्यूल को परिभाषित करने और उपयोग करने के बारे में मूलभूत जानकारी के लिए $wgResourceModules के लिए दस्तावेज़ीकरण देखें।

प्रलेखन

skin.json के अंदर ResourceModuleSkinStyles कुंजी का उपयोग ज्ञात $3 मॉड्यूल की शैलियों को बदलने के लिए किया जा सकता है जिन्हें अन्य एक्सटेंशन की ResourceModules कुंजी में परिभाषित किया गया है।

$wgResourceModuleSkinStyles का उपयोग करके परिभाषित शैलियों को बाद में मौजूदा मॉड्यूल की skinStyles सूची में जोड़ा गया है। styles सूची को संशोधित या अक्षम नहीं किया जा सकता है।

उदाहरण के लिए, यदि यह $1 मॉड्यूल bar की परिभाषा है:

$wgResourceModules['bar'] = [
  'scripts' => 'resources/bar/bar.js',
  'styles' => 'resources/bar/main.css',
];

तो स्किन Foo इसके लिए अतिरिक्त स्टाइल प्रदान करेगा:

$wgResourceModuleSkinStyles['foo'] = [
  'bar' => 'skins/Foo/bar.css',
];

यह ज्यादातर इसके बराबर है:

$wgResourceModules['bar'] = [
  'scripts' => 'resources/bar/bar.js',
  'styles' => 'resources/bar/main.css',
  'skinStyles' => [
    'foo' => 'skins/Foo/bar.css',
  ],
];

यदि मॉड्यूल किसी दी गई स्किन के लिए पहले से ही skinStyles में अपनी प्रविष्टि को परिभाषित करता है, तो $wgResourceModuleSkinStyles को अनदेखा कर दिया जाता है।

यदि कोई मॉड्यूल skinStyles['default'] को परिभाषित करता है तो स्किन उन्हें बदलने के बजाय उसे विस्तारित करना चाह सकती है। यह + उपसर्ग का उपयोग करके किया जा सकता है।

उदाहरण:

$wgResourceModules['bar'] = [
  'scripts' => 'resources/bar/bar.js',
  'styles' => 'resources/bar/basic.css',
  'skinStyles' => [
    'default' => 'resources/bar/additional.css',
  ],
];
// '+' वर्ण पर ध्यान दें:
$wgResourceModuleSkinStyles['foo'] = [
  '+bar' => 'skins/Foo/bar.css',
];

यह ज्यादातर इसके बराबर है:

$wgResourceModules['bar'] = [
  'scripts' => 'resources/bar/bar.js',
  'styles' => 'resources/bar/basic.css',
  'skinStyles' => [
    'default' => 'resources/bar/additional.css',
    'foo' => [
      'resources/bar/additional.css',
      'skins/Foo/bar.css',
    ],
  ],
];

दूसरे शब्दों में, एक मॉड्यूल लेखक के रूप में, स्टाइलशीट के लिए styles सूची का उपयोग करें जो किसी स्किन द्वारा अक्षम नहीं किया जा सकता है। डिफ़ॉल्ट शैलियाँ प्रदान करने के लिए जिन्हें बढ़ाया या बदला जा सकता है, skinStyles['default'] का उपयोग करें।

जैसा कि $wgResourceModules के साथ होता है, पथ डिफ़ॉल्ट रूप से मीडियाविकि रूट के सापेक्ष होते हैं। आपको हमेशा localBasePath और remoteBasePath (या remoteExtPath/remoteSkinPath) देना चाहिए।

उदाहरण:

$wgResourceModuleSkinStyles['foo'] = [
  'bar' => 'bar.css',
  'quux' => 'quux.css',
  'remoteSkinPath' => 'Foo',
  'localBasePath' => __DIR__,
];
मीडियाविकि संस्करण:
1.25
Gerrit change 161173

मीडियाविकि यूआई शैलियों को साफ़ करना

कोर मीडियाविकि MediaWiki UI default मॉड्यूल के सीएसएस को default skinStyles के रूप में जोड़ता है, जिससे स्किन को उनकी स्टाइलिंग को ओवरराइड करने की अनुमति मिलती है। एक चरम उदाहरण के लिए, अधिकांश स्टाइल को खत्म करने के लिए:

$wgResourceModuleSkinStyles['foo'] = [
        'mediawiki.ui' => [],
        'mediawiki.ui.checkbox' => [],
        'mediawiki.ui.radio' => [],
        'mediawiki.ui.anchor' => [],
        'mediawiki.ui.button' => [],
        'mediawiki.ui.input' => [],
        'mediawiki.ui.icon' => [],
        'mediawiki.ui.text' => [],
);

See also