راهنما:واژه‌های جادویی: تفاوت میان نسخه‌ها

'''کلمات جادویی''' دستوراتی هستند که باعث می‌شوند نرم‌افزار [[مدیاویکی]] (که ویکی‌پدیا بر آن استوار شده‌است) کارهای خاصی را انجام بدهد. برخلاف متن عادی صفحات و دستوراتدستورهای معمولی مانند دستور <nowiki>[[تصویر:...]]</nowiki>، دستوراتدستورهای جادویی باعث می‌شوند که نرم‌افزار مدیاویکی کارهایی فراتر از نمایش یک متن یا تصویر را انجام بدهد.

دستوراتدستورهای جادویی ممکن است به شکل‌های زیر باشند:

*یک کلمه که در دو طرف آن، نویسه (کاراکتر) خطِ زیر (underscore یا همان _) دو بار تکرار شده‌است، مانند <nowiki>__NOTOC__</nowiki>. این دستوراتدستورها اگر به زبان انگلیسی وارد شوند حتماً تمام حروفشان باید بزرگ باشد (یعنی مثلاً <nowiki>__notoc__</nowiki> یک کلمهٔ جادویی نیست.)

*یک شیئ XML مانند آن چه که بین دستورهای '''&lt;nowiki&gt;''' و {{چر}}'''&lt;/nowiki&gt;'''{{چر}} قرار می‌گیرد. این دستورات،دستورها، مانند دستوراتدستورهای HTML، با یک نویسهٔ '''کوچک‌تر''' (>) شروع می‌شوند، با متن دستور دنبال می‌شوند، با یک نویسهٔ '''بزرگ‌تر''' پایان می‌پذیرند. اکثر این دستوراتدستورها به صورت جفتی هستند، یعنی یک دستور قبل و یک دستور بعد از متن دلخواه قرار می‌گیرد. دستوری که بعد از متن دلخواه قرار می‌گیرد، یک نویسهٔ / هم بعد از نویسهٔ '''کوچک‌تر''' لازم دارد. (مثال: آغاز دستور گالری تصاویر به صورت <nowiki><gallery></nowiki> و پایان آن به صورت {{چر}}<nowiki></gallery></nowiki>{{چر}} است.)

*دستورات مربوط بهدستورهای تجزیه‌کننده (parser functions) که علت نامگذاری آن‌ها این است که این دستوراتدستورهای توسط قسمتی از برنامهٔ مدیاویکی که به آن ''تجزیه‌کننده'' {{انگلیسی|parser}} گفته می‌شود، تحلیل می‌شوند. تمام این دستورها با '''<nowiki>{{</nowiki>''' شروع می‌شوند و با '''<nowiki>}}</nowiki>''' پایان می‌پذیرند (که از این جهت، بسیار شبیه به [[وپ:الگو|الگوهای]] ویکی‌پدیا هستند.) مثالی از این دستورها، دستور شرطی if است که به صورت {{چر}}'''<code><nowiki>{{#if:....}}</nowiki></code>'''{{چر}} نوشته می‌شود. (این دستورها به فارسی ترجمه شده‌اند).

لازم است در همین ابتدا نکته‌ای تذکر داده شود. کلمات جادویی تا مدت‌ها فقط به صورت انگلیسی قابل استفاده بودند. از تاریخ [[۵ ژوئن]] [[۲۰۰۷ (میلادی)|۲۰۰۷]]،‌ این امکان در ویکی‌پدیا فارسی فراهم شد که ترجمهٔ فارسی این دستوراتدستورها نیز استفاده شود. در حال حاضر این ترجمه‌ها برای دستوراتدستورها مربوط به تجزیه‌کننده هنوز فعال نشده‌اند، که به محض فعال‌شدنشان، این صفحه به روز رسانی خواهد شد. در متن زیر، دستور فارسی و انگلیسی در کنار هم توضیح داده شده‌اند، و شما مختارید از هرکدام که برایتان راحت‌تر است در ویرایش ویکی‌پدیا استفاده کنید.

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

همان‌طور که بالاتر ذکر شد، اولین دسته از کلمات جادویی، آن‌هایی هستند که در دو طرفشان، نویسهٔ خطِ زیر (_) دوبار تکرار شده‌است. این دستوراتدستورها از قرار زیر هستند:

دستور &lrm;'''&lt;pre&gt;'''...'''&lt;/pre&gt;'''&lrm; که آن چه در میان آن قرار بگیرد، به صورت یک پاراگراف جدید، با حاشیه خط‌چین شده و پس‌زمینهٔ خاکستری نشان داده می‌شود. اهمیت این دستور (و تفاوت مهم آن با دستور nowiki) در آن است که اگر متنی که میان آن قرار می‌گیرد حاوی دستوراتدستورها HTML باشد، این دستوراتدستورها اجرا نخواهند شد، بلکه به صورت اجرا نشده به کاربر نمایش داده خواهند شد.

== دستوراتدستورهای تجزیه‌کننده ==

دستورهای {{چر}}<nowiki>{{ns:}}</nowiki>{{چر}} و <nowiki>{{localurl}}</nowiki> و <nowiki>{{urlencode}}</nowiki> و <nowiki>{{fullurl}}</nowiki> در این خانواده قرار دارند. با توجه به پیچیدگی کاربرد این دستورات،دستورها، توصیه می‌شود که [[m:Help:Magic wordsParserFunctions|توضیحات موجود در فراویکی]] را که به زبان انگلیسی است، مطاله کنید. در زیر تنها به ترجمهٔ فارسی این دستوراتدستورها اشاره می‌شود.

*[[m:Help:Parser function|توضیحات مربوط به دستوراتدستورهای تجزیه‌کننده]] در فراویکی