نمایش مبدأ برای راهنما:الگو


با استفاده از فرآیندی به نام [[ویکی‌نور:تراگنجانش|تراگنجانش]] می‌توان تمام محتویات یک صفحه را در صفحه دیگری قرار داد. صفحه‌هایی که به طور ویژه با این هدف ایجاد شده باشد را '''الگو''' می‌نامند.

در واقع این قابلیت در ویکی، نوعی [[زیرروال]] است و مانند یک عبارت include# یا یک <!--[[wikt:fa:پیش‌پردازنده]]--> [[پیش‌پردازنده]] (Macro)، در زمان مشاهده صفحه باز می‌شود. با [[راهنما:جانشانی|جانشانی]] می‌توان از الگوها به عنوان نوعی پیش‌پردازنده استفاده کرد.

این صفحه و [[راهنما:الگوی پیشرفته|نسخه پیشرفته آن]]، راهنمای مرجع الگوها در مدیاویکی هستند. برای آشنایی با کلیات موضوع، [[راهنما:راهنمای سریع الگوها|راهنمای سریع الگوها]] و [[mw:Help:Templates]] را ببینید. برای دستوراتی که معمولاً در الگوها استفاده می‌گردند، [[راهنما:توابع تحلیل‌گر نحوی]] و سایر صفحات "تابع‌نویسی پیشرفته" که در زیر فهرست شده‌اند را ببینید.

==کلیات==
'''فضای‌نام الگو''' یک [[راهنما:فضای‌نام|فضای‌نام]] با پیشوند "'''الگو:'''" است. 

صفحه‌ای که در این فضای‌نام قرار دارد، '''الگو''' خوانده می‌شود. محتوای این صفحات (خواه ثابت باشد یا وابسته به یک یا چند [[پارامتر (علوم رایانه)|پارامتر]] و یا [[راهنما:متغیر|متغیر]] باشد) طوری طراحی می‌شود که برای قرارگرفتن در سایر صفحات ([[ویکی‌نور:تراگنجانش|تراگنجانش]] و ایجاد یک [[نوشته مرکب]]) مناسب باشد. در صفحه "پیوندهای به این صفحه" عبارتی که در صفحه [[مدیاویکی:Istemplate]] قرار دارد استفاده می‌شود که به صورت پیش‌فرض "inclusion" و گاهی اوقات "تراگنجانش" است و در ویکی کنونی "{{مدیاویکی:Istemplate}}" است.

دستوری که صفحه "الگو:'''نام‌الگو'''" را در صفحه‌ای قرار می‌دهد، <nowiki>{{</nowiki>‎''نام‌الگو''<nowiki>}}</nowiki>‎ است. این عبارت را برچسب الگو می‌نامند که با قرار دادن دو عدد [[ابرو (علامت)|ابرو]] در دوطرف نام صفحه الگو (بدون پیشوند ''الگو:'') به‌کار می‌رود.

'''مثال:''' <nowiki>آ، ب، پ، {{ت ث}}، ج، چ، ح، خ</nowiki> 

<!--{{ut1|tc}} -->(استفاده از [[الگو:ت ث]] که عبارت "ت ث" را برمی‌گرداند)

'''نتیجه:''' آ، ب، پ، {{ت ث}}، ج، چ، ح، خ.

این نوع از ارجاع در ویکی‌متن باعث می‌شود که زمانی که صفحه مورد نظر فراخوانده می‌شود، محتویات الگو در محل فراخوانی وارد شود. برای این کار اطلاحات معادل زیر وجود دارند:
*تراگنجانش
*فراخوانی/استفاده از/گذاشتن/چسباندن الگو
*جاسازی کردن صفحه

برای ایجاد پیوند به صفحه یک الگو از دستور متداول ویکی‌پیوند یعنی <nowiki>[[</nowiki>‎‎الگو:''نام‌الگو'']] استفاده کنید.

