پودمان:Namespace detect/توضیحات

این الگو در در پیام‌های سامانه استفاده شده‌است.
تغییرات آن تأثیر منجر به تغییر بی‌درنگ در میانای کاربری سامانهٔ ویکی‌پدیا می‌شود. در ویرایش آن احتیاط کنید و همهٔ ویرایش‌ها را پیش از ذخیره‌سازی در یک صفحهٔ آزمایشی محک بزنید.

این پودمان حفاظت‌شده ارزیابی شده‌است. این پودمان یکی از الگوهای حساس است و در صفحات بسیار زیادی استفاده می‌شود. محافظت این پودمان در برابر ویرایش، به‌دلیل بار قابل توجهی است که خرابکاری‌ها، خطاها یا ویرایش‌های جزئی می‌توانند به دوش سرورها بگذارند.

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

این پودمان به شما این امکان را می‌دهد تا بسته به فضای نامی که صفحه در آن قرار دارد، متنی را نمایش دهید. این پودمان در واقع به‌نوعی پیاده‌سازی {{تشخیص فضای نام}} در بستر لوآ است که دستخوش بهبودهایی شده است: تمام فضاهای نام و تمام نام‌های مستعار فضاهای نام پشتیبانی می‌شوند و نام‌های فضاهای نام به‌طور خودکار برای ویکی‌های محلی شناسایی می‌شوند.

استفاده[ویرایش]

{{#درخواست: Namespace detect | main
| صفحه       = 
| اصلی       = 
| بحث        = 


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

| سایر       = 
| فضای دمو   = 

| فضای موضوع = 
}}

پارامترها[ویرایش]

اصلی - متنی که در صورت قرار داشتن صفحه در فضای نام اصلی باید نمایش داده شود.
بحث - متنی که در صورت قرار داشتن صفحه در یکی از فضاهای نام بحث باید نمایش داده شود. این می‌تواند برابر با هریک از فضاهای نام بحث باشد - با مواردی نظیر «بحث:»، «بحث ویکی‌پدیا:»، «بحث کاربر:» و غیره مطابقت خواهد داشت.
پارامترهای فضاهای نام موضوعی مانند ویکی‌پدیا، کاربر، پرونده... - متنی که در صورت قرار داشتن صفحه در فضای نام موضوع وابسته باید نمایش داده شود. این پودمان نام تمام فضاهای نام موضوعی شامل فضاهای نام مجازی و نام‌های مستعار فضاهای نام را به‌عنوان پارامتر می‌پذیرد. برای مشاهدهٔ فهرست مقدارهای مجاز، پایین را ببینید.
سایر - متنی که در صورت وارد نشدن هرگونه پارامتر برای فضای نام صفحهٔ حاضر باید نمایش داده شود. اگر پارامتر |فضای دمو= روی مقدار فضای نامی نامعتبر تنظیم شده باشد نیز این متن برگردانده می‌شود.
فضای موضوع - اگر صفحه، یک صفحهٔ بحث بود، از صفحهٔ موضوع وابسته استفاده شود. می‌تواند با هر مقدار مثبتی نظیر «بله» و «yes» (یا سایر مقدارهای مشابه نظیر «آری» یا «y») تنظیم شود.
صفحه - برای تعیین صفحه‌ای که باید فضای نامش تشخیص داده شود، کاربرد دارد. اگر وارد نشود، و |فضای دمو= نیز تنظیم نشده باشد، پودمان به‌طور خودکار از نام صفحهٔ حاضر استفاده خواهد کرد.
فضای دمو - اجبار پودمان به نشان دادن رفتاری که در فضای نام وارد شده از خود نشان می‌دهد. معمولاً برای استفاده در مثال‌ها و بحث‌ها کاربرد دارد.

پارامترهای فضای نام[ویرایش]

مقدارهای مجاز برای پارامترهای فضاهای نام موضوعی به شرح زیر است:

Namespace	Aliases
`main`
`کاربر`	`user`, `كاربر`
`ویکی‌پدیا`	`project`, `وپ`, `ویکی پدیا`, `ويكي پديا`, `ويکي‌پديا`, `wikipedia`, `wp`
`پرونده`	`file`, `تصویر`, `image`
`مدیاویکی`	`mediawiki`
`الگو`	`template`
`راهنما`	`help`, `ره`
`رده`	`category`
`درگاه`
`پیش‌نویس`	`پیشنویس`, `پيشنويس`, `پیش_نویس`, `پيش_نويس`, `پيش‌نويس`, `draft`
`education program`
`timedtext`
`پودمان`	`module`, `پود`
`مبحث`	`topic`

تابع جدول[ویرایش]

برای نمایش جدولی حاوی پارامترهای مختلف فضاهای نام مجاز از دستور زیر استفاده کنید:

{{#درخواست:Namespace detect|table|بحث=بله}}

برای اضافه کردن پارامتر فضاهای نام بحث از |بحث=بله استفاده کنید.

جزئیات فنی[ویرایش]

این پودمان از صفحهٔ داده در پودمان:Namespace detect/data استفاده می‌کند. این صفحه با استفاده از mw.loadData بارگیری می‌شود؛ به این معنی که در هر صفحه یک بار بارگیری می‌شود، و نه با هر بار فراخوانی به‌واسطهٔ دستور #درخواست. این قابلیت برای بهبود عملکرد اضافه شده است.