راهنما:پای‌ویکی‌بات/نصب

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 48% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Lëtzebuergesch • ‎Nederlands • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎norsk nynorsk • ‎polski • ‎português do Brasil • ‎suomi • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Gnome-system-software-installer.svg
اين صفحه به شما کمک می‌کند که با پای‌ویکی‌بات شروع به کار کنید. آن را می‌توانید بر روی کامپيوتر خودتان، بر روی آزمایشگاه ابزار و یا به صورت یک سرويس وبی اجرا کنيد.
به عنوان سرویس وبی (PAWS)
Unicorn paw logo.svg

اجرای پای‌ویکی‌بات به صورت یک سرویس وبی ساده ترين روش برای شروع کار با آن می‌باشد.

به هیچگونه نصبی نیاز ندارد و شما از رابط کاربری وبی برای ارسال دستوراتتان استفاده می‌کنید.

بر روی رایانهٔ خودتان
Computer n screen.svg

اين صفحه به شما کمک می‌کند که پای‌ویکی‌بات را بر روی رایانهٔ خود نصب و اجرا کنيد. اين فرآیند شامل چهار گام اصلی می‌باشد:

بر روی آزمایشگاه‌های ابزار
Toolforge logo.svg

آزمایشگاه‌های ابزار بستری پابرجا برای شما فراهم می‌کند که بتوانيد رباتها را به شکل مستمر یا برنامه‌ريزی شده اجرا نماييد.

پایتون را نصب کنید

پایتون را از آدرس https://www.python.org/downloads/ دانلود و نصب کنید.

اگر پایتون از قبل بر روی دستگاه شما نصب شده است، با اجرای python --version در یک پنجره فرمان اطمينان حاصل کنيد که نسخهٔ شما به اندازهٔ کافی جدید باشد. اگر نسخهٔ پایتون شما 2.7.4 و بالاتر یا 3.4 و بالاتر می‌باشد، نسخهٔ شما به اندازهٔ کافی به‌روز است. However, Python versions below 3.5 can be dropped in near future. It is strictly recommended to use Python 3.5 or higher.

Modify the path

On Windows systems, even after installing python, the command line interface may not initially know where the python installation is located (although the installer has an option to make it know). In other words, if you enter the command

C:\Users\Joe>python

it may result in the following error:

'python' is not recognized as an internal or external command, operable program or batch file.

To fix this, you need to modify the environment variable named "path" and add the folder which contains "python.exe". On Windows 10, this is under Settings > System > About > System info > Advanced System Settings > Environment Variables. Closing and re-opening the command line, entering "python" should give some information about your current python installation. This same process can be repeated for pip. If you enter the command

C:\Users\Joe>pip

and it displays an error, also add the folder containing "pip.exe" to the path.

Install dependencies

An additional package named requests is required to run Pywikibot. Use pip, which is already installed if you have Python 2.7.9 or higher, or Python 3.4 or higher. Run the following command to install this package:

$ pip install requests

دانلود پای‌ویکی‌بات

دانلود پای‌ویکی‌بات stable branch: .tar.gz, .zip.

این فایل فشرده را درجایی مثل /home/username/pywikibot یاc:\users\username\pywikibot بگشایید.

Alternatively, you may retrieve the latest version using git or svn client from Gerrit, see Manual:Pywikibot/Gerrit#For users . This is the recommended way for active bot operators and developers to use Pywikibot.

Other versions are available at https://tools.wmflabs.org/pywikibot/.

به‌روزرسانی پای‌ویکی‌بات

نسخه‌های پایدار حدوداً هر سه ماه یک بار منتشر می‌شوند و از همانجا قابل دسترس می‌باشند

قبل از نصب آن، از فایل‌های تنظیمات و اسکریپت‌ها (user-config.py، هرگونه پروندهٔ فامیلی , اسکریپت‌های سفارشی شده و هر گونه فایل های دامپ اکس‌ام‌ال‌ که برای یک ويکی استفاده می‌کنید) نسخهٔ پشتیبان تهیه کنید.

پروندهٔ فشردهٔ نسخهٔ جدید را در محل نسخهٔ قبلی بگشایید، به شکلی که تمام پرونده‌ها بازنویسی شوند.

تنظیم کردن پای‌ویکی‌بات

یک پنجرهٔ ترمینال باز کنید و مسیر جاری خود را به محلی که پروندهٔ فشرده را گشوده‌اید تغيير دهید.

لینوکس: برنامهٔ 'Terminal' را باز کنید(معمولاً در منو در بخش 'System Tools' ) سپس دستور زیر را اجرا نماييد:
$ cd ~/pywikibot
ویندوز:
$ c:
$ cd "\Users\username\pywikibot"

صد البته با جایگزينی مسیری که شما فایل فشردهٔ پای‌ویکی‌بات را در آن گشوده‌اید

Continue with the following command to generate user configuration file:

$ python pwb.py generate_user_files

اعلان‌ها را برای پرای تنظيمات پای‌ویکی‌بات دنبال کنید، پس از پرکردن گذرواژه، شما به سامانه وارده خواهید شد.

Finally run the following command to log in to your wiki:

$ python pwb.py login

استفاده بر روی ویکی‌های متفرقه

پای‌ویکی‌بات برای ویکی‌های بسیاری از قبل تنظیم شده است، ولی ممکن است در مورد آن ویکی که شما بر روی آن کار می‌کنید اين اتفاق نیافتاده باشد. برای تنظیم پای‌ویکی‌بات برای ویکی خودتان Manual:Pywikibot/Use on third-party wikis را ببینید

تنظیمات بیشتر

پای‌ویکی‌بات طیف وسیعی از گرینه‌های تنظیماتی را برای تغيير رفتارهای ربات شما در دسترس قرار می‌دهد شما می توانیداینتنظیمات را در پروندهٔ 'user-config.py' تغِِر دهید. برای مشاهدهٔ تمام پارامترهایی که می‌توانید استفاده کنید، config2.py را ببينید

Proxy configuration

Pywikibot relies on requests for communicating with the web. You can use HTTP_PROXY and HTTPS_PROXY environment variables to make requests use a proxy server. Refer to requests' documentation for more info.

اجرای اسکریپت

پای‌ویکی‌بات همراه با انبوهی از اسکریپت‌ها در پوشهٔ scripts بسته بندی شده است می‌توانید تمام آنها را اجرا کنید با استفاده از

$ python pwb.py [name of the script]

لیستی از تمامی اسکریپت‌ها در Manual:Pywikibot/Scripts قابل دسترس است

وابستگی‌ها

اکثر اسکریپت‌ها به بسته‌های نرم‌افزاری دیگری برای اجرا نیاز ندارند،لیکن اسکریپت‌هایی هم وجود دارند که بدون بسته‌های اضافی کار نخواهند کرد.

اینها در بخش requirements.txt لیست شده‌اند

برای نصب وابستگی‌ها از $pip استفاده کنید، چراکه در صورت به‌روز بودن نسخهٔ پایتون خود این ابزار برای شما نصب شده است. دستورهای زیر را برای نصب بسته‌ها اجرا کنید:

$ pip install [name of the package]

یا دستور زیر برای نصب کلیهٔ بسته‌های پیشنهادی:

$ pip install -r requirements.txt


If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel connect or pywikibot@ mailing list.