صفحاتی که در فضای‌نام‌های دیگر (غیر از فضای نام "الگو") قرار دارند نیز می‌توانند به عنوان الگو استفاده شوند. البته فضای‌نام‌هایی که در [[mw:Manual:$wgNonincludableNamespaces|$wgNonincludableNamespaces]] معین گردیده‌اند، از این قاعده مستثنی هستند. برای استفاده از صفحه‌ای که در فضای‌نام اصلی قرار دارد به عنوان الگو، قبل از نام صفحه علامت دونقطه قرار دهید. 

زمانی که نام الگو با نام متغیری یکی باشد نیز برای استفاده از الگو از همین روش استفاده می‌شود. به عنوان مثال [[الگو:Ns:3|الگو:Ns:3]] و [[الگو:نام‌صفحه|الگو:نام‌صفحه]] را در نظر بگیرید. با وجود اینکه <nowiki>{{Ns:3}} و {{نام‌صفحه}}</nowiki> "{{Ns:3}}" و "{{نام‌صفحه}}" را برمی‌گرداند، ولی <nowiki>{{:الگو:Ns:3}} و {{:الگو:نام‌صفحه}}</nowiki>، محتوای الگوها را برخواهد گرداند.

استفاده از صفحه‌ای که خارج از فضای‌نام الگو قرار دارد، می‌تواند برای کارهای زیر مفید باشد:
*بیان پیام‌های رابط کاربری در فضای نام مدیاویکی
*الگوهایی که برای استفاده شخصی در زیرصفحه صفحه کاربری کسی قرار گرفته‌اند. مانند صفحات آزمایشی
*استفاده از یک صفحه در صفحات دیگری در همان فضای نام. به عنوان مثال زمانی که برای یک صفحه، صفحه اضافه‌ای داشته‌باشیم. مانند صفحه فهرست کارهای لازم (To-Do)؛ چنین صفحه‌ای را می‌توان با {{فضای‌نام}} <nowiki>{{{{فضای‌نام}}:{{نام‌صفحه}}/فهرست‌کارهای‌لازم}}</nowiki> ایجاد کرد.

مانند روال معمول در بیشتر پروژه‌های ویکی‌مدیا که با حروف لاتین هستند، بزرگ یا کوچک بودن حروف نام الگو، به جز در حرف اول، مهم است. همچنین یک فاصله خالی (SPACE) با زیرخط (UNDERLINE یا ـ) هم‌ارز است. (برعکس این رویه در مورد نام متغیرها صادق است که در مورد آن‌ها بزرگ و کوچک بودن حروف مهم است و بین فاصله خالی و زیرخط تفاوت وجود دارد.)

اگر صفحه‌ای که برای تراگنجانش فراخوانده‌شده، وجود نداشته باشد، پیوندی به صفحه ویرایش آن صفحه ایجاد خواهد شد. (برای جزییات تبدیل به [[الگو:وجود]] مراجعه کنید.) بنابراین یکی از راه‌های ایجاد الگو این است که اول برچسب الگو را در صفحه‌ای قرار دهیم و بعد پیوند ایجاد‌شده را دنبال کنیم. این مورد یک استثنا دارد؛ اگر در فضای‌نام مدیاویکی صفحه‌ای تراگنجانده شود، محتوای پیش‌فرض برای آن صفحه تراگنجانده خواهد شد. به عبارت دیگر به‌جز تراگنجانش یک صفحه، می‌توان یک [[راهنما:پیام سیستم|پیام سیستم]] را در یک زبان خاص (به‌طور پیش‌فرض زبان پیش‌فرض وب‌گاه) تراگنجاند و نتیجه به زبان رابط کاربری یک کاربر خاص وابسته نخواهد بود.

