मैन्युअल:Pywikibot/स्थापना
नीचे अपने कंप्यूटर पर Pywikibot को सेटअप करने में मदद के लिए एक मैन्युअल है। इस प्रक्रिया में चार मुख्य चरण हैं:
Toolforge की मदद से आपको विकिमीडिया सर्वरों पर एक स्थिर क्लाउड कम्प्यूटिंग अर्थव्यवस्था प्राप्त होती है जिससे आप बॉट्स को निरंतर या फिर एक अनुसूची के अनुसार चला सकते हैं।
Python स्थापित करें
https://www.python.org/downloads/ से Python डाउनलोड और स्थापित करें।
अगर आपने पहले से ही Python को स्थापित किया हुआ है, कंसोल में python --version चलाकर जाँचें कि आपका संस्करण नवीनतम है या नहीं।
To discover if Python version 3 or above is installed, run python3 --version in a console.
Ubuntu 19.04 and up comes with versions 2 & 3 installed.
Python v2 runs by default using terminal command python; to use v3, use terminal command python3.
इस समय बॉट को चलाने के लिए Python 3.6.1 या अधिक की आवश्यकता है, मगर Python 3.7 या अधिक अनुशंसित है। Windows पर Python और pip के ठीक से चलने के लिए कृपया PATH पर्यावरण वेरिएबल को बदलना न भूलें।
निर्भरताएँ स्थापित करें
Pywikibot को चलाने के लिए 'requests' नामक एक अतिरिक्त पैकेज की ज़रूरत होती है। pip का इस्तेमाल करें जिसे डिफ़ॉल्ट से Python के सभी संस्करणों में शामिल किया जाता है। इस पैकेज को स्थापित करने के लिए निम्न कमांड चलाएँ:
$ python -m pip install "requests>=2.20.1"
साथ में एक मीडियाविकि मार्कअप पार्सर की ज़रूरत है। कृपया (कम-से-कम) इनमें से एक (या फिर दोनों) स्थापित करें:[1]
$ python -m pip install "mwparserfromhell>=0.5.0"
$ python -m pip install "wikitextparser>=0.47.5"
Pywikibot स्थापित करें
$ python -m pip install pywikibot
If using pip, use pwb instead of python pwb.py in examples below.
वर्तमान Pywikibot stable शाखा डाउनलोड करें: .tar.gz, .zip।
डाउनलोड की गई फ़ाइल को अनपैक करें, जैसे ~/pywikibot में या C:\Users\username\pywikibot में।
वैकल्पिक रूप से, आप Gerrit से गिट या SVN क्लाइंट की मदद से नवीनतम संस्करण प्राप्त कर सकते हैं। Manual:Pywikibot/Gerrit देखें। यह सक्रिय बॉट ऑपरेटर्स और विकासकों के लिए Pywikibot को चलाने का अनुशंसित तरीका है।
दूसरे संस्करण https://pywikibot.toolforge.org/ पर उपलब्ध हैं।
Pywikibot को अपडेट करना
अपने बॉट फ़्रेमवर्क को अद्यत रखें। नए संस्करण निरंतर प्रकाशित किए जाते हैं, और उसी जगह से उपलब्ध होते हैं।
अगर आप गिट या SVN प्रकाशन का इस्तेमाल कर रहे हैं, आप इस टिप्पणी को छोड़ सकते हैं। वरना कृपया ध्यान रखें कि आपको नया प्रकाशन स्थापित करने से पहले अपने कॉन्फ़िगरेशन फ़ाइलों (user-config.py, या कोई पारिवारिक फ़ाइल, या अनुकूलित स्क्रिप्ट जिसे आपने बनाया या बदला हो, और कोई भी वर्तमान XML डम्प फ़ाइल जिसका आप किसी विकि के लिए इस्तेमाल कर रहे हों) को बैकअप करना होगा।
नए संस्करण को पुराने संस्करण की जगह पर अनपैक करें, जिससे सभी फ़ाइलों को ओवर्राइड कर दिया जाएगा।
Pywikibot को कॉन्फ़िगर करें
Unix जैसी सिस्टम्स (Linux/BSD/Solaris) पर टर्मिनल खोलें या फिर Windows पर Command Prompt (आप तौर पर स्टार्ट मेन्यू के अंदर All apps या All programs मेन्यू के Windows System या Accessories फ़ोल्डर में), और डिरेक्ट्री को उसमें बदलें जहाँ आपने Pywikibot को अनपैक किया था:
- Unix जैसी (Linux/BSD/Solaris):
$ cd ~/core
- Windows:
$ c: $ cd "\Users\username\pywikibot"
बेशक, आपको जगह को उसमें बदलना होगा जहाँ आपने Pywikibot को अनपैक किया था।
सदस्य कॉन्फ़िगरेशन फ़ाइल जनरेट करने के लिए यह कमांड चलाएँ:
$ python pwb.py generate_user_files
Pywikibot स्थापित करने के लिए अनुदेशों का पालन करें।
आखिर में, अपने विकि पर लॉग-इन करने के लिए यह कमांड चलाएँ:
$ python pwb.py login
तृतीयृ-पक्ष विकियों पर इस्तेमाल
Pywikibot को कई सारे विकियों के लिए पहले से कॉन्फ़िगर किया जा चुका है, मगर ऐसा भी हो सकता है कि वह विकि उपलब्ध न हो जिसपर आप काम करना चाहते हों। अपने विकि के लिए Pywikibot को कॉन्फ़िगर करने के बारे में जानकारी के लिए Manual:Pywikibot/Use on third-party wikis देखें।
अधिक कॉन्फ़िगरेशन विकल्प
Pywikibot पर अपने बॉट के स्वभाव को बदलने के लिए कई कॉन्फ़िगरेशन विकल्प उपलब्ध हैं। आप इन सेटिंग्स को user-config.py फ़ाइल में बदल सकते हैं। उन सभी पैरामीटर्स की सूची के लिए config.py देखें जिनका आप इस्तेमाल कर सकते हैं।
प्रॉक्सी कॉन्फ़िगरेशन
Pywikibot वेब से बातचीत करने के लिए requests पर निर्भर होता है।
आप एक प्रॉक्सी सर्वर के ज़रिए अनुरोध करने के लिए HTTP_PROXY और HTTPS_PROXY पर्यावरण वेरिएबलों का इस्तेमाल कर सकते हैं।
अधिक जानकारी के लिए अनुरोध प्रलेख पढ़ें।
स्क्रिप्ट चलाएँ
Pywikibot पर scripts डिरेक्ट्री में पहले से ही कई स्क्रिप्ट्स मौजूद होते हैं। आप इन सभी को इसकी मदद से चला सकते हैं:
$ python pwb.py [name of the script]
To learn more about running basic Pywikibot scripts, see:
- Small wiki toolkits workshop about running basic Pywikibot scripts
- Self-study materials based on the small wiki toolkits workshop
- Workshop handbook based on the small wiki toolkits workshop
सभी स्क्रिप्टों की सूची $scripts पर उपलब्ध है।
दूसरी निर्भरताएँ
ज़्यादातर स्क्रिप्टों पर अतिरिक्त पैकेजेस की ज़रूरत नहीं होती, मगर कुछ स्क्रिप्ट अतिरिक्त पैकेजेस के बिना काम नहीं करेंगे। इन्हें requirements.txt पर उनकी निर्भरताओं के साथ सूचीबद्ध किया गया है।
किसी स्क्रिप्ट के लिए निर्भरताएँ स्थापित करने के लिए pip का इस्तेमाल करें और यह कमांड चलाएँ:
$ python -m pip install [name of the package]
वैकल्पिक रूप से, सभी स्क्रिप्टों के लिए सभी निर्भरताओं को एक साथ स्थापित करने के लिए यह कमांड चलाएँ:
$ python -m pip install -r requirements.txt
- If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel जुड़ें or pywikibot@ mailing list.