الگو:ارجاع متقابل
 | این الگو از لوآ استفاده می‌کند: |
 | این الگو از الگوسبک استفاده می‌کند: |
الگو {{ارجاع متقابل}} نوشته را به یک سبک استاندارد شده برای ارجاع متقابل ویکی‌پدیا (en) از نوع پرانتزی "(جستارهای وابسته ...)" درون‌خطی (نه در سطح بلوکی) به دیگر موارد ویکی‌پدیا قالب‌بندی می‌کند. اگر ارجاع به صفحه‌های دیگر باشد، خودارجاع بدون ارزش نمایش در ویکی‌پدیا است. اگر ارجاع متقابل به همان صفحه باشد چنین چیزی صادق نیست. برای ارجاع‌های متقابل در سطح بلوکی، فراالگو {{سرنویس}} و زیرمجموعه‌های گوناگون آن (مانند {{همچنین ببینید}}) را ببینید. خروجی نهایی این الگو توسط پودمان:Hatnote inline ایجاد خواهد شد، اما در موارد خاص از یک حالت سطح بلوکی پشتیبانی می‌کند (بخش پارامترها در پایین همین صفحه را ببینید).
برای دیدن فهرست الگوهای مشابه یا الگوهایی که از این الگو برگرفته شده‌اند، رده:الگو:ارجاع متقابل را ببینید.
استفاده
[ویرایش]این الگو به صورت خودکار، هیچ پیوندی را ایجاد نمی‌کند. پیوندها و دیگر قالب‌بندی‌های مطلوب (مانند پرانتز، یا نقطه‌گذاری پایانی) باید صراحتا با استفاده از نشانه‌گذاری ویکی‌پدیا افزوده شوند.
ارجاع متقابل ساده به یک صفحه دیگر:
| نشانه‌گذاری | نمایش |
|---|---|
{{ارجاع متقابل|(همچنین ببینید [[تاریخ جهان]])}}
|
|
ارجاع متقابل ساده به همان صفحه:
| نشانه‌گذاری | نمایش |
|---|---|
{{ارجاع متقابل|خودارجاع=خیر|({{پیوند بخش|#پارامترها}} را ببینید)}}
|
|
همه پارامترها:
| نشانه‌گذاری | نمایش |
|---|---|
{{ارجاع متقابل|کلاس=کلاس۱ کلاس۲|خودارجاع=خیر|درون‌خطی=خیر|Blargh:
* Foo
* Bar
* Baz
}}
|
|
پارامترها
[ویرایش]این الگو پارامترهای زیر را می‌پذیرد:
|1=یا|متن=یا|محتوا=– متن محتوای درون‌خطی (پارامتر مورد نیاز). اگرچه نیازی به نامگذاری مشخص این پارامتر با|1=یا|متن=یا|محتوا=نیست، اما انجام آن صراحتا پیشنهاد می‌شود، زیرا اگر در متن ورودی، علامت مساوی = بکار رفته باشد و پارامتر، نامگذاری نشده باشد، الگو شکسته خواهد شد.|کلاس=یا|کلاس‌های بیشتر=– هر گونه کلاس اضافی سی‌اس‌اس که باید افزوده شود. تا جای ممکن از این پارامتر استفاده نکنید.|خودارجاع=خیر– اگر مقدار این پارامترخیر(یانه،غلط,خاموش، غیره.) وارد شود کلاس سی‌اس‌اس، پیشفرضخودارجاعرا حذف می‌کند که از آن برای نشان دادن خودارجاع‌های بدون ارزش نمایش در ویکی‌پدیا استفاده می‌شود . از این گزینه نباید برای نشان دادن غیر خودارجاع‌ها در پیوندهای میان‌مقاله‌ای استفاده کرد و فقط باید به پیوندهای درون همان مقاله ارجاع داد ({{See above}}و{{See below}}که بر پایه این الگو ساخته شده‌اند، این کار را انجام می‌دهند). اگر پارامتر مستعار به صورت|قابل چاپ=بله(با مقادیر پرشدنی دیگر درست، صحیح، روشن، غیره.) نوشته شود، اثر آن برابر|خودارجاع=خیرخواهد بود. این کار همچنین می‌تواند برای ارجاع متقابل بین صفحات داخلی ویکی‌پدیا مانند دستورالعمل‌ها و خط مشی‌ها استفاده شود. در این مورد هیچ دلیلی برای جلوگیری از نمایش پیوندها وجود ندارد. توجه کنید که این پارامترها هنوز "هوشمند" نیستند و مقادیر مخالف را نشان نمی‌دهند. یعنی مقادیر مخالف|قابل چاپ=خیرو|غیرقابل چاپ=بلهتاثیر دلخواه را ندارند (و از آنجا که|غیرقابل چاپ=پیش‌فرض است در هر صورت زیادی خواهند بود).|درخط=– این یک پارامتر ویژه و مقدار پیش‌فرض آن yes است. اگر مقدار این پارامتر خیر (یا نه، غلط، خاموش، غیره.) وارد شود، جلوی تبدیل<div>به<span>را می‌گیرد و به صورت<div>باقی می‌ماند، بنابراین می‌توانید (مانند یک فهرست) در آن از المان‌های سطح بلوکی استفاده کنید. فرق بین{{ارجاع متقابل|درون‌خطی=خیر|...}}و{{سرنویس|...}}این است که دومی تورفتگی ایجاد نمی‌کند. این رفع تورفتگی توسط قالب‌الگوها (en) و به ویژه الگو:ارجاع متقابل/styles.css انجام می‌شود.
سی‌اس‌اس
[ویرایش]این الگو همیشه کلاس سی‌اس‌اس crossreference را می‌افزاید، بنابراین می‌توانید از سبک‌های کاربری (en) به صورت دلخواه استفاده کنید. احتمالاً فقط در مواردی که می‌خواهید عدم تورفتگی این الگو را زمانی که در حالت بلوکی است لغو کنید (مانند وقتی که می‌خواهید به روشی که {{سرنویس}} عمل می‌کند تورفتگی داشته باشد)، باید از !important استفاده کنید. این کار را به دلخواه خود در ویژه:صفحه من/common.css انجام دهید. این به خاطر این است که سبک‌الگوها پس از بارگیری ترجیحات کاربری بارگیری می‌شوند. بنابراین باید الگوسبک را با استفاده از پرچم اولویت !important غیرفعال کنید.
داده‌های الگو
[ویرایش]الگوداده ارجاع متقابل
نوشته را به یک سبک استاندارد شده برای ارجاع متقابل ویکی‌پدیا از نوع پرانتزی "(جستارهای وابسته ..." (نه در سطح بلوکی) به دیگر موارد ویکی‌پدیا قالب‌بندی می‌کند.
| پارامتر | توضیحات | نوع | وضعیت | |
|---|---|---|---|---|
| متن | متن 1 محتوا | بدون توصیف | ناشناخته | اختیاری |
| قابل چاپ | قابل چاپ خودارجاع | بدون توصیف | بولی | اختیاری |
| کلاس‌های سی‌اس‌اس | کلاس کلاس‌های بیشتر | بدون توصیف | ناشناخته | اختیاری |
| درون‌خطی | درون‌خطی | بدون توصیف | بولی | اختیاری |
مطالب مرتبط
[ویرایش]{{سرنویس درخط}}– فراالگویی که این الگو و الگوهای دیگر از آن استفاده می‌کنند{{See above}}و{{See below}}– زیرمجموعه الگوهای{{ارجاع متقابل}}که تنها در برخی صفحات بکار می‌روند (دارای ارزش نمایش){{الگوهای سرنویس}}– برای الگوهای سرنویس با قالب بلوکی