می‌توان الگویی را فراخواند که خود، الگويی دیگر را فرا‌خوانده‌ باشد. اگر الگویی به طور مستقیم یا غیر مستقیم خود را فرا‌بخواند، فراخوانی برای هر الگو فقط در یک مرحله انجام خواهد شد. اما اگر کسی بخواهد به تعداد دفعات معینی این کار را انجام دهد، می‌توان با محدودکردن تعداد دفعات انتقال، این کار را انجام داد. برای توضیحات بیشتر [[راهنما:الگو#تکرار در یک صفحه|تکرار در یک صفحه]] را ببینید.

[[راهنما:متغیر|متغیرها]]ی یک الگو زمانی با مقدارشان جایگزین می‌شوند که محتویات الگو در صفحه‌ای که الگو را فرا‌خوانده، وارد شده باشد؛ به عنوان مثال اگر <nowiki>{{نام‌صفحه}}</nowiki>‎ (یا در اصل <nowiki>{{PAGENAME}}</nowiki>‎ در ویکی‌متن یک الگو وجود داشته باشد، با نام صفحه‌ای جایگزین می‌شود که الگو را فرا‌خوانده است و نه نام الگو.

فهرست صفحاتی که به واسطه استفاده از الگو‌ها در یک صفحه کنجانده شده‌اند، به همراه پیوند به آن‌ها در پایین صفحه ویرایش آورده می‌شود (این فهرست در جدولی با نام templatelinks در بانک داده نرم‌افزار مدیاویکی ذخیره می‌شود). نکات:
*در صفحه ویرایش یک بخش، ابتدا تمام فهرست نمایش داده می‌شود؛ یعنی الگوهایی که در سایر بخش‌ها استفاده شده نیز فهرست می‌شوند. بعد از این که کلید پیش‌نمایش فشار داده شد، صرفاً الگوهایی فهرست می‌شوند که در بخش مورد ویرایش وجود دارند و در این حالت الگوهای جدیدی که در ویرایش‌های انجام شده اضافه شده‌اند نیز فهرست می‌شوند.
*به همین ترتیب، در هنگام ویرایش نسخه قدیمی یک صفحه، ابتدا الگوهای نسخه فعلی فهرست می‌شوند؛ در حالی که در اولین پیش‌نمایش، الگوهایی فهرست می‌شوند که در ویرایش کنونی (با در نظر گرفتن تغییرات انجام شده) وجود دارند.
*اگر صفحه‌ای با دستورهای if# یا ifeq# یا ifexist# یا ifexpr# یا switch# به صورت شرطی فرا‌خوانده شود، جاسازی‌‌شده به حساب خواهد آمد، حتی اگر شرط مورد نظر برآورده نشود. 
*اگر نام یک صفحه جاسازی شده، یک عبارت باشد، نتیجه عبارت نمایش داده می‌شود. مثلاً نتیجه <nowiki>{{abc{{CURRENTDAY}}}}</nowiki> در حال حاضر {{abc{{CURRENTDAY}}}} است و نتیجه <nowiki>{{{{#ifexist:الگو:آ|آ|x1}}|الگو وجود ندارد}}</nowiki> در حال حاضر {{{{#ifexist:الگو:آ|آ|x1}}|الگو وجود ندارد}} است.


(''پشتیبانی در نسخه ۱.۴ و نسخ بعدی'')

زمانی که یک صفحه را بدون یک خط خالی در پایان آن ذخیره کنید و سپس مجدداً به صفحه ویرای بروید، خط جدیدی در انتهای آن وجود خواهد داشت. هرچند به نظر می‌رسد که این کار بی‌نتیجه است؛ ولی<!-- مثال بالا و--> مثال زیر را ببینید:

<pre>{{نمونه نمایشی فهرست شماره‌دار}}{{نمونه نمایشی فهرست شماره‌دار}}
{{نمونه نمایشی فهرست شماره‌دار}}</pre>

که در آن سه‌بار از [[الگو:نمونه نمایشی فهرست شماره‌دار]] استفاده شده، نتیجه زیر را برمی‌گرداند:

{{نمونه نمایشی فهرست شماره‌دار}}
{{نمونه نمایشی فهرست شماره‌دار}}
{{نمونه نمایشی فهرست شماره‌دار}}

در نام الگو، نویسه "#" و تمام نویسه‌های پس از آن، در نظر گرفته نخواهد شد؛ مثلاً نتیجه "<nowiki>{{ت ث#آ ب پ}}</nowiki>‎" عبارت "{{ت ث#آ ب ژ}}" است. از این خاصیت در {{links-small|en|template|hif}} استفاده شده است.

در ویکی‌متن، اگر عبارتی با یک‌جفت دوتایی ابروی باز شروع شده و با یک جفت دوتایی ابروی بسته تمام شود، هر سه ابروی پشت سرهم در آن به عنوان یک پارامتر تفسیر خواهد شد. برای جلوگیری از این مساله حداقل بین یکی از دوجفت ابرو‌های پیاپی یک فاصله بدهید. به عنوان مثال، "<nowiki>{{{{ت ث}}}}</nowiki>" عبارت "{{{{ت ث}}}}" را برمی‌گرداند در‌حالی‌که "<nowiki>{{ {{ت ث}}}}</nowiki>" عبارت "{{{{ت ث}} }}" را برمی‌گرداند.

با استفاده از [[ویژه:ExpandTemplates]] هر کسی می‌تواند ویکی متنی را که فراخوانی یک الگو ایجاد می‌کند را ببیند. در واقع این صفحه گام میانی تفسیر صفحات است.<!--The same is also produced with a URL like  {{fullurl:{{FULLPAGENAME}}|action=raw&templates=expand}}.-->

==استفاده از الگوها بین چند پروژه==
الگوها زمانی کار‌می‌کنند که از همان پروژه‌ای که در آن قرار دارند فرا‌خوانده شوند. برای استفاده از یک الگو در پروژه دیگر، باید الگوی مورد نظر را در آن پروژه کپی کنید. تقاضای حذف این محدودیت در [[Bugzilla:1126]] داده‌شده است؛ یعنی اینکه بتوان از الگوها استفاده میان‌ویکی کرد.

برای کپی الگو، به نحوی که در پروژه دیگر کار کند، تنظیماتی لازم است که با
<nowiki>{{</nowiki> SERVER}}، <LOCALURL و نام فضای‌نام‌های عمومی و نوشتن پیوند‌ها به نحوی که در پروژه‌های مختلف کار کنند، می‌توان این تنظیمات را کاهش داد. برای کپی چند الگو، [[راهنما:واردکردن]] و [[راهنما:صادرکردن]] را ببینید. همچنین مناسب است که نام الگو در پروژه دیگر با نام کنونی آن یکسان باشد. بنابراین زمانی که می‌خواهید الگوی جدید ایجاد کنید، نام‌های مورد استفاده در سایر پروژه‌ها را هم کنترل کنید. دقت کنید که اگر برای ارجاع به الگویی، عبارتی مانند abc{{NAMESPACE}} استفاده گردد، در پروژه‌ای که نام فضای‌نام‌ها متفاوت باشند، باید نامی جدید یا یک صفحه تغییر‌مسیر ایجاد گردد

بنابراین تراگنجانش بین پروژه‌ها از یک محل مشترک تنها در موارد زیر ممکن است:
*برای تصاویری که در [[ویکی‌انبار]] قرار گرفته‌اند.
*برای متون قابل ویرایش صفحه تصویری که در ویکی‌انبار قرار دارد که شامل موارد تراگنجانده‌شده از سایر صفحات ویکی‌انبار به صفحات تصاویر معادل کنونی نیز می‌شود.

الگوهای موجود در ویکیای مرکزی با پیشوند "wikia:" در سایر پروژه‌های ویکیا قابل استفاده‌اند. برای اطلاعات بیشتر <span class="plainlinks">[http://www.wikia.com/wiki/Help:Shared_templates این صفحه]</span> را ببینید. توجه کنید که الگوهای ویکیا توسط بنیاد ویکی‌مدیا میزبانی نمی‌شوند.)

گاهی اوقات پروژه‌های مختلف به صفحاتی احتیاج دارند که قسمتی مشابه و قسمتی متفاوت باشند. به عنوان مثال در برخی پروژه‌ها، "m:" و در برخی دیگر "MetaWikipedia:" به عنوان پیوند میان‌ویکی به فراویکی استفاده می‌شود. برای این کار ویکی‌متن‌های ویژه‌ای به کار می‌روند (که الگوهای project-specific نامیده می‌شوند.) در مثالی که به آن اشاره‌شد، می‌توان در نام‌صفحه عبارت
<nowiki>{{meta}}</nowiki> را آورد؛ چراکه در هر پروژه صفحه‌ای با نام Template:Meta وجود دارد که پیشوند مورد نیاز را در خود دارد.

== انواع الگوها ==
الگوها بسته به کاربردشان به چند دسته تقسیم می‌شوند:

=== الگوهای اطلاعاتی ===
الگوهای اطلاعاتی یا الگوهای جعبه‌ای الگوهایی هستند که در بالا و سمت چپ مقاله قرار می‌گیرند و اطلاعات مختصر و چکیده از موضوع ارائه می‌دهند (مثلا [[الگو:جعبه صورت فلکی]]) الگوی مادر این الگوها [[الگو:Infobox]] است.

=== الگوهای خرد و ابهام‌زدایی ===
{{الگوی|خرد}} و
<nowiki>{{موضوع-خرد}}</nowiki> (مثلا [[الگو:فیزیک-خرد]]) این الگوها هستند که در پایین مقالات جای می‌گیرند و برای [[ویکی‌نور:مقالات خرد|مقالات خرد]] به کار می‌روند.

{{الگو|ابهام‌زدایی}} و مشتقاتش که الگوی مادر آنها [[الگو:Dmbox]] است در پایین مقالات به کار رفته و برای بیان ابهام‌زدایی بودن صفحه استفاده می‌شوند.

=== الگوهای پیامی ===
این الگوهای در بالای مقاله یا بخش مورد استفاده قرار می‌گیرند و برای پیام دادن به خواننده هستند مثلا [[الگو:منبع]] که به خواننده هشدار می‌دهد که این مقاله منبعی نداردالگوی مادر این الگوها بسته به فضای نام تغییر می‌کند به صورتی که برای فضای نام اصلی [[الگو:Ambox|Ambox]]، برای فضای نام بحث [[الگو:Tmbox|Tmbox]]، برای فضای نام تصویر [[الگو:Imbox|Imbox]]، فضای نام کاربری و ویکی‌نور [[الگو:Ombox|Ombox]]، رده [[الگو:cmbox]] و برای استفاده در چند فضای نام کاربری [[الگو:mbox|mbox]] است.

=== الگوهای ویرایشی ===
این الگوها کمک دست کاربر در هنگام ویرایش است به طور مثال [[الگو:سخ]] متن را به خط بعدی می‌برد یا [[الگو:جلالی]] تاریخ را به خورشیدی بیان می‌کند.

=== الگوهای ناوبری ===
جای این الگوها در پایین مقاله‌است و برای ناوبری در مقالات مشابه به کار می‌رود مثلا [[الگو:دهمین انتخابات ایران]] که برای ناوبری در مقالات مرتبط با انتخابات ۱۳۸۸ ایران به کار می‌رود و الگوی مادر آن [[الگو:Navbox]] است.

=== الگوهای مادر ===
این الگوها مستقیما در مقالات استفاده نمی‌شوند بلکه شالوده الگوهایی را تشکیل می‌دهند که در مقالات به کار می‌رود و برای الگوهای ویکی‌نور یکدستی می‌آورند و مثلا [[الگو:زنز]] مشابه [[الگو:بحث بیجا]] یا [[الگو:زبان‌های ایرانی]] مشابه [[الگو:عناصر]] است.

== جستارهای وابسته ==
* [[ویکی‌نور:فهرست الگوها]]

{{چپ‌چین}}

[[رده:الگو:ویکی‌نور]]