راهنما:استفاده از پایتون در ربات‌های ویکی‌پدیا

برای شروع کار با ربات، راهنما:شروع کار با ربات پایتون را ببینید.

قالب ربات‌های ویکی‌پدیا نوشته شده با پیتون (به اختصار pywikipedia) مجموعه‌ای ابزارهای خودکار هستند که در ویکی‌پدیا یا پروژه‌های دیگر مدیاویکی کار می‌کنند. این صفحه اطلاعات کاملی به کسانی که می‌خواهند از نرم‌افزار ربات‌ها استفاده کنند ارائه می‌کند.

نصب

ربات‌های pywikipedia به زبان پیتون نوشته شده‌اند، پس شما نیازمند نصب پایتون هستید. نسخه پایتون نصب شده باید ۲٫۴ یا بالاتر باشد، هر چند بعضی از کدها در نسخه ۲٫۳ نیز ممکن است کار کنند ولی پشتیبانی از نسخه‌های قدیمی پیتون طرح‌ریزی نشده است.

پیتون فعال

پیتون فعال (ActivePython) قابل اجرا شدن در تمامی پایگاه‌های رایج (ویندوز، لینوکس، مک، یونیکس) می‌باشد. برای دریافت نسخه قابل اجرا در سیستم عامل‌های مایکروسافت به اینجا بروید و پس از دریافت آن را نصب (Install) کنید. در سیستم‌عامل‌های یونیکس و شبه یونیکس (مثل لینوکس) و مک معمولاً به طور پیشفرض این برنامه وجود دارد و نیازی به دریافت پیتون برای آن‌ها نیست.

دریافت

راه آسان برای دریافت ربات‌های موجود PyWikipedia استفاده از آخرین انتشار شبانه موجود در این وب سایت است. نسخه‌های قدیمی‌تر را می‌توانید از سورس فورج دریافت کنید. زمانی که شما PyWikipedia را دریافت نمودید، نیازی به نصب ندارد و کافیست آن را از وضعیت فشرده خارج سازید تا قابل استفاده شود.

برای مک این دستورالعمل را دنبال کنید و برای یافتن فایل‌های PyWikipedia از اینجا اقدام نمایید.

دریافت با SVN

شما می‌توانید از اس‌وی‌ان (subversion.tigris.org) برای بازیابی و به روز رسانی نسخه‌های PyWikipediaBot استفاده کنید. اگر کاربر ویندوز هستید TortoiseSVN توصیه می‌شود و برای مک این دستور العمل را دنبال کنید.

پیکر بندی

پیکر بندی برای ویکی‌پدیا

ویرایشگر متن (مثلا NotePad در ویندوز) را باز کنید و یک فایل متنی با عنوان user-config.py در پوشه pywikipedia ذخیره کنید. حال دو خط زیر را در user-config.py وارد کنید:

کد	توضیح
mylang = 'xx'	xx کد زبان پروژه‌ای است که شما در آن فعالیت دارید، مثلا "fa" فارسی است.
usernames['wikipedia']['fa'] = u'ExampleBot'	user-config.py فایل شما به یک شناسه رباتی مشخص نیاز دارد. در این مثال، کاربر در ویکی‌پدیا فارسی کار می‌کند و یک شناسه رباتی با نام کاربری "ExampleBot" ساخته است.
(اختیاری) usernames['wikipedia']['de'] = u'BeispielBot' usernames['wikipedia']['en'] = u'ExampleBot' usernames['wiktionary']['de'] = u'BeispielBot'	(اختیاری) اگر شما در بیشتر از یک پروژه ویکی‌پدیا کار می‌کنید، می‌توانید چند شناسه کاربری دیگر را نیز وارد کنید.

حال دوباره user-config.py را ذخیره کنید.

پیکر بندی برای پروژه‌های دیگر ویکی‌مدیا

سه خط زیر را در user-config.py وارد کنید:

کد	توضیح
mylang = 'xx'	xx کد زبان پروژه‌ای است که شما در آن فعالیت دارید، مثلا "fa" فارسی است.
family = 'sitename'	"Sitename" نام وبگاهی است که در آن فعالیت می‌کنید و می‌تواند wiktionary ,wikibooks ,wikiquote یا حتی پروژه‌ای جز پروژه‌های ویکی‌مدیا مثل wikitravel باشد. (فهرست کامل پروژه‌ها را می‌توانید در pywikipedia/families folder پیدا کنید).
usernames['memoryalpha']['en'] = u'ExampleBot'	user-config.py فایل شما به یک شناسه رباتی مشخص نیاز دارد. برای مثال شما می‌خواهید در Memory Alpha انگلیسی فعالیت کنید و یک حساب ربات با نام کاربری ExampleBot ساخته‌اید.
(فقط برای ویکی‌انبار) mylang = 'commons' family = 'commons' usernames['commons']['commons'] = 'UserBot'	(فقط برای ویکی‌انبار) If you work on Wikimedia Commons, specify commons both as language and as family.

حالا دوباره user-config.py را ذخیره کنید.

اجازه در ویکی پروژه‌ها

از این که ویکی مورد نظر شما ربات را تأیید کند اطمینان حاصل نمایید. البته بستگی به ویکی مورد نظر دارد در بعضی‌ها شما می‌توانید هر کار که خواستید بکنید ولی در موارد دیگر باید در ابتدا اجازه داشته باشید. با استفاده از مرورگر عادی مانند (اینترنت اکسپلور-فایرفاکس- کروم-...)یک کاربر و پسورد برای ربات خود بسازید. سعی کنید از نام‌های مشخص استفاده کنید تا کاربر ربات از انسان متفاوت باشد و همچنین در نام کاربری ربات اسم خودتان را لحاظ کنید تا مشخص باشد که چه کسی هدایت کننده ربات می‌باشد. متداول‌ترین روش افزودن کلمه bot به انتهای اسم کاربری می‌باشد ولی روش‌های دیگری وجود دارد. در ویکی‌پدیا انگلیسی رباتهایی اجازه کار دارند که در این لینک ثبت شده باشند en:Wikipedia:Bots/Requests for approval

در خواست پرچم برای ربات

برای اطلاع از نحوه درخواست پرچم به لینک سیاست رباتیک مراجعه کنید

استفاده

انتخاب و راه اندازی اسکریپت ربات

برای استفاده از کدهای آماده به اینجا مراجعه کنید و برای اسکریپت میان ویکی راهنما روبات میان‌ویکی را مطالعه کنید.

جستارهای وابسته

• راهنمای نصب پای‌ویکی‌بوت در مدیاویکی
• راهنما:شروع کار با ربات پایتون
• راهنما:شروع کار با تول‌سرور
• راهنما روبات میان‌ویکی
• چنانچه برای اعمال تنظیمات به راهنمای بیشتری نیاز دارید به#pywikibot ^اتصال یا pywikipediabot mailing list سر بزنید.

منابع و پانویس

• فراویکی
• آموزش مدیا ویکی https://www.mediawiki.org/wiki/Manual:Pywikibot/fa