सहायता:जादूई शब्द

"WP:MAGIC" यहाँ पुनर्प्रेषित होता है। विकिपाठ के स्वतः बदवाव पर सहायता के लिए, Help:Magic देखें। मंच जादू एवं भ्रम पर विकिपरियोजना के लिए, Wikipedia:WikiProject Magic देखें।

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

जादूई शब्दों के लिये त्वरित संदर्भ इस पृष्ठ पर मिलेगा। अधिक ब्यौरे हेतु मीडियाविकि जालस्थल पर देखें:

• mw:Help:Magic words सभी मानक जादूई शब्दों के लिये। इनमें "मानक" पार्सर फ़ंक्शंस भी सम्मिलित हैं।
• mw:Help:Extension:ParserFunctions कुछ अतिरिक्त पार्सर फ़ंक्शंस हेतु, जिनमें सशर्त अभिव्यक्तियाँ यानि कण्डीशनल एक्स्प्रेशंस भी निहित हैं।

सामान्य जानकारी

मुख्यतः तीन प्रकार के जादूई शब्द होते हैं:

1. व्यवहारीय स्विच/Behavior switches: दोहरे अण्डरस्कोर्स से घिरे हुए अंग्रेज़ी के ऊपरी केस के शब्द, जैसे, __NOTOC__ या पार्सर फ़ंक्शन सिन्टैक्स प्रयोग करते हुए अन्य कीवर्ड्स
2. वैरियेबल्स: दोहरे कोष्ठकों से घिरे अंग्रेज़ी के ऊपरी केस के शब्द (जो साँचे दर्शाते हैं), जैसे, {{PAGENAME}}
3. पार्सर फ़ंक्शन्स: दोहरे कोष्ठकों में घिरे ऐसे कीवर्ड्स, जिनमें क‘ओलन उपरांत पैरामीतर होते हैं (कुछ # से आरंभ होते हैं) जैसे, {{#expr:2+2}}

कुछ जादूई शब्द केस-सेन्सिटिव अर्थात अंग्रेज़ी के ऊपरी केस को ऊपरी और निचले केस को निचले केस में ही लिखे जाने वाले) होते हैं, किन्तु सभी शब्द नहीं होते। साँचों के सिन्टैक्स की भांति ही यहां भी व्हाइट स्पेस को कीवर्ड्स एवं पैरामीतर्स के पूईर्व या पश्चात से हटा दिया जाता है।

पृष्ठ-निर्भर (पेज-डिपेन्डेन्ट) जादूई शब्द वर्तमान पृष्ठ के बारे में दिया डाटा लाते या प्रभावित करते हैं, चाहे शब्द को किसी ट्रान्स्क्ल्यूडेड साँचे के द्वारा जोड़ा गया हो या फ़िर सिस्टम संदेश सहित हो।

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

व्यवहारीय स्विच

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

• __NOTOC__ (विकिपाठ में कहीं भी लिखा जा सकता है; यह सामगरी सूची को हटा देता है।)
• __FORCETOC__ (विकिपाठ में कहीं भी लिखा जा सकता है; सामग्री सूची को अपनी डीफ़ॉल्ट स्थिति/स्थान पर प्रथम शीर्षक/अनुभाग के साथ/नीचे स्थापित कर देता है।)
• __TOC__ (सामग्री सारणी/सूची को शब्द के स्थान पर लगा देता है।)

• __NOEDITSECTION__ (पृष्ठ की सभी शिर्षकों के आगे से संपादन करें नामक कड़ी हटा देता है।) (मात्र एक शीर्षक के आगे से संपादन कड़ी हटाने हेतु <h2> का प्रयोग करें)
• __NEWSECTIONLINK__ (गैर-"वार्त्ता" पृष्ठ पर नया विषय/अनुभाग जोड़ने हेतु एक "+" चिह्नित कड़ी जोड़ देता है।)
• __NONEWSECTIONLINK__ (गैर-"वार्त्ता" पृष्ठों से "+" हटा देता है।)

• __NOGALLERY__ (श्रेणी पृष्ठ पर, थम्बनेल को सामान्य कड़ियों से बदल देता है।)
• __HIDDENCAT__ (श्रेणी पृष्ठ पर लगाने से उसे एक छिपी श्रेणी में बदल देता है।)
• __INDEX__ (खोज इंजिन को पृष्ठ सूचिकरण की सूचना देता है)
• __NOINDEX__ (खोज इंजिन को पृष्ठ सूचिकरण न करने की सूचना देता है)
• __STATICREDIRECT__ (अनुप्रेषण पृष्ठों पर, मीडियाविकि को कड़ियों का स्वतः अद्यतन करने से रोकता है, जब कोई पृष्ठ को स्थानांतरित करता है, और जाँचता है "Update any redirects that point to the original title", साथ ही अन्तर्विकिबॉट्स को यह बताने हेतु प्रयोग किया जाता है, कि यह अनुप्रेषण एक लेख की तरह देखा जा सकता है)
• __DISAMBIG__ (एक पृष्ठ को बहुविकल्पी पृष्ठ अंकित करता है और उसे w:Special:DisambiguationPagesमें डाल देता है, साथ ही इसकी अंदरूनी कड़ी w:Special:DisambiguationPageLinks में डाल देता है)। देखें mw:Extension:Disambiguator.

• {{DISPLAYTITLE:title}} (पृष्ठ शीर्षक के प्रदर्शित रूप को बदल देता है)
• {{DEFAULTSORT:sortkey}} (डीफ़ॉल्ट श्रेणी सॉर्ट की सेट करता है)

• {{noexternallanglinks}} सारे विकिडाटा स्वतः अन्तर्भाषा कड़ियों को दबाने (सप्रेस करने) के लिये। यह {{noexternallanglinks:*}} के समकक्ष है। व्यक्तिगत भाषाओं की कड़ियों को दबाने हेतु एक पाइप (|) से पृथक की गयी सूची में भाषा कूट देना होता है।, जैसे {{noexternallanglinks:fr|es|ja}}। देखें mw:Extension:Wikibase Client#noexternallanglinks।

वैरियेबल्स

प्रलेखन हेतु, देखें मीडियाविकि पृष्ठ का वैरियेबल्स अनुभाग

• {{FULLPAGENAME}} (पृष्ठशीर्षक के साथ नामस्थान)
• {{PAGENAME}} (पृष्ठशीर्षक नामस्थान छोड़कर)
• {{BASEPAGENAME}} (वर्तमान उपपृष्ठ एवं नामस्थान को छोड़कर पृष्ठ शीर्षक – प्रभावी रूप से नामस्थान के बिना मातृपृष्ठ)
• {{SUBPAGENAME}} (शीर्षक का उपपृष्ठ भाग)
• {{SUBJECTPAGENAME}} (संबंधित गैर-वार्ता पृष्ठ)
• {{TALKPAGENAME}} (संबंधित वार्ता पृष्ठ)
• {{NAMESPACE}} (वर्तमान पृष्ठ का नामस्थान)
• {{SUBJECTSPACE}}, {{ARTICLESPACE}} (संबंधित गैर-वार्ता नामस्थान)
• {{TALKSPACE}} (संबंधित वार्ता नामस्थान)
• {{FULLPAGENAMEE}}, {{NAMESPACEE}} इत्यादि (यूआरएल एनकॊडेड समकक्ष)

सभी उपरोक्त एक पैरामीटर ले सकते हैं, वर्तमान पृष्ठ के अलावा एक अन्य पृष्ठ पर संचालित होने हेतु।

• {{SITENAME}} (विकिपीडिया)
• {{SERVER}} (http://en.wikipedia.org)
• {{SERVERNAME}} (hi.wikipedia.org)
• {{SCRIPTPATH}} (/w)
• {{CURRENTVERSION}} (वर्तमान मीडियाविकि संस्करण)
• {{REVISIONID}} (वर्तमान पृष्ठ का नवीनतम संशोधन)
• {{REVISIONDAY}}, {{REVISIONDAY2}}, {{REVISIONMONTH}}, {{REVISIONYEAR}}, {{REVISIONTIMESTAMP}}, {{REVISIONUSER}} (अंतिम संपादन के समय की दिनांक, समय एवं संपादक)

• {{CURRENTYEAR}}, {{CURRENTMONTH}}, {{CURRENTMONTHNAME}}, {{CURRENTMONTHABBREV}}, {{CURRENTDAY}}, {{CURRENTDAY2}}, {{CURRENTDOW}}, {{CURRENTDAYNAME}}, {{CURRENTTIME}}, {{CURRENTHOUR}}, {{CURRENTWEEK}}, {{CURRENTTIMESTAMP}} (वर्तमान दिनांक/समय वैरियेबल्स)
• {{LOCALYEAR}} आदि (उपरोक्तानुसार, साइट के स्थानीय समय पर आधारित)

• {{NUMBEROFPAGES}}, {{NUMBEROFARTICLES}}, {{NUMBEROFFILES}}, {{NUMBEROFEDITS}}, {{NUMBEROFVIEWS}}, {{NUMBEROFUSERS}}, {{NUMBEROFADMINS}}, {{NUMBEROFACTIVEUSERS}} (अंग्रेज़ी विकिपीडिया पर आंकड़े; बिना लघु विराम की संख्याओं हेतु :R जोड़ें)

पार्सर फ़ंक्शंस

इनका प्रलेखन मुख्य प्रलेख पृष्ठ पर ही किया हुआ है, यदि अन्यथा लिखा न हो।

मेटाडाटा

• {{PAGESIZE:page name}} (पृष्ठ का बाइट्स में आकार)
• {{PROTECTIONLEVEL:action}} (वर्तमान पृष्ठ पर एक चुने हुए कार्य/एक्शन हेतु सुरक्षा स्तर)
• {{PAGESINCATEGORY:categoryname}} (दी हुई श्रेणी में पृष्ठों की संख्या)
• {{NUMBERINGROUP:groupname}} (एक विशिष्ट समूह में सदस्य संख्या)

संख्याओं को बिना लघु विराम के पाने हेतु |R जोड़ें।

स्वरूपण

फ़ॉर्मैटिंग

• {{lc:string}} (निचले केस में बदलें)
• {{lcfirst:string}} (प्रथम कैरेक्टर को निचले केस में बदलें)
• {{uc:string}} (ऊपरी केस में बदलें)
• {{ucfirst:string}} (प्रथम कैरेक्टर को ऊपरी केस में बदलें)
• {{formatnum:unformatted num}} (format a number with comma separators; add |R to unformat a number)
• {{#formatdate:date|format}} (formats a date according to user preferences; a default can be given as an optional case-sensitive second parameter for users without date preference; can convert a date from an existing format to any of dmy, mdy, ymd or ISO 8601 formats, with the user's preference overriding the specified format)
• {{padleft:xyz|stringlength}}, {{padright:xyz|stringlength}} (pad with zeros to the right or left; an alternative padding string can be given as a third parameter)
• {{plural:n|is|are}} (produces alternative text according to whether n is greater than 1)
• {{#time:format string|date/time object}} (for date/time formatting; also #timel for local time. Covered at the extension documentation page.)
• {{gender:username|masculine|female|neutral}} (produces alternate text according to the gender specified by the given user in his/her preferences)

पथ

• {{localurl:page name}}, {{localurl:page name|query string}} (relative path to the title)
• {{fullurl:page name}}, {{fullurl:page name|query_string}} (absolute path to the title)
• {{filepath:file name}} (absolute URL to a media file)
• {{urlhicode:string}} (input encoded for use in URLs)
• {{anchorencode:string}} (input encoded for use in URL section anchors)
• {{ns:n}} (name for the namespace with index n; use {{nse:}} for URL-encoded equivalent)
• {{#rel2abs: path }} (converts a relative file path to absolute; see the extension documentation)
• {{#titleparts: pagename | number of segments to return | first segment to return }} (splits title into parts; see the extension documentation)

सशर्त अभिव्यक्ति

कण्डीश्नल एक्स्प्रेशंस

These are covered at the extension documentation page. Some parameters are optional.

• {{#expr: expression }} (evaluates the given expression; see Help:Calculation)
• {{#if: test string | value if non-empty | value if empty }} (selects one of two values based on whether the test string is empty)
• {{#ifeq: string 1 | string 2 | value if equal | value if unequal }} (selects one of two values based on whether the test strings are equal – numerically if applicable)
• {{#iferror: test string | value if error | value if correct }} (selects value based on whether the test string generates a parser error)
• {{#ifexpr: expression | value if true | value if false }} (selects value based on evaluation of expression)
• {{#ifexist: page title | value if exists | value if doesn't exist }} (selects value depending on whether a page title exists)
• {{#switch: test | case1 = value for case 1 | ... | default }} (provides alternatives based on the value of the test string)

सारणी में इन फ़ंक्शंस के प्रयोग हेतु, देखें [:w:[Wikipedia:Conditional tables|कण्डीशनल टेबल्स]]।

इन्हें भी देखें

अंग्रेज़ी विकिपीडिया से

• mw:Internationalisation
• पार्सर फ़ंक्शंस जोड़ना
• CoreParserFunctions.php
• wikEd, a MediaWiki editor with syntax highlighting for templates and parser functions