الگو:Defn

{{{محتویات}}}

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

با الگو:dfn اشتباه نشود.

استفده

{{defn}} در فهرست اصطلاحات‌های ساختاریافته الگو برای ایجاد تعریف برای عبارت‌ها استفاده می‌شود. این الگو بسته‌بندی کننده <dd>...</dd>، تعریف فهرست توضیحات المان HTML است.

استفاده ساده:

{{glossary}}
{{term|1=term}}
{{defn|1=تعریف.}}
{{glossary end}}

پیوندها، الگوهای درون‌خطی، استناد به مراجع، و غیره می‌توانند برای تعریف اعمال شوند. از نظر فنی اگر محتوای تعریف، کاراکتر "=" را نداشته باشد، بخش |1= اختیاری است. از آنجا که هر ویرایشگر می‌تواند محتوا اضافه کند، از جمله الگوهایی که از این کاراکتر در آنها بکار رفته‌اند، همیشه ایمن‌ترین راه این است که به صراحت پارامتر را نامگذاری کنید. اگر شماره‌دهی مهم نیست می‌توانید بجای |1= از |defn= استفاده کنید.

• این، کار خواهد کرد: {{defn|1=این مفهوم که جرم هر چیز متناسب با انرژی آن است با فرمول E=MC² بیان می‌شود}}
• این، کار خواهد کرد: {{defn|defn=این مفهوم که جرم هر چیز متناسب با انرژی آن است با فرمول E=MC² بیان می‌شود}}
• این، کار نخواهد کرد: {{defn|این مفهوم که جرم هر چیز متناسب با انرژی آن است با فرمول E=MC² بیان می‌شود}}

نمونه استفاده پیچیده‌تر از این الگو می‌تواند مانند زیر باشد:

{{defn|1=تعریف. |شماره=# |اصطلاح=term_id}}

در نمونه بالا |شماره=# برای یک تعریف در فهرست تعاریف، یک شماره پیشرو ارائه می‌دهد و |اصطلاح=term_id نام اصطلاح بکار رفته در {{Term}} را مشخص می‌کند که این تعریف به آن مربوط می‌شود.

تصاویر، سرنویس‌ها و محتویات دیگر

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

{{glossary}} {{term |1=colour ball |content=colour ball {{anchor|coloured ball|coloured balls|colour|colours|color ball}}}} {{defn|1= [[File:Set of Snookerballs.png|thumb|left|150px|A complete set of snooker balls, with six '''colour balls''']] {{ghat|Also '''coloured ball(s)''', '''colour(s)'''; American spelling '''color''' sometimes also used.}} In [[snooker]], any of the {{cuegloss|object ball}}s that are not {{cuegloss|red ball|reds}}. }} {{glossary end}}

colour ball A complete set of snooker balls, with six colour balls Also coloured ball(s), colour(s); American spelling color sometimes also used. In snooker, any of the الگو:Cueglosss that are not الگو:Cuegloss.

چندین تعریف برای یک اصطلاح

اگر یک {{term}} چندین تعریف داشته باشد، این تعاریف به راحتی با استفاده از |2=پارامتر صراحتا شماره‌گذاری می‌شوند. پارامتر را به عنوان جایگزینی برای "تعریف دوم یا تعاریف بیشتر" در نظر بگیرید. همچنین می‌توانید (بر پایه en:Numero sign) آنرا |شماره= نیز بنامید. مانند:

{{glossary}} {{term|1=blubbermonster}} {{defn|1=Lorem ipsum dolor sit amet. |شماره=1}} {{defn|1=Consectetur adipisicing elit. |شماره=2}} {{glossary end}}

blubbermonster 1.  Lorem ipsum dolor sit amet. 2.  Consectetur adipisicing elit.

به خاطر طول نابرابر تعاریف، معمولا راحت‌تر است که توضیح |2= پیش از |1= قرار بگیرد:

{{defn |2=1 |1=Lorem ipsum dolor sit amet.}}

یا

{{defn |no=1 |1=Lorem ipsum dolor sit amet.}}

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

استفاده از سرنویس‌های "استاندارد" با یک تعریف شماره‌گذاری‌شده، نیاز به شماره‌گذاری دستی دارد وگرنه عجیب به نظر می‌رسد. اما این روش به هر حال مستهلک شده است. نمونه:

{{term|1=blackjack|content=blackjack{{anchor|Blackjack}} }}
{{defn     |1={{main|Blackjack}}}}
{{defn|no=1|1=A card game in which players attempt to approach 21 but not exceed it.}}
{{defn|no=2|1=The best possible hand in the game of blackjack, made up of an ace and a card valued at 10 (namely, 10, J, Q, K). }}

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

ایجاد تعریفی که به طور مستقل قابل پیوند است

بروزرسانی HTML5:

بیشتر محدودیت‌های محتوای id برداشته شده‌اند، بنابراین مقادیر id دیگر نیاز ندارند با یک حرف الفبای [a-z][A-Z] آغاز شوند، بیشتر نشانه‌های نقطه‌گذاری را نادیده بگیرید یا محدودیت‌های دیگری را متحمل شوید. موتور مدیاویکی ویکی‌پدیا به اندازه کافی هوشمند هست تا هنگام اجرا هر گونه کاراکتر مشکل‌زا را رد کند.

برای فعال کردن مستقیم یک پیوند به یک تعریف خاص، آن تعریف را با {{term}} خود نامگذاری کنید (یا باید |شناسه=foo باشد، هر کدام که در {{term}} استفاده شدند). این باید برای هر اصطلاح در صفحه یکتا باشد، اما برای تعاریف متعدد از همان اصطلاح باید یکسان باشد). این کار با پارامتر |اصطلاح= در {{defn}}} انجام می‌شود. این کار یک پیوند شناسه هدف #- به صورت اصطلاح-defn# ایجاد می‌کند که # شماره تعریف و مقدار پیش‌فرض آن برابر ۱ است (#چندین تعریف برای یک اصطلاح در بالا را ببینید). نمونه:

{{glossary}} {{term|1=blubbermonster}} {{defn|no=1 |1=Lorem ipsum dolor sit amet. |term=blubbermonster}} {{defn|no=2 |1=Consectetur adipisicing elit. |term=blubbermonster}} {{term|1=snorkelweasel (noun)}} {{defn|1=Ut enim ad minim veniam |term=snorkelweasel (noun)}} {{glossary end}}

blubbermonster 1.  Lorem ipsum dolor sit amet. 2.  Consectetur adipisicing elit. snorkelweasel (noun) Ut enim ad minim veniam

HTML output: <dl class="glossary"> <dt class="glossary" id="blubbermonster" style="margin-top: 0.4em;"><dfn class="glossary">blubbermonster</dfn></dt> <dd class="glossary" id="blubbermonster-defn1">1.&nbsp;&nbsp;Lorem ipsum dolor sit amet.</dd> <dd class="glossary" id="blubbermonster-defn2">2.&nbsp;&nbsp;Consectetur adipisicing elit.</dd> <dt class="glossary" id="snorkelweasel_(noun)" style="margin-top: 0.4em;"><dfn class="glossary">snorkelweasel (noun)</dfn></dt> <dd class="glossary" id="snorkelweasel_(noun)-defn1">Ut enim ad minim veniam</dd> </dl>

توجه کنید هنگامیکه مدیاویکی شناسه (ID) را به عنوان snorkelweasel_.28noun.29-defn1 مرورگر می‌فرستد، برخی کاراکترهای snorkelweasel (noun) در حین اجرا توسط مدیاویکی تبدیل می‌شوند. شما هنوز می‌توانید در این صفحه به آن به عنوان #snorkelweasel (noun)-defn1 پیوند دهید. (منابع صفحه را ببینید و خودتان ببینید که پیوند href=#snorkelweasel_.28noun.29-defn1 دارد.)

شناسه‌های (ID) blubbermonster-defn1، blubbermonster-defn2، و snorkelweasel_(noun)-defn1 مانند [[:en:Glossary of weird terms#blubbermonster-defn1 ]] همگی به صورت جداگانه قابل پیونددهی هستند. این موضوع به‌ویژه مانند See also [[#blubbermonster-defn2|"blubbermonster", sense 2]]. برای منابع مشترک در فهرست اصطلاحات‌ مفید است.

برای افزودن بیش از یک لنگر (anchor) قابل پیوند، از {{anchor}} در آغاز محتوای تعریف استفاده کنید:

{{defn|no=2|1={{anchor|elit|Elit}}Consectetur adipisicing elit.|term=blubbermonster}}

زبان‌ها

در این الگو پارامتر |زبان= وجود ندارد. برای استفاده از نشانه‌گذاری فهرست اصطلاحات‌ برای اهداف غیر فهرست اصلاحات که گاهی به یک زبان دیگر است از الگوهای زبان استفاده کنید. مانند فهرست ترجمه‌های عنوان فیلم که با نشانه‌گذاری فهرست اصلاحات، قالب‌بندی شده است:

{{glossary}}
{{term|1=Titles of La Vie en Rose in various languages |content=Titles of ''[[La Vie en Rose]]'' in various languages}}
{{defn|1=French: ''{{lang|fr|La Vie en Rose}}''}}
{{defn|1=English: ''Life in Pink''}}
...
{{glossary end}}

نمونه‌ها

این نمونه، هر دو صورت ساده و کمی پیچیده را نشان می‌دهد:

نشانه‌گذاری

== A–M == {{glossary}} {{term|1=applesnorkel}} {{defn|1=Definition of term 1.}} {{term|term=arglefarst |content={{lang|xx|arglefarst}}{{anchor|argle-farst|argle farst}} }} {{defn|no=1 |defn= Beginning of first definition of term 2 {{quote|1=Block quotation in first definition of term 2.}} Conclusion of first definition of term 2. }} {{defn|no=2 |defn=Second definition of term 2.}} {{glossary end}}

خروجی

A–M applesnorkel Definition of term 1. arglefarst 1.  Beginning of first definition of term 2 Block quotation in first definition of term 2. Conclusion of first definition of term 2. 2.  Second definition of term 2.

اعمال سبک‌های سی‌اس‌اس به تعریف

پارامتر |سبک= سبک‌بندی سی‌اس‌اس را به المان <dd> اعمال می‌کند (مانند |style=font-family:serif; یا هر چیز دیگری). یعنی خودِ تعریف را سبک‌بندی می‌کند و اصطلاحی را که تعریف، اعمال می‌کند، یا تعاریف دیگر، یا فهرست اصطلاحات‌ را به صورت کلی سبک‌بندی نمی‌کند. این ویژگی به ندرت در متن جستار بکار می‌رود، اما می‌تواند در جای دیگر برای مواردی مانند مطابقت با سبک دلخواه صفحه کاربر، مفید باشد.

پارامترهای دیگر

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

|کلاس= یک یا دو کلاس سی‌اس‌اس با فاصله از هم جدا شده را به المان <dd> منتقل می‌کند. به ندرت دلیلی برای این کار وجود دارد.

توجه: با استفاده از TemplateStyles در {{glossary}} (که برچسب <dl> را تولید می‌کند)، این الگو دیگر به طور پیش‌فرض کلاس فهرست اصطلاحات‌ را در بر نمی‌گیرد.

پیوندهای مرتبط

• {{glossary}} الگو:Aka {{glossary start}} یا {{glossary begin}} – نیمی از جفت الگو؛ از <dl> با یک کلاس استفاده کنید تا یک فهرست تعریف از فهرست اصطلاحات ساختاریافته را باز کرده و با {{glossary end}} ببندید.
• {{glossary end}} – نیمه دیگر جفت الگو؛ از </dl> استفاده می‌کند تا فهرست تعریف را که {{glossary}} باز کرده، ببندد.
• {{term}} – اصطلاح فهرست اصطلاحات که {{defn}} اعمال می‌کند؛ یک <dt> دلخوا با یک کلاس با یک <dfn> جاسازی شده.
• {{defn}} – تعریفی که به {{term}} اعمال می‌شود؛ با یک کلاس <dd> استفاده کنید.
• {{ghat}} – یک الگوی سرنویس که به خوبی برای قرارگیری در بالای تعریف {{defn}} قالب‌بندی نشده است.
• {{glossary link}} – فراالگو برای ایجاد الگوهای میانبر برای پیوند دادن به تعاریف در فهرست اصطلاحات‌های خاص
• en:Wikipedia:Manual of Style/Glossaries

توضیحات بالا تراگنجانده‌شده از الگو:Defn/توضیحات است. (ویرایش | تاریخچه)
ویرایشگران می‌توانند در صفحات تمرین (ایجاد | آینه) و آزمایشی (ایجاد) این الگو را آزمایش کنند.
لطفاً رده‌ها را به زیرصفحهٔ /توضیحات بیفزایید. زیرصفحه‌های این الگو.