Manual:Pywikibot/Installation/fa

  اين صفحه به شما کمک می‌کند که با پای‌ویکی‌بات شروع به کار کنید. آن را می‌توانید بر روی کامپيوتر خودتان، بر روی آزمایشگاه ابزار و یا به صورت یک سرويس وبی اجرا کنيد.

  روی PAWS "PAWS: A Web Shell" ساده ترین راه برای شروع کار با Pywikibot است. به هیچگونه نصبی نیاز ندارد و شما از رابط کاربری وبی برای ارسال دستوراتتان استفاده می‌کنید.

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

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

اگر پایتون از قبل بر روی دستگاه شما نصب شده است، با اجرای  در یک پنجره فرمان اطمينان حاصل کنيد که نسخهٔ شما به اندازهٔ کافی جدید باشد. To discover if Python version 3 or above is installed, run  in a console.

Ubuntu 19.04 and up comes with versions 2 & 3 installed. Python v2 runs by default using terminal command ; to use v3, use terminal command.

If you have installed, your version of Python is recent enough.

On Windows please do not forget to modify PATH environment variable to make Python and pip work properly.

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:

In addition a MediaWiki markup parser is required. Please install (at least) one of them: or or both.

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

Python 2.7 users should download the stable python2 branch: .tar.gz, .zip instead.

این فایل فشرده را درجایی مثل  یا  بگشایید.

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

Other versions are available at https://pywikibot.toolforge.org/.

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

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

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

تنظیم کردن پای‌ویکی‌بات
Open Terminal on Unix-like (Linux/BSD/Solaris) or Command Prompt on Windows (typically under Windows System or Accessories folders in All apps or All programs menu inside the Start menu), and change directory to where you unpacked Pywikibot:


 * Unix-like (Linux/BSD/Solaris):




 * ویندوز:



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

Continue with the following command to generate user configuration file:

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

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

استفاده بر روی ویکی‌های متفرقه
پای‌ویکی‌بات برای ویکی‌های بسیاری از قبل تنظیم شده است، ولی ممکن است در مورد آن ویکی که شما بر روی آن کار می‌کنید اين اتفاق نیافتاده باشد. برای تنظیم پای‌ویکی‌بات برای ویکی خودتان را ببینید

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

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

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

لیستی از تمامی اسکریپت‌ها در قابل دسترس است

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

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

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