دليل:باي ويكي بوت/إنشاء نصك البرمجي الخاص

هذا الصفحة تُدرج بعض النصائح البسيطة للغاية للبدء في كتابة البوت الخاص بك. تأكد أنك قد أعددت ملف user-config.py الخاص بك.

يمكنك إما استخدام الأوامر التالية في قشرة (Shell) أو في نص برمجي.

لفتح القشرة، قم بتشغيل python pwb.py shell؛

بما أنه نص برمجي، من فضلك احفظ الملف بصيغة myscript.py في مجلد scripts/userscripts/، ثم قم بتشغيل python pwb.py myscript.

• للوصول إلى مكتبة باي ويكي بوت من نص بايثون، استخدم:

import pywikibot

• للحصول على صفحة، استخدم الآتي، حيث أن pageName هو عنوان الصفحة التي تريد الحصول عليها، مثل ويكيبيديا:بوت أو الهند:

site = pywikibot.Site()
page = pywikibot.Page(site, "pageName")
text = page.text

• لتحديث صفحة، استخدم:

page.text = "newText"
page.save("Edit comment")

• اطلع على بعض ملف باي ويكي بوت لأفكار أخرى -- scripts/basic.py سهل القراءة نسبيًا حتى إن كنت جديدًا في باي ويكي بوت.
• يمكنك إيجاد كل دوال الصفحات المتاحة في ملف pywikibot/page.py.
• basic.py يمنحك إعدادًا يمكن استخدامه لمختلف البوتات، كل ما عليك فعله هو تعريف التعديل النصي على نص الصفحة.
• لتستخدم التكرار على مجموعة صفحات، انظر pywikibot/pagegenerators.py (انظر أيضًا التوثيق القديم) لبعض الكائنات التي تعود بمجموعة صفحات. مثال استخدام على مولد تصنيف الصفحات (CategoryPageGenerator) الذي يقوم بشيء ما على كل صفحة في تصنيف:أشخاص على قيد الحياة:

import pywikibot
from pywikibot import pagegenerators
site = pywikibot.Site()
cat = pywikibot.Category(site,'Category:Living people')
gen = pagegenerators.CategorizedPageGenerator(cat)
for page in gen:
    #Do something with the page object, for example:
    text = page.text

انظر أيضا

• Pywikibot full documentation on doc.wikimedia.org
• wikigraphviz - example of using Pywikibot with https://graphviz.org/
• How to write a basic script via Pywikibot - a small wiki toolkits workshop
• Manual:Pywikibot/Cookbook

لو كنت بحاجة لمساعدة في إعداد بوت Pywikibot الخاص بك، يرجى زيارة قناة #pywikibot على آي آر سي ^تواصل أو القائمة البريدية pywikibot@.