پرش به محتوا

الگو:سرنویس درخط

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

{{{محتوا}}}

توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

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

معمول‌ترین استفاده‌ها از این فراالگو:

استفاده

[ویرایش]
استفادهٔ ساده
{{سرنویس درخط|متن}}
همه پارامترها
{{سرنویس درخط|متن|کلاس‌های بیشتر=کلاس۱ کلاس۲|خودارجاع=بله|رده=خیر}}

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

پارامترها

[ویرایش]

این الگو پارامترهای زیر را می‌پذیرد:

  • |1= یا |متن= یا |محتوا= – متن محتوای درون‌خطی (پارامتر مورد نیاز). اگرچه نیازی به نامگذاری مشخص این پارامتر با |1= یا |متن= یا |محتوا= نیست، اما انجام آن پیشنهاد می‌شود، زیرا اگر در متن ورودی، علامت مساوی = بکار رفته باشد و پارامتر، نامگذاری نشده باشد، الگو شکسته خواهد شد.
  • |کلاس= یا |کلاس‌های بیشتر= – هر گونه کلاس اضافی سی‌اس‌اس که باید افزوده شود. تا جای ممکن از این پارامتر استفاده نکنید.
  • |خودارجاع=خیر – اگر مقدار این پارامتر خیر (یا نه، غلط، خاموش، غیره.) وارد شود کلاس سی‌اس‌اس، پیش‌فرض خودارجاع را حذف می‌کند که از آن برای نشان دادن خودارجاع‌های بدون ارزش نمایش در ویکی‌پدیا استفاده می‌شود (برای اطلاعات بیشتر الگو:در ویکی‌پدیا را ببینید). از این گزینه نباید برای نشان دادن غیر خودارجاع‌ها در پیوندهای میان‌مقاله‌ای استفاده کرد و فقط باید به پیوندهای درون همان مقاله ارجاع داد (الگوهای کوتاه مشتق شده {{See above}} و {{See below}} این کار را به صورت خودکار انجام می‌دهند). اگر پارامتر مستعار به صورت |قابل چاپ=بله (با مقادیر پرشدنی دیگر درست، صحیح، روشن، غیره.) نوشته شود اثر آن برابر |خودارجاع=خیر خواهد بود. توجه کنید که اگر تلاش کنید با |خودارجاع=بله و |قابل چاپ=خیر به صورت دستی، مقدار "این یک خودارجاع است" را به الگو بیافزایید نتیجه دلخواه را نخواهید گرفت (زیرا مقدار پیش‌فرض است). از آنجا که بیشتر استفاده از فراالگو به صورت خودارجاع است، فراالگو به صورت پیش‌فرض به صورت خودارجاع تنظیم شده است (تغییر تنظیمات تنها در مقاله‌ها ممکن است و در الگوها ممکن نیست). این موضوع در واقع می‌تواند با استفاده از {{Yesno}} تعیین شود، اما شاید دردسر آن بیش از ارزش چنین کاری باشد.
  • |رده= – اگر مقدار این پارامتر خیر (یا نه، غلط، خاموش، غیره.) وارد شود، رده ردیابی خطا (رده:الگو:سرنویس همراه خطا) را غیر فعال می‌کند. این کار، تنها در صورتی تأثیر است که نخستین پارامتر موقعیتی (متن سرنویس) حذف شود. از این پارامتر تا جای ممکن استفاده نکنید.
  • |درخط= – این یک پارامتر ویژه و مقدار پیش‌فرض آن yes است. اگر مقدار این پارامتر خیر (یا نه، غلط، خاموش، غیره.) وارد شود، جلوی تبدیل <div> به <span> را می‌گیرد و به صورت <div> باقی می‌ماند. به صورت پیش‌فرض خروجی آن مانند {{سرنویس}} است. تنها زمان استفاده از این پارامتر، هنگامی است که {{سرنویس درخط}} به صورت فراالگو بکار برود. برای نمونه، {{Crossreference}} دارای سبک‌های الگو و یک کلاس سفارشی است که در حالت بلوکی در مقایسه با یک سرنویس معمولی رفتار متفاوتی با Crossreference دارند (مانند حذف تورفتگی سرنویس). بنابراین، بدیهی است که معمولاً از این پارامتر استفاده نمی‌شود، و استفاده از آن برای انجام هر کار عملی نیاز به راه‌اندازی (setup) دارد.

جزئیات فنی

[ویرایش]

این فراالگو یک محفظه <span>...</span> HTML را در اطراف متن وارد شده به عنوان نخستین پارامتر (|1=) مورد نیاز خود قرار می‌دهد که بر پایه آن قالب‌بندی استاندارد شده را (در بیشتر موارد به صورت مورب، و فقط از نظر سبک، و نه به عنوان تأکید معنایی) ارائه می‌دهد. همچنین از کلاس‌های سی‌اس‌ای برای جداسازی کد موجود استفاده می‌کند تا مطمئن شود که به درستی تفسیر شده و می‌توان مستقل از محتوای اصلی مقاله روی آن عمل کند.

کد HTML که با این الگو ساخته شده مانند زیر است:

  • <span class="hatnote">متن سرنویس</span>

این همان کلاسی است که توسط {{سرنویس}} بر پایه <div> استفاده می‌شود که نمایش بلوک آن توسط یک دستورالعمل جداگانه div.hatnote در en:Mediawiki:Common.css کنترل می‌شود.

خروجی این الگو توسط پودمان:Hatnote inline تولید می‌شود.

همچنین ببینید

[ویرایش]

الگوها بر پایه این فراالگو

[ویرایش]