کاربر:Behaafarid/راهنمای دکمه‌افزایی

از ویکی‌پدیا، دانشنامهٔ آزاد.

  • به [[کاربر:نام کاربری/monobook.js]] بروید.
  • در خط اول عبارت:
<pre>
document.write('<script type="text/javascript" src="' 
             + 'http://fa.wikipedia.org/w/index.php?title=User:Behaafarid/BehaafaridTools.js' 
             + '&action=raw&ctype=text/javascript&dontcountme=s"></script>');

را وارد کنید.

  • اگر در مونوبوکتان خط «function InsertButtonsToToolBar()» را دیدید به بخش «تعریف و افزودن دکمه» (پائین‌تر در همین صفحه) بروید؛ در غیر این صورت مراحل زیر را ادامه دهید.
  • عبارت زیر را در پایین صفحه وارد کنید.

{{subst:کاربر Behaafarid/بستر دکمه}}

  • صفحه را ذخیره کنید.

پس از ذخیره باید چنین قسمتی به صفحه اضافه شده باشد:


/* ابزار اضافه */
function InsertButtonsToToolBar()
{
 tooly = document.getElementById('toolbar');
 if (tooly != null) 
{

/*افزودن دکمه‌ها به اینجا*/
/*دکمهٔ برچسب ناقص به عنوان نمونه*/
Stub= " | <a href=\"javascript:insertTags('','{{ناقص}}','');\">نا</a>";

tooly.innerHTML =  Stub;
}
}

addOnloadHook(InsertButtonsToToolBar);

اگر به جای این هنوز عبارت subst:... خودنمایی می‌کند آن را پاک کنید و خطوط بالا را دستی وارد کنید. این بستری‌است که در آن دکمه‌افزایی صورت می‌گیرد. برای نمونه دکمه‌ای افزوده شده‌است که برچسب ناقص را وارد می‌کند. با فشردن Ctrl+F5 در اینترنت اکسپلورر یا ctrl+shift+R در فایرفاکس صفحه را تازه کنید. دکمهٔ اضافه‌ای را مشاهده می‌کنید که با فشردن آن برچسب ناقص افزوده می‌شود.

[ویرایش] تعریف و افزودن دکمه

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

مراحل افزودن دکمه به این صورت است: تعریف دکمه به صورت:

naameDokmeh = "<a href=\"javascript:Routine(document.editform.wpTextbox1);\">نام دکمه</a>

در خط بالا naameDokmeh عنوانی‌است که به خط لاتین به دکمه می‌دهید. Routine نام روتین مورد نظر در ابزارهای به‌آفرید است. مثلاً روتین اصلاح فاصلهٔ مجازی FM است و روتین اصلاح ی و ک عربی YKarabic است. بنابراین به جای Routine نام روتین مورد نظر وارد می‌شود. «نام دکمه» نامی‌است که می‌خواهید دکمهٔ مورد نظر در میله‌ابزار داشته باشد.

پس از تعریف دکمه به خط tooly.innerHTML بروید و در انتهای خط (در واقع پیش از علامت «;» و نه پس از آن) naameDokmeh را همراه با «+» پیش از آن وارد کنید.

/*قبل از افزودن دکمه*/
tooly.innerHTML =  Stub;
/*بعد از افزودن دکمه*/
tooly.innerHTML =  Stub + naamehDokmeh;
/*تغییر تقدم و تأخر دکمه‌ها*/
tooly.innerHTML =   naamehDokmeh+ Stub  ;

نام روتین‌های ابزارهای به‌آفرید از قرار زیر است:

  • YKarabic برای اصلاح ی و ک عربی
  • FM برای اصلاح فاصلهٔ مجازی
  • NonStandard برای اصلاح نویسه‌های غیراستاندارد
  • digits برای اصلاح ارقام لاتین و عربی
  • SuperTool اجرای یکجای همهٔ روتینها به اضافهٔ رفع بعضی ایرادهای نقطه‌گذاری

[ویرایش] قدم‌های بعدی

در صورتی که با زبان Javscript آشنا باشید، شما می‌توانید دکمه‌های جدیدی با عملکرد دلخواه خود به مجموعه دکمه‌های موجود بیفزایید. به علاوه شما می‌توانید به دکمه‌های مورد استفادهٔ خودتان ظاهری مانند دکمه‌هایی که به طور پیش‌فرض در ویکی تعریف شده‌اند ببخشید. به عنوان نمونه، اگر از کد زیر برای تعریف دکمه استفاده کنید، نه تنها دکمه‌ای برای شما افزوده می‌شود که قابلیت اصلاح حرف نادرست «ك» به حرف فارسی «ک» و حرف نادرست «ي» به حرف فارسی «ی» را دارد که شما از روی ظاهر دکمه به سرعت می‌توانید کاربرد آن را به خاطر بیاورید:

 /*ی\u200cک\u200cعربی*/
 YKArabic = "<a href=\"javascript:YKarabic(document.editform.wpTextbox1);\"><img src=\""
             + "http://upload.wikimedia.org/wikipedia/fa/8/88/Button_YehKeh.png"
             + "\" title=\"اصلاح کاف و یا\"></a>";

توجه داشته باشید که کد بالا برای راحت‌تر خوانده شدن، به صورت چپچین نمایش داده می‌شود. پس از این که شما کد را در جعبهٔ ویرایش monobook.js خودتان وارد کردید، ممکن است کد به صورت راست‌چین و متفاوت با آن چه در بالا می‌بینید به نظر برسد. این پدیده هیچ ایرادی ندارد و در کارکرد برنامه اشکالی ایجاد نمی‌کند.

[ویرایش] رفع اشکال

در صورتی مواجهه با نکته‌ای مبهم یا پیش‌آمدن پرسش با کاربر:Behaafarid تماس بگیرید.