Manual:Pywikibot/Installation/ar

 هذه الصفحة ستساعدك للبدء مع باي ويكي بوت، إما على حاسوبك أو على تولفورج أو باستخدام PAWS: قشرة ويب

  في PAWS PAWS: قشرة ويب هي الطريقة الأسهل لبدء باي ويكي بوت. التثبيت غير ضروري، واستخدم واجهة الويب لإرسال الأوامر.

 في حاسوبك الشخصي الدليل بالأدنى هو للمساعدة في ضبط باي ويكي بوت وتشغيله على حاسوبك الخاص. هناك أربع خطوات رئيسية لهذه العملية:  على تولفورج Toolforge يوفر لك بنية تحتية خدمية مستقرة على خوادم ويكيميديا تسمح لك بتشغيل بوتات باستمرار أو بجدول زمني.
 * تثبيت بايثون
 * تثبيت باي ويكي بوت
 * إعداد الباي ويكي بوت
 * تشغيل السكريبتات

تثبيت بايثون
تنزيل و تتبيث بايثون من https://www.python.org/downloads/

إن كان بايثون مُثبَّتا بالفعل عندك، تحقق إذا كان الإصدار حديثًا باستخدام  في وحدة تحكم. إن كانت لديك بايثون 2.7.4 أو أعلى، أو بايثون 3.4 أو أعلى، إصدار البايثون لديك هو حديث كفاية. مع ذلك، فإن إصدارات بايثون أدنى من 3.5 قد تُلغَى في المستقبل القريب. من الموصى به بشدة هو استخدام بايثون 3.5 أو أعلى.

على ويندوز لا تنسَ تعديل متغيرات بيئة PATH لجعل بايثون وأمر pip أن يعملا كما ينبغي.

تثبيت التبعيات
حِزمة إضافية تسمى "requests" مطلوبة لتشغيل باي ويكي بوت. استخدم pip، وهي مثبتة مسبقًا إن كان لديك بايثون 2.7.9 أو أعلى، أو بايثون 3.4 أو أعلى. اكتب الأمر التالي لتثبيت هذه الحزمة:

تثبيت باي ويكي بوت
قم بتحميل باي ويكي بوت الحالي stable branch: .tar.gz، .zip.

قم بفك الملف المُحمَّل، على سبيل المثال في  أو.

بدلاً من ذلك، يمكنك الحصول على الإصدار الأخير باستخدام عميل git أو svn من غيريت، انظر. هذه هي الطريقة الموصى بها لمشغلي البوت النشطين والمطورين لاستخدام باي ويكي بوت.

إصدارات أخرى متاحة في https://tools.wmflabs.org/pywikibot/.

تحديث باي ويكي بوت
قم بتحديث هيكل البوت باستمرار. إصدارات جديدة تصدر باستمرار، ومتاحة في نفس المكان.

إن كنت تستخدم إصدار git أو svn، يمكنك تخطي هذه الملحوظة. وخلاف ذلك من فضلك كن على علم بضرورة بعمل نسخة احتياطية من ملفات الإعداد الخاصة بك والأكواد (user-config.py أو أي ملف عائلة أو كود مخصص قد قمت بإنشائه أو تعديله وأي ملف XML مهمل حالي أنت تستخدمه لويكي) قبل تثبيت إصدار جديد.

قم بفك النسخة الجديدة في مجلد النسخة القديمة، مستبدلاً كل الملفات.

إعداد باي ويكي بوت
افتح "الطرفية" على أنظمة يونكس (لينكس/بي إس دي/سولاريس) أو "موجه الأوامر" على ويندوز (عادةً في مجلدي "نظام النوافذ" أو "البرامج الملحقة" في قائمة "كل التطبيقات" أو "كل البرامج" بداخل قائمة ابدأ) وقم بتغيير المجلد إلى حيث قمت بفك باي ويكي بوت:


 * شبيه يونكس (لينكس/بي إس دي/سولاريس):




 * ويندوز:



Of course substitute the location to where you unpacked Pywikibot.

Continue with the following command to generate user configuration file:

Follow the prompts to configure Pywikibot.

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

الاستخدام على مواقع ويكي أخرى
Pywikibot is pre-configured for a large number of wikis, but possibly not for the one you want to work on. انظر لكيفية إعداد باي ويكي بوت لموقع الويكي الخاص بك.

المزيد من الإعدادات
Pywikibot provides a wide range of configuration options to change the behavior of your bot. You can change these settings in the file user-config.py. See config2.py for a list of all parameters you can use.

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.

تشغيل سكريبت
Pywikibot comes packaged with a large number of scripts in the scripts directory. You can run all of these using:

A list of all scripts is available at.

مشروعات أخرى
Most scripts do not require additional packages, but a few of them will not work without. These are listed in requirements.txt together with their dependencies.

To install dependencies for some script, use pip, and run the following command:

Alternatively, run the following command to install all dependencies for all scripts at once: