مساعدة:الشروع في العمل مع بوت بايثون
 | محتوى هذه المقالة بحاجة للتحديث. |
| السیاسات |  | |
|---|---|---|
| تعریف | ||
| التعلیمات | ||
| الطلبات | ||
| البوتات | ||
| بوتات إدارية | ||
| بوتات إحصائية | ||
| المتفرقات |
للبدء في العمل ببوت بايثون علیك إجراء المراحل التالیة.
فی البدایة علیك إنشاء حساب خاص ببوتك واسم هذا الحساب لابد أن ینتهي بكلمة بوت مثل: عبد الله بوت أو Bot مثلاَ ElphiBot أو MenoBot.
مستلزمات (الخطوة الأولی)
عدل- إذا كنت تستخدم نظام تشغيل ويندوز اتبع ما يلي
- تثبیت بايثون Python :
- تحمیل الكودات : من هنا.tar.gz أو .zip (وهي متوافقة مع Python 3.3 وPython 3.4 راجع هذه الصفحة)
قم بفك ضغط الملف واستخراج محتوياته إلى مجلد حسب اختيارك (علی سبیل المثال 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 للفعيل
ستری هذه الصورة أو مایشبهها :
Microsoft Windows XP [Version *.*.*] <C> Copyright 1985-2001 Microsoft Corp. E:\core> _
الخطوة الثالثة والأخیرة
عدلهنا علیك أن تتأكد من ان لدیك ملف user-config.py الخاص بك. بعدما تأكدت من صنع الملف علی الشكل الصحیح افتح الshortcut الذي صنعته فی الخطوة الثانیة واكتب في سطر الأوامر ما تراه فی الصورة التالیة :
Microsoft Windows XP [Version *.*.*]
<C> Copyright 1985-2001 Microsoft Corp.
E:\core>login.py _
سیطلب منك إدخال كلمة السر الخاصة ببوتك. بعدما أدخلت كلمة السر وضغطت علی مفتاح الإنتر یتم إعلان دخولك. لتجربة بوتك جرب بوت التجريب. بعدما تأكدت من صحة البوت أوقفه واذهب لصفحة طلب صلاحية بوت وتقدم بطلب.
تنبیه هام
لا تشغل بوتك بدون الحصول علی صلاحية بوت لأن أحد الإداریین سیقوم بمنع بوتك
الروبوتات التقلیدیة
عدلروبوتات بایویكيبيدیا التقلیدیة
عدلیوجد ما یقارب ثلاثون كود روبوت في الملف الذي قمت بتحميله في الخطوات السابقة ومن تلك البوتات تم اختیار القائمة الآتیة في الأسفل نظراً لسهولة التحكم وكثرة الاستعمال. لمزید من المعلومات یمكنك فتح ملف البوت (الكود) بـ 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 أحد البرامج المجانية البديلة لموجه الأوامر الخاص بالويندوز، يتميز بإمكانية إخراج النص العربي بشكل مقروء أثناء تنفيذ الأوامر بالإضافة للتبويبات المتعددة (كما في الصورة المرفقة)، يمكن تحمله من هذه الصفحة.
(إذا أردت استخدامه فقط قم بتغيير مسار الهدف أثناء خطوة إنشاء الاختصار من cmd.exe إلى C:\Program Files\ConEmu\ConEmu.exe ).
- برنامج WinSCP يمكنك تحميله من موقعه الرسمي.
استخدام 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.