एक्सटेंशन:Disambiguator

मीडियाविकि एक्सटेंशन मैन्युअल

Disambiguator प्रकाशन की स्थिति: स्थिर
कार्यान्वयन	विशेष पृष्ठ
विवरण	एक जादुई शब्द की मदद से बहुविकल्पी पृष्ठों को चिह्नित करने की सुविधा देता है
लेखक	Ryan Kaldari (Kaldariवार्ता)
नवीनतम संस्करण	निरंतर अद्यतन
संगतता नीति	मीडियाविकि के साथ प्रकाशित स्नैपशॉट्स। Master में पीछे की तरफ से संगतता नहीं है।
MediaWiki	1.28+
PHP	5.4+
लाइसेंस	MIT लाइसेंस
डाउनलोड करें	एक्सटेंशन डाउनलोड करें गिट [?]: गिट master डाउनलोड करें रिपॉज़िटरी देखें (GitHub) कमिट्स का इतिहास रिपॉज़िटरी पर योगदानकर्ताएँ (GitHub) कोड निरीक्षण
पैरामीटर $wgDisambiguatorIndicateLinks
उपयोग किए गए हुक AncientPagesQuery ChangeTagsListActive EditPage::showEditForm:initial GetDoubleUnderscoreIDs GetLinkColours LinksUpdateComplete ListDefinedTags LonelyPagesQuery RandomPageQuery RecentChange_save ShortPagesQuery wgQueryPages
Quarterly downloads	56 (Ranked 85th)
Public wikis using	6,730 (Ranked 31st)
Disambiguator एक्सटेंशन को अनुवादित करें अगर यह translatewiki.net पर उपलब्ध है
मुद्दे	अधूरे कार्य · बग की रिपोर्ट करें

Disambiguator एक्सटेंशन को बहुविकल्पी पृष्ठों को प्रोग्रामेटिक रूप से काम करने में आसान बनाने के लिए बनाया गया है। इससे आप सभी बहुविकल्पी पृष्ठों को __DISAMBIG__ जादुई शब्द (या समान उपनाम) से चिह्नित कर सकते हैं, जिसके बाद उन पृष्ठों को डेटाबेस में बहुविकल्पी चिह्नित कर दिया जाता है। इससे दूसरे एक्सटेंशनों को बहुविकल्पी पृष्ठों को पृष्ठों के एक अलग वर्ग के रूप में हैंडल करने का विकल्प प्रदान किया जाता है, हालाँकि इन्हें अब भी "साधारण" पृष्ठ ही माना जाता है।

स्थापना

• फ़ाइलों को डाउनलोड करें और अपने extensions/ फ़ोल्डर के Disambiguator नामक डिरेक्ट्री में डालें।
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Disambiguator
• अपने LocalSettings.php फ़ाइल के अंत में निम्न कोड जोड़ें:

  wfLoadExtension( 'Disambiguator' );
  

• आवश्यकतानुसार कॉन्फ़िगर करें।
•  पूर्ण – अपने विकि पर Special:Version पर जाकर देखें कि एक्सटेंशन को सफलतापूर्वक स्थापित किया गया है कि नहीं।

कॉन्फ़िगरेशन

निम्न कॉन्फ़िगरेशन वेरिएबलों को आपके LocalSettings.php फ़ाइल से सेट किया जा सकता है।

• $wgDisambiguatorIndicateLinks - बहुविकल्पी पृष्ठों की कड़ियों पर 'mw-disambig' CSS क्लास जोड़ना है या नहीं (डिफ़ॉल्ट है true)
• $wgDisambiguatorNotifications - विकिटेक्स्ट एडिटर्स में किसी बहुविकल्पी पृष्ठ की कड़ी जोड़ने पर सदस्य को चेतावनी दिखानी है या नहीं (डिफ़ॉल्ट है false)

सुविधाएँ

Disambiguator निम्न सुविधाएँ प्रदान करता है:

• __DISAMBIG__ जादुई शब्द की मदद से बहुविकल्पी पृष्ठों की प्रोग्रामेटिक रूप से पहचान करना
• सभी बहुविकल्पी पृष्ठों, और बहुविकल्पी पृष्ठों की कड़ियों वाले सभी पृष्ठों को सूचीबद्ध करने के लिए नए विशेष पृष्ठ
• उपरोक्त विशेष पृष्ठों को लिए नए API फ़ंक्शन्स, और साथ में यह क्वेरी करने के लिए एक API फ़ंक्शन की निर्दिष्ट पृष्ठ बहुविकल्पी पृष्ठ है या नहीं
• Special:LonelyPages को बदलकर बहुविकल्पी पृष्ठों को अनदेखा करवाता है
• Special:Random को बदलकर बहुविकल्पी पृष्ठों को अनदेखा करवाता है (मीडियाविकि 1.26.0 की ज़रूरत है)
• अगर VisualEditor सक्षम है, इससे पृष्ठ गुणधर्म इंटरफ़ेस की मदद से पृष्ठ को बहुविकल्पी पृष्ठ चिह्नित किया जा सकता है
• अगर VisualEditor सक्षम है, कड़ी जाँचकर्ता में दिखाता है कि पृष्ठ बहुविकल्पी पृष्ठ है या नहीं
• अगर VisualEditor सक्षम है, कड़ी डायलॉग में दिखाता है कि कड़ी बहुविकल्पी पृष्ठ है या नहीं
• अगर कॉन्फ़िगर किया जाता है, बहुविकल्पी पृष्ठों की कड़ियों पर एक 'mw-disambig' CSS क्लास जोड़ देता है (ऊपर #कॉन्फ़िगरेशन देखें)
• अगर WikiEditor का उपयोगकर्ता बहुविकल्पी पृष्ठ की कड़ी जोड़ने जाता है, उसे चेतावनी दिखाता है और कड़ी को ठीक करने देता है।

उपयोग

end-user help के लिए Help:Extension:Disambiguator देखें।

विकि पर

जब Disambiguator को स्थापित कर लिया गया हो, इसका इस्तेमाल करने का सबसे अच्छा तरीका है __DISAMBIG__ जादुई शब्द को किसी ऐसे साँचे पर जोड़ना जो आपके सभी बहुविकल्पी पृष्ठों पर जोड़ा गया हो।

जब जादुई शब्द जुड़ जाए, आपके बहुविकल्पी पृष्ठों पर डेटाबेस में 'बहुविकल्पी' पृष्ठ गुणधर्म जुड़ जाएगा। यह गुणधर्म page_props टेबल में रहती है।

आपके पास दो नए special pages भी होंगे:

• Special:DisambiguationPages - जो आपके विकि पर सभी बहुविकल्पी पृष्ठों को सूचीबद्ध करता है।
• Special:DisambiguationPageLinks - जो आपके विकि पर उन सभी पृष्ठों को सूचीबद्ध करता है जिनपर बहुविकल्पी पृष्ठों की कड़ियाँ हैं। (यह पुराने कालग्रस्त Special:Disambiguations पृष्ठ का नया संस्करण है।)

API से

सभी बहुविकल्पी पृष्ठों को सूचीबद्ध करने के लिए:

api.php?action=query&list=querypage&qppage=DisambiguationPages

बहुविकल्पी पृष्ठों की सभी कड़ियों को सूचीबद्ध करने के लिए:

api.php?action=query&list=querypage&qppage=DisambiguationPageLinks

ध्यान रखें कि MiserMode में चलने वाले विकियों (सभी WMF विकियों) पर DisambiguationPageLinks के लिए विशेष पृष्ठ और API इंटरफ़ेस, दोनों को परिणामों की एक विशिष्ट संख्या (आम तौर पर 1000 से 5000) तक सीमित किया जाता है।

यह देखने के लिए कि निर्दिष्ट पृष्ठ बहुविकल्पी पृष्ठ है या नहीं:

api.php?action=query&titles=Bug&prop=pageprops&ppprop=disambiguation

अगर यह एक बहुविकल्पी पृष्ठ है, इसके pageprops में 'बहुविकल्पी' शामिल होगा। ध्यान रखें कि अगर बहुविकल्पी पृष्ठ गुणधर्म मौजूद होता है, इसका वैल्यू को खाली स्ट्रिंग होगा, तो इसे बूलियन के रूप में परीक्षित करते समय सतर्क रहें।

SQL

To see if an individual page is a disambiguation page, check the page_props table for the presence of a pp_propname = 'disambiguation'. Pages that are not disambiguation pages will not have this pp_propname. The pp_value isn't important.

SELECT page_title, pp_propname
FROM page
LEFT JOIN page_props ON pp_page = page_id AND pp_propname = 'disambiguation'
WHERE page_namespace = 0
AND page_title IN ('John', 'COVID-19') -- John is a disambiguation page on enwiki, COVID-19 is not

भविष्य की संभावित योजनाएँ

• इनसे बहुविकल्पी पृष्ठ छिपाने का विकल्प जोड़ना: Special:AllPages (task #9936), Special:PrefixIndex (task #11319), Special:WhatLinksHere (task #9935), Special:AncientPages (task #76287)
• विकिटेक्स्ट एडिटर की कड़ी डायलॉग में एक सुविधा जोड़ना जिससे यह खोज परिणामों में बहुविकल्पी पृष्ठों का पता लगा पाएगा और कड़ियों की एक सूची ला पाएगा
• इस एक्सटेंशन के लिए बग्स की पूरी सूची