راهنما:آموزش سریع الگوها

    از ویکی‌نور

    این نوشته مرور سریعی بر الگوها ارائه می‌کند. جزئیات کامل را می‌توان در راهنما:الگو و راهنما:الگوی پیشرفته پیدا کرد.

    الگوها (به انگلیسی: Templates) صفحاتی در فضای نام الگو هستند. یعنی هر صفحه‌ای که با نام "الگو:" شروع شده باشد، مانند [[الگو:نام_الگو]]. می‌توان با نوشتن {{نام_الگو}}، محتویات آن را به صفحه اضافه کرد.

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

    ایجاد، ویرایش و استفاده از الگوها

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

    به محض اینکه الگو را ساختید، می‌توانید با اضافه کردن {{نام_الگو}} در صفحه مورد نظرتان، از آن استفاده کنید. و بعد از ایجاد الگو در انتهای آن <noinclude>{{توضیحات}}</noinclude> که بعد از ذخیره صفحه می‌توانید در یک زیرصفحه الگو در مورد آن و روش استفاده از آن توضیح دهید مثلا الگو:رشد را ببینید. ‎ هر صفحه‌ای که در آن از این الگو استفاده کرده باشد، زمانی که توسط کاربری دیده شود، دقیقا همان قطعه از متن را نشان خواهد داد که در الگو نوشته‌اید. زمانی که الگو به روز شود، تمام صفحاتی که برچسب الگو را دارند به روز می‌شوند.

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

    اگر الگویی که می‌خواهید آن را ویرایش کنید به صورت {{فوو}} باشد، برای ویرایش آن باید به صفحه الگو:فوو بروید. برای رفتن به چنین صفحه‌ای می‌توانید: نام صفحه را در Address Bar بنویسید (حتی به فارسی)، آن را جستجو کنید یا یک پیوند در گودال ماسه‌بازی بسازید و روی آن کلیک کنید.

    زمانی که به صفحه مورد نظرتان رسیدید، فقط روی "ویرایش" یا "این صفحه را ویرایش کنید"، کلیک کنید و مانند صفحات معمولی آن را ویرایش کنید. می‌توانید هر چیزی که به یک صفحه معمولی اضافه می‌کردید به یک الگو هم اضافه کنید، مانند متن، تصویر و سایر الگوها. لطفا دقت کنید که تغییرات شما ممکن است روی بسیاری از صفحه‌ها تأثیر بگذارد، بنابراین مواظب باشید.

    پرسش‌های رایج

    آیا می‌توانم از یک الگو در بیش از یک پروژه استفاده کنم؟
    خیر، اگر مثلاً می‌خواهید از صفحه‌ای در دو زبان ویکی‌نور استفاده کنید، لازم است که آن صفحه را دو بار بسازید.
    آیا الگوها نسبت به حروف کوچک و بزرگ حساسند؟
    بله، معمولاً به جز حرف اول.
    آیا می‌توانم پارامتر هم اضافه کنم؟
    بله، برای دستورالعمل این کار راهنما:الگو را ببینید.
    از چند الگو می‌توانم در یک صفحه استفاده کنم؟
    هر چند تا که می‌خواهید. (در نسخه‌های قدیمی تر نمی‌توانستید از هر الگو بیش از پنج بار استفاده کنید.)
    من یک الگو را ویرایش کردم، پس چرا صفحه‌ای که از آن استفاده کرده، تغییری نکرد؟
    اشکال در cache صفحات وب است. یک راه اجبار refresh این است که صفحه‌ای که الگو در آن ظاهر می‌شود را ویرایش کنید و بدون تغییر دادن چیزی روی صفحه ذخیره شود کلیک کنید - نیازی نیست که خلاصه ویرایش را بنویسید چرا که با این کار در تاریخچه صفحه تغییری ثبت نخواهد شد. فشار دادن کلید Ctrl به همراه F5 نیز معمولاً مشکل را حل می‌کند.
    آیا می‌توانم یک الگو را به یک نام جدید منتقل کنم؟
    این کار مانند یک انتقال صفحه معمولی است. زمانی که صفحه‌ای برای انتقال معرفی می‌شود یک صفحه ارجاعی باشد، صفحه ارجاع شده جایگزین آن می‌شود.
    آیا می‌توانم درون یک الگو از الگو استفاده کنم؟
    می‌توانید درون یک الگو از برچسب الگو استفاده کنید. اما نمی‌توانید درون یک برچسب الگو از برچسب الگو استقاده کنید. در چنین مواقعی، زمانی که تجزیه کننده (parser) به اولین حلقه آکولاد بسته می رسد، تجزیه الگو را متوقف می کند.

    مثال‌ها

    خطای لوآ در پودمان:Main در خط 55: attempt to call field 'formatPageTables' (a nil value).

    راهنمای ویکی‌نور

    همچنين ویکی‌نور:فضای نام الگو را ببينيد.