الگو:سرنویس درخط
 | این الگو از لوآ استفاده می‌کند: |
 | این فراالگو برای ایجاد الگوهای بیشتر و ویژه است. اگر میخواهید از این الگو درون یک مقاله یا صفحه‌های دیگر استفاده کنید، از {{Crossreference}} (با میانبرهای {{crossref}} و {{xref}}) یا الگوهای ویژه دیگر که بر پایه این فراالگوها ایجاد شدهاند (مانند {{see above}} و {{see below}}) استفاده کنید. |
فراالگوی {{سرنویس درخط}} متن را به یک سبک استاندارد برای یک نوع درون‌خطی (و نه در سطح بلوک) از ویکی‌پدیا:سرنویس، یک یادداشت کوتاه در نقطه درج تبدیل می‌کند تا متن به اطلاعات بیشتری پیوند یابد یا آنرا به صفحه دیگری در ویکی‌پدیا ارجاع متقابل بدهد (مانند ).
معمول‌ترین استفاده‌ها از این فراالگو:
- "(جستارهای وابسته ...)" درون‌خطی: نوع پرانتزی ارجاع متقابل ویکی‌پدیا به دیگر صفحه‌های ویکی‌پدیا است که توسط
{{crossreference}}و زیرمجموعه‌های آن ممکن می‌شود. اینها خود ارجاع‌های بدون ارزش نمایش در ویکی‌پدیا هستند. - سرنویس‌های درونِ تعریف در فهرست اصلاحات‌های قالب‌بندی‌شده به صورت الگو که توسط
{{ghat}}ممکن می‌شوند. از آنجا که این سرنویس‌ها به محتوای همان صفحه ارجاع می‌دهند، ارزش نمایش دارند.
استفاده
[ویرایش]- استفادهٔ ساده
{{سرنویس درخط|متن}}
- همه پارامترها
{{سرنویس درخط|متن|کلاس‌های بیشتر=کلاس۱ کلاس۲|خودارجاع=بله|رده=خیر}}
فراالگو پیوندها را هرگز به صورت خودکار ایجاد نمی‌کند. پیوندها و دیگر قالب‌بندی‌های دلخواه باید با استفاده از نشانه‌گذاری ویکی‌پدیا صراحتا افزوده شوند.
پارامترها
[ویرایش]این الگو پارامترهای زیر را می‌پذیرد:
|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 تولید می‌شود.
همچنین ببینید
[ویرایش]- {{الگوهای سرنویس}} برای همه سرنویس‌های قالب بلوکی
الگوها بر پایه این فراالگو
[ویرایش]- {{Crossreference}} (با نام‌های دیگر {{Crossref}} و {{Xref}}) – الگویی برای خودارجاع‌ها (معمولا) به دیگر صفحه‌های ویکی‌پدیا (که در بیشتر موارد بدون ارزش نمایش هستند)
- {{Ghat}} – الگوی سرنویس برای استفاده در فهرست اصلاحات‌های قالب‌بندی‌شده به صورت الگو (دارای ارزش نمایش)
- {{See above}} و {{See below}} – الگوهای ویژه‌تری از {{Crossreference}} که تنها در برخی صفحات بکار می‌روند (دارای ارزش نمایش)