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

mw:Manual:Pywikibot/ar
هذه الصفحة تحويلة لينة.

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

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

أنشئ حسابًا جديدًا الآن

(تسجيل آمن)

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

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

• إذا كنت تستخدم نظام تشغيل ويندوز اتبع ما يلي
• تثبیت بايثون Python :

تحمیل بایثون 3.4.2.

• تحمیل الكودات : من هنا.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 للفعيل

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

 ملف:Cmd icon.png My Robot CMD

Microsoft Windows XP [Version *.*.*]
<C> Copyright 1985-2001 Microsoft Corp.
E:\core> _

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

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

 ملف:Cmd icon.png My Robot CMD

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 أثناء تنفيذ أحد أوامر البوت

• برنامج 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.

انظر أيضًا

• بعض أوامر تشغيل لبوت البايثون سايفربوت
• بعض الأوامر لبوت البايثون على ميدياويكي
• صفحة تنزيل أحدث نسخة من Pywikibot