راهنما:شروع کار با ربات پایتون: تفاوت میان نسخه‌ها

محتوای حذف‌شده محتوای افزوده‌شده
جز ←‏جایگزینی با [[وپ:اشتباه|اشتباه‌یاب]]: ویک‌پدیا⟸ویکی‌پدیا، تجربه‌در⟸تجربه‌ در، دخیره⟸ذخیره، ناوبالکس⟸ناوباکس، ورورد⟸ورود، ونصبی⟸...
خط ۱۶:
تذکر: برای آگاهی از آخرین تغییرات بر روی این فریم‌ورک و راهنماهای نوشته شده توسط توسعه دهندگان پای‌ویکی‌بات همیشه می‌توانید به سایت پروژه [https://www.mediawiki.org/wiki/Manual:Pywikibot پای‌ویکی‌بات] مراجعه کنید.
 
'''تذکر مهم''': '''به روز بودن ربات''' در اجرای ربات‌های دیگران و یا ربات‌های خود پروژه پای‌ویکی‌بات نکته بسیار مهمی است واگر از به روز بودن آن اطلاع ندارید از نویسنده ربات و یا [[ویکی‌پدیا:فهرست مدیران|مدیران ویکی‌پدیا]] که تجربه‌درتجربه‌ در اجرای ربات‌ها دارند در صفحه بحثشان سؤال بفرمایید. به عنوان مثال ربات خوشامدگویی که در گام سوم نام برده شده و از ربات‌های اصلی پروژه پای‌ویکی‌بات است به روز نیست و [[ویکی‌پدیا:ربات/خوش‌آمدگویی|نسخه‌های به روزآن]] توسط کاربران ربات‌ران نوشته شده‌است. در صورت به روز نبودن ربات ممکن است ویرایش‌هایش [[ویکی‌پدیا:خرابکاری|خرابکاری]] تلقی شده و دسترسی ربات بسته شود.
 
تذکر: در بسیاری از موارد نیازی به نوشتن ربات جدید نیست و می‌توان ویرایش‌های مورد نظر از [[راهنما:شروع_کار_با_ربات_پایتون#.D8.B1.D8.A8.D8.A7.D8.AA.D9.87.D8.A7.DB.8C_.D8.B1.D8.A7.DB.8C.D8.AC|ربات‌های از پیش نوشته شده پروژه پای‌ویکی‌بات]] استفاده کرد.
خط ۱۱۳:
تذکر: افرادی که از خانواده سیستم‌های عامل [[یونیکس]] یا [[لینوکس]] استفاده میکنند ،نیازی به انجام این گام ندارند.
 
پس از دریافت و نصب pywikipedia (البته کدهای پایتون را فقط از حالت فشرده خارج کنید ونصبیو نصبی نیستند) نوبت به ساخت یک میانبر برای اجرا و فرماندهی پایتون‌ها می‌رسد.
 
ما قصد اجرای دستور در cmd را داریم. برای اینکار شما باید در داخل فولدری که کدهای پایتون یا همان اسکریپت‌های ربات قرار دارند راست کلیک کرده و یک shortcut بسازید.
خط ۱۶۴:
برای امتحان، ابتدائی ترین و ساده ترین ربات <small>(یعنی دستور زیر)</small> رو وارد کنید:
 
تذکر:برای اجرای این دستور (از کامپیوتر شخصی و یا از هر سروری) به روی ویک‌پدیا،ویکی‌پدیا، نیاز به درخواست مجوز دارید. ولی توجه کنید که در ویکی‌پدیای فارسی با توجه به اینکه از افزونهٔ خوشامدگویی استفاده می‌شود، برای راندن این ربات مجوز صادر نخواهد شد.
<syntaxhighlight lang="bash">python welcome.py</syntaxhighlight>
 
خط ۱۹۱:
! نام فارسی!! نام فایل!! توضیحات!! مثال
|-
|وروردورود به ویکی‌پدیا ||login.py||ورود به ویکی‌پدیا||در هنگام تایپ پسورد هیچ حرفی دیده نمی‌شود بعد از زدن {{key press|Enter}} کار خود را انجام می‌دهد. برای مواردی که ربات در چند ویکی پرچم دارد از عبارت {{عبارت چپ‌چین|-all}} و برای مواردی که پسوردها مشابه‌است از {{عبارت چپ‌چین|-pass:yourbotpass -all}} استفاده کنید. که yourbotpass پسورد ربات شما هست
|-
|[[ویکی‌پدیا:ربات/خوش‌آمدگویی|خوش‌آمدگویی]] ||welcome.py|| خوش آمدگویی به کاربرهای تازه وارد{{سخ}} {{fontcolor|red|(در ویکی‌فا توسط افزونه انجام می‌گردد و نیازی به راندن ربات نیست.)}} ||{{عبارت چپ‌چین|welcome.py -random -nolog}} {{سخ}} با استفاده از پارامتر‌های {{عبارت چپ‌چین|-random -savedata}} امضای ربات با امضای موارد موجود در [[ویکی‌پدیا:سیاهه خوشامد/امضاها]] جایگزین می‌گردد. با این کار کاربر جدید در صورت داشتن سؤال می تواند به جای ربات از کاربر امضا کننده سؤال خود را بپرسد!
خط ۲۰۳:
|[[ویکی‌پدیا:ربات/میان‌ویکی|میان‌ویکی]] ||interwiki.py||اصلاح یا تولید میان‌ویکی‌ها در فضای نام مقاله، الگو، رده،..|| [[راهنما:استفاده از پیتون در ربات‌های ویکی‌پدیا/راهنما روبات میان‌ویکی]] و [[کاربر:درفش کاویانی/میان‌ویکی]]
|-
|add_text|| add_text.py||اضافه کننده متن به بالا یا پایین مقاله||برای افزودن الگو به مقالاتی که عضو یک ناوبالکسناوباکس هستند.{{سخ}}{{سخ}}'''لینوکس''' و '''سولاریس (تول‌سرور):'''{{سخ}}{{چپ چین}}python add_text.py -links:"الگو:فلان" -text:"{{الگو|فلان}}" -except:"\{\{(الگو:|)(فلان|تغییرمسیر فلان|تغییرمسیر دوم)" -summary:"ربات: افزودن الگوی فلان" {{پایان چپ چین}}{{سخ}}'''ویندوز:'''{{سخ}}
برای ویندوز چون CMD از یونیکد پشتیبانی نمی‌کند در یک فایل متن مثلا up.txt الگو خود را دخیرهذخیره کنید به نحوی که محتوی آن {{الگو|فلان}} باشد. پس از ذخیره کردن فایل متن دستور زیر را اجرا نمایید.{{سخ}}{{سخ}}
{{چپ چین}}python add_text.py -links:نام الگو به صورت حروف درصدی -textfile:up.txt{{پایان چپ چین}}{{سخ}}
'''تذکر:''' به علتی که دستور except در این روش قابل استفاده نیست مگر اینکه نام‌های دیگر الگو به حروف لاتین باشد در نتیجه باید مطمئن باشید که این الگو به زیر صفحه مقالات با نام دیگر اضافه نشده‌باشد.