मैन्युअल:Pywikibot/स्थापना

From mediawiki.org
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 80% complete.
Outdated translations are marked like this.
इस पृष्ठ पर आप अपने कंप्यूटर पर, Toolforge पर, या फिर PAWS: A Web Shell पर, Pywikibot के साथ शुरुआत करने में मदद मिलेगी।
PAWS पर

PAWS: A Web Shell, Pywikibot के साथ शुरुआत करने का सबसे आसान तरीका है। कुछ भी स्थापित करने की ज़रूरत नहीं, और आपको कमांड्स प्रस्तुत करने के लिए एक वेब इंटरफ़ेस का इस्तेमाल करना होगा।

अपने कंप्यूटर पर

नीचे अपने कंप्यूटर पर Pywikibot को सेटअप करने में मदद के लिए एक मैन्युअल है। इस प्रक्रिया में चार मुख्य चरण हैं:

Toolforge पर

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.7 या अधिक की ज़रूरत होती है। Windows पर Python और pip के ठीक से चलने के लिए कृपया PATH पर्यावरण वेरिएबल को बदलना न भूलें।

निर्भरताएँ स्थापित करें

Additional packages are required to run Pywikibot. Run the following command to install these packages:

$ python -m pip install "requests>=2.20.1"
$ python -m pip install "mwparserfromhell>=0.5.2"
$ python -m pip install packaging

For Python 3.7 an additional package is required. Install it with:

$ python -m pip install importlib_metadata

An alternate MediaWiki markup parser may be installed with:

$ python -m pip install "wikitextparser>=0.47.5"

See also https://doc.wikimedia.org/pywikibot/stable/introduction.html#quick-start

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 में या %USERPROFILE%\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 "%USERPROFILE%\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:

सभी स्क्रिप्टों की सूची $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.