افتح القائمة الرئيسية

مساعدة:الشروع في العمل مع بوت بايثون

للبدء في العمل ببوت بايثون علیك إجراء المراحل التالیة.

فی البدایة علیك إنشاء حساب خاص ببوتك واسم هذا الحساب لابد أن ینتهي بكلمة بوت مثل: عبد الله بوت أو Bot مثلاَ ElphiBot أو MenoBot.


شرح بالفيديو مدته 7 دقائق. (يُنصح بالمشاهدة بكامل الشاشة واختيار جودة عالية)

مستلزمات (الخطوة الأولی)عدل

  • إذا كنت تستخدم نظام تشغيل ويندوز اتبع ما يلي
  • تثبیت بايثون Python :
تحمیل بایثون 2.7.8 إذا كنت تريد استخدام كودات compat القديمة.
تحمیل بایثون 3.4.2 إذا كنت تريد استخدام كودات core الجديدة.
  • تحمیل الكودات :
compat (قديمة): التنزيل من هنا (متوافقة Python 2).
core (الجديدة):

قم بفك ضغط الملف واستخراج محتوياته إلى مجلد حسب اختيارك (علی سبیل المثال E:\core)

  • إعداد ملف User-config.py :
في المجلد (folder) الذي وضعت فيه الكودات (علی سبیل المثال E:\core) ستجد ملف User-config.py افتحه واكتب بداخله
family = 'wikipedia'
mylang = 'ar'
usernames['wikipedia'] ['ar'] = u'YourBot'
console_encoding = 'utf-8'

YourBot ضع مكانه اسم المستخدم الخاص ببوتك (علی سبیل المثال: ElphiBot)

إذا لم يكن ملف User-config.py موجود مسبقاً، أنشئ ملف (file) جدید بصیغة نص (txt) ثم احفظ الملف باسم User-config.py بترميز UTF-8

انتبه
1. لا تضع فواصل (Space) قبل وبعد YourBot لأنه في هذه الحالة البوت سيطلب منك كلمة السر لكل تحریر
2. في حال حصولك علی علم بوت في ویكي أخری علیك أن تضیف اسم الویكي لملف User-config.py بالشكل التالي :

family = 'wikipedia'
mylang = 'ar'
usernames['wikipedia'] ['ar'] = u'YourBot'
usernames['wikipedia'] ['en'] = u'YourBot'
usernames['wikidata'] ['wikidata'] = u'YourBot'  # للعمل على ويكي بيانات
console_encoding = 'utf-8'

في هذا المثال البوت سيجري تعديلات فی ویكي العربیة والإنجلیزیة.

  • إذا كنت تستخدم إحدى توزيعات لينكس فقط عليك تحميل الكودات وإعداد ملف user-config.py كما في الأعلى
  • تثبیت برنامج ++Notepad :
تحمیل notepad++ هذا البرنامج محرر مفید للعمل بكودات ويكيبيديا لأن هذا البرنامج یدعم الترميز Encoding) UTF-8)

(في المراحل الأولی وقبل أن یكتسب المستخدم خبرة عالیة لا حاجة لتحریر وتعدیل الكود)

الخطوة الثانیةعدل

بعد ما حملت الكودات في الخطوة الأولى ووضعتها في مجلد خاص بها (علی سبیل المثال E:\core) علیك إنشاء طریق للتحكم بها.
اذهب إلی المجلد الخاص بالبوت علی جهازك (علی سبیل المثال E:\core) وبواسطة الزر الأیمن للفارة أنشی shortcut.
ستواجه هناك type the location of the item علی الشاشة
اكتب بها cmd.exe واضغط علی الNext
في الصفحة الثانیة اختار اسم لهذا الshortcut علی سبیل المثال:My Robot CMD واضغط علی الFinish.
اضغط الزر الأیمن علی الshortcut ومن قسم PROPERTIES اذهب إلی قسم shortcut
ستری هناك كادر مكتوب مقابله start in:
بعدما وجدته احذف ٪windir٪ واكتبه عنوان المجلد الخاص ببوتك علی جهازك الخاص (علی سبیل المثال E:\core)
ثم اضغط علی OK للفعيل

ستری هذه الصورة أو مایشبهها :

18px My Robot CMD

الخطوة الثالثة والأخیرةعدل

هنا علیك أن تتأكد من ان لدیك ملف user-config.py الخاص بك. بعدما تأكدت من صنع الملف علی الشكل الصحیح افتح الshortcut الذي صنعته فی الخطوة الثانیة واكتب في سطر الأوامر ما تراه فی الصورة التالیة :

18px My Robot CMD

سیطلب منك إدخال كلمة السر الخاصة ببوتك. بعدما أدخلت كلمة السر وضغطت علی مفتاح الإنتر یتم إعلان دخولك. لتجربة بوتك جرب بوت التجريب. بعدما تأكدت من صحة البوت أوقفه واذهب لصفحة طلب صلاحية بوت وتقدم بطلب.
تنبیه هام
لا تشغل بوتك بدون الحصول علی صلاحية بوت لأن أحد الإداریین سیقوم بمنع بوتك

الروبوتات التقلیدیةعدل

روبوتات بایویكيبيدیا التقلیدیةعدل

یوجد ما یقارب ثلاثون كود روبوت في الملف الذي قمت بتحميله في الخطوات السابقة ومن تلك البوتات تم اختیار القائمة الآتیة في الأسفل نظراً لسهولة التحكم وكثرة الاستعمال. لمزید من المعلومات یمكنك فتح ملف البوت (الكود) بـ Notepad++ أو IDLE وقراءة الدلیل الموجود فی بدایة الملف. وأیضاً یمكن كتابة اسم البوت -help في الCMD. مثلاً لمعرفة welcome.py نكتب welcome.py -help

تنبيه: لمشاهدة قائمة البوتات الكاملة راجع

هنا. في تلك الصفحة بعض البوتات تملك صفحة توضیح خاصة بنفسها

اسم البوت اسم الملف توضیح نموذج
الدخول إلى ویكیبيدیا login.py یستعمل هذا البوت للدخول عبر حساب البوت فی ویكیبيدیا عند كتابة كلمة السر لایظهر شیئاً علی الشاشة. بعد كتابة كلمة السر والضغط علی زر Enter یتم تسجیل الدخول
بوت الترحیب welcome.py یستعمل هذا البوت للترحیب بالمستخدمین الجدد
بوت التصنیف category.py یستعمل هذا البوت للتعامل مع التصنيفات الدليل باللغة العربية

الدليل باللغة الإنجليزية

نقل المقالات move.py هذا البوت ینقل المقالات من اسم إلی اسم آخر
بوت الاستبدال replace.py یستبدل هذا البوت كلمة بكلمة أخری replace.py "He" "She" لاستبدال كلمات مثل الـ he بالـ she.
إنترويكي interwiki.py إضافة، إصلاح، حذف و...وصلات الإنترویكي هي مهمة هذا البوت FAQ بالإنجليزية
commons_link.py commons_link.py هذا البوت یضیف وصلة كومنز إلی المقالات التي یوجد موضوع عنها في كومنز
add_text.py add_text.py هذا البوت یضیف نصوص إلى المقالات الدليل هنا باللغة العربية
فاحص وصلات الويب weblinkchecker.py إيجاد الوصلات الخارجية المكسورة الدليل باللغة العربية
الإصدار version.py إيجاد رقم إصدار البايثون وكودات Pywikibot فقط اكتب version.py واضغط إنتر سيظهر الإصدار
صفحات يتيمة lonelypages.py إضافة قالب يتيمة للصفحات اليتيمة أكتب lonelypages.py سيبدأ البحث، أكتب y للموافقة على إضافة القالب للصفحة الحالية وn لتخطيها وa لإضافة القالب لكل الصفحات دون سؤالك مرة أخرى

ملاحظات ونصائحعدل

  • لتشفير وفك تشفير النص العربي استخدم هذه الصفحة هنا.
  • لجعل البوت يقوم بمحاكاة تنفيذ أمر دون عمل تغييرات فعلية أضف التالي للأمر (الأمر قد لا يكون مدعوم من كل البوتات) :
 -simulate

بديل لموجه الأوامرعدل

 
برنامج ConEmu أثناء تنفيذ أحد أوامر البوت
  • برنامج ConEmu أحد البرامج المجانية البديلة لموجه الأوامر الخاص بالويندوز، يتميز بإمكانية إخراج النص العربي بشكل مقروء أثناء تنفيذ الأوامر بالإضافة للتبويبات المتعددة (كما في الصورة المرفقة)، يمكن تحمله من هذه الصفحة.

(إذا أردت استخدامه فقط قم بتغيير مسار الهدف أثناء خطوة إنشاء الاختصار من cmd.exe إلى C:\Program Files\ConEmu\ConEmu.exe ).

استخدام httpsعدل

لجعل البوت يستخدم اتصال https الآمن بدلاً من اتصال http العادي، نضيف السطر التالي إلى ملف User-config.py

SSL_connection = True

مشاكل Windowsعدل

  • إذا ظهرت رسالة التحذير هذه "WARNING: Running on Windows and transliteration_target is not set.

Please see http://www.mediawiki.org/wiki/Manual:Pywikibot/Windows" أكتب هذا النص "transliteration_target = None" في آخر سطر في ملف User-config.py.

  • إذا ظهرت مشاكل في تنسيقات الأحرف العربية وفي الفارسية أيضاً تظهر أكتب الرمز "MBCS" بدلاً من "UTF-8".
  • في ويندوز لن تحتاج كتابة python قبل اسم السكريبت وممكن نسخ ملف python من مجلد pyhton27 في (:C) ولصقه في مجلد compat.

أنظر أيضاًعدل