Help:Gadget-ACDC/hi
This is the documentation for AC/DC, a JavaScript gadget which can be enabled or disabled in your Preferences. The script itself is located at MediaWiki:Gadget-ACDC.js. |
If you need more help, please ask at the discussion page or at Commons:Help desk. Documentation: |
AC/DC या ACDC, Add to Commons / Descriptive Claims का संक्षिप्त रूप, फ़ाइलों के समूह में संरचित डेटा के समूह जोड़ने के लिए एक गैजेट है।
स्थापना
गैजेट को अपनी वरीयताओं में सक्षम करें। यह कुछ ऐसा दिखता है:
Add to Commons / Descriptive Claims (ACDC): Add a collection of structured data statements to a set of files. [documentation / talk]
उपयोग
यह गैजेट साइडबार के Tools अनुभाग में एक "AC/DC" कड़ी जोड़ता है; मुख्य डायलॉग खोलने के लिए उसपर क्लिक करें। इनपुट फ़ील्ड में उन फ़ाइलों के नाम दर्ज करें जिन्हें आप सम्पादित करना चाहते हैं, और कॉमन्स के सदस्य इंटरफ़ेस के साधारण संरचित तत्वों की मदद से उनके नीचे के बयान सम्पादित करें। जब आप तैयार हों, सभी सूचीबद्ध फ़ाइलों पर बयानों को जोड़ने के लिए ऊपर के बड़े नीले बटन पर क्लिक करें (अंग्रेज़ी भाषा में "publish changes" मगर वह अनुवादित भी हो सकता है)। डायलॉग के पूरे हो जाने और अपने आप बंद हो जाने तक ब्राउज़र का विंडो/टैब बंद न करें (ऊपर एक प्रगति रेखा दिखनी चाहिए)।
आप फ़ाइलों की सूची में पाइप (|), टैब या लाइन-ब्रेक कैरेक्टर्स से विभाजित कई शीर्षक चिपका सकते हैं। Enter दबाने के बाद उन्हें ठीक से बाँट दिया जाएगा। मगर यह ध्यान में रखें कि गैजेट बहुत सारी फ़ाइलों के साथ ठीक से काम न भी कर सकता है; हालाँकि कोई ठोस सीमा नहीं है, कई सैकड़ों की संख्या में फ़ाइलें जोड़ देने पर ब्राउज़र शायद कुछ पल के लिए अटक जाए, और मैंने इस पैमाने पर कभी सम्पादन करके देखा नहीं है। संभवतः इसमें सदियों लग जाएँगे, और आपको बस उस दौरान अपना डिवाइस चलाकर रखना है और अपना ब्राउज़र खुला रखना है।
आप आईकॉन पर क्लिक करके "श्रेणी लोड करें" या "PagePile लोड करें" वाले बटन पर क्लिक करके, और फिर खुलने वाले डायलॉग में श्रेणी का शीर्षक या PagePile ID डालकर किसी श्रेणी या किसी PagePile में से सभी पृष्ठ जोड़ सकते हैं; वैकल्पिक रूप से, श्रेणी का शीर्षक या PagePile ID सीधे इनपुट फ़ील्ड में चिपकाएँ। पिछले अनुच्छेद में बताई चीज़ों का ध्यान रखा जाना चाहिए — गैजेट हज़ारों फ़ाइलों के साथ ठीक से काम न भी कर सकता है। (फ़ाइलों की सूची के ज़्यादा लंबे होने पर सदस्य इंटरफ़ेस भी कुछ बोझल-सा हो जाता है, इसलिए आपको जोड़ने के लिए बयान पहले निर्दिष्ट कर देने चाहिए, और आखिर में ही श्रेणी या PagePile को लोड करना चाहिए।)
अगर Cat-a-lot सक्षम होता है, आप उससे कुछ फ़ाइलों को चुन सकते हैं, और AC/DC खोलने पर उन फ़ाइलों को अपने आप जोड़ दिया जाएगा। (आप उपरोक्त विधि से AC/DC में और भी फ़ाइलें जोड़ पाएँगे।)
अगर उसी वैल्यू का कोई बयान पहले से किसी फ़ाइल पर मौजूद है जो आप जोड़ना चाहते हैं, कोई भी अनुपलब्ध क्वालिफ़ायर उस मौजूदा बयान में जोड़ दी जाएगी, और अगर निर्दिष्ट किया गया हो तो उसे प्रमुख चिह्नित कर दिया जाएगा। वरना नया बयान जोड़ दिया जाएगा।
डिफ़ॉल्ट से AC/DC "चित्रण" (depicts) के बयानों के लिए एक फ़ील्ड बना देगा, ताकि आप सीधे प्रदर्शित आयटम्स जोड़ सकें, या फिर दूसरे गुणधर्म जोड़ सकें जिनके लिए आप बयान जोड़ना चाहते हों। आप अपने common.js पर window.acdcFavoriteProperties
को कॉन्फ़िगर करके इसे अनुकूलित कर सकते हैं; उदाहरणस्वरूप, depicts (P180), creator (P170) और copyright license (P275) से शुरुआत करने के लिए निम्न कोड जोड़ें:
window.acdcFavoriteProperties = [
'P180',
'P170',
'P275',
];
अगर आप गुणधर्म हमेशा खुद चुनना चाहेंगे, आप इससे डिफ़ॉल्ट गुणधर्म हटा सकते हैं:
window.acdcFavoriteProperties = [];
बयान हटाने के लिए भी प्रारंभिक समर्थन उपलब्ध है। अपने common.js पर window.acdcEnableRemoveFeature = true;
जोड़ने पर, जोड़ने के लिए बयानों के नीचे हटाने के लिए बयानों का एक दूसरा अनुभाग आ जाएगा; सूचीबद्ध फ़ाइलों में से मेल खाने वाले गुणधर्मों और वैल्युओं वाले सभी बयान हटा दिए जाएँगे। (यह सुविधा एक समय पर डिफ़ॉल्ट से सक्षम हो जाएगी, मगर उससे पहले सदस्य इंटरफ़ेस को सुधारना होगा।) उपरोक्त window.acdcFavoriteProperties
, बयानों के दोनों अनुभागों पर साथ में लागू होगा; सिर्फ किसी एक अनुभाग में गुणधर्मों की सूची को संशोधित करने के लिए आप इस बजाय window.acdcFavoritePropertiesToAdd
और window.acdcFavoritePropertiesToRemove
का इस्तेमाल कर सकते हैं।
स्थानीयकरण
सदस्य इंटरफ़ेस के लिए अनुवाद MediaWiki:Gadget-ACDC-i18n.json पर परिभाषित किए जाते हैं। (सिर्फ प्रबंधक और इंटरफ़ेस प्रबंधक ही उस पृष्ठ को सम्पादित कर सकते हैं, तो आपको {{Edit request}} का इस्तेमाल करना और/या विकासक को पिंग करना पड़ सकता है।)
विकास
विकास GitHub पर होता है।
ज्ञात समस्याएँ
साधारणतः यह गैजेट WikibaseMediaInfo के आंतरिक हिस्सों और कार्यान्वयन के विस्तार के बहुत निकट है, और इसलिए यह अनपेक्षित तरीकों से टूट जा सकता है। अगर आपको कुछ गलत महसूस होता है, कृपया जल्द से जल्द विकासक को सूचित करें।
मॉनिटरिंग
१९ सितम्बर २०१९ और उसके बाद इस गैजेट की मदद से किए गए सम्पादनों को "AC/DC" टैग कर दिया गया है; आप उन्हें हाल में हुए बदलावों पर पा सकते हैं। (उस तारीख से पहले ACDC सम्पादनों को खोजने और पहचानने का कोई अच्छा तरीका नहीं था।)
१० फ़रवरी २०२२ से, जब दस या उससे ज़्यादा फ़ाइलें एक साथ सम्पादित की जाती हैं, एक सम्पादन समूह अपने आप बना दिया जाता है। सम्पादन समूह, सम्पादनों के बारे में चर्चा करने, और ज़रूरत पड़े तो उन्हें पूर्ववत करने के लिए एक सुविधाजनक स्थान बनाता है।