سانچو:Ambox

سانچي جي دستاويز[ڏسو] [ترميم] [تاريخ] [تازو ڪريو]

پيغام خاني ميٽا-سانچا
سانچو	حوالا
{{Ambox}}	مضمون
{{Cmbox}}	زمرو
{{Imbox}}	تصوير
{{Tmbox}}	ڳالهيون
{{Fmbox}}	فوٽر / هيڊر
{{Ombox}}	ٻيا صفحا
{{Mbox}}	خودڪار سڃاڻپ
{{Asbox}}	مضمون اسٽب
{{Dmbox}}	ابهمي صفحو

{{Ambox}} جو مطلب آهي Article message box، جيڪو هڪ ميٽا سانچو آهي. اهو مضمونن ۾ استعمال ٿيندڙ پيغام باڪس سانچا ٺاهڻ لاءِ استعمال ٿيندو آهي، جهڙوڪ {{underlinked}}. اهو ڪيترائي مختلف رنگ، تصويرون، ۽ ڪجهه ٻيون خاصيتون مهيا ڪري ٿو.

بنيادي استعمال

هيٺ ڏنل باڪس {{Ambox}} طرفان قبول ڪيل سڀ کان عام پيراميٽر ڏيکاري ٿو. هر هڪ جو مقصد هيٺ بيان ڪيو ويو آهي.

{{Ambox
| name  = {{subst:PAGENAME}}{{subst:void|هن لائين ۾ ڪجهه به نه بدلايو. محفوظ ڪرڻ بعد اهو پاڻ تبديل ٿي ويندو.}}
| subst = <includeonly>{{subst:substcheck}}</includeonly> <!-- ضروري -->
| small = {{{small|}}}
| type  = 
| image = 
| sect  = {{{1|}}}
| issue = <!-- ضروري -->
| talk  = {{{talk|}}}
| fix   = <!-- ضروري -->
| date  = {{{date|}}}
| cat   = 
| all   = 
}}

مڪمل استعمال

سڀئي پيراميٽر

"سڀئي پيراميٽر" وارو باڪس هن سانچي جا سڀ ممڪن پيراميٽر ڏيکاري ٿو. پر ان کي نقل ڪرڻ جي صلاح نه ڏني وڃي ٿي، ڇو ته هڪ ئي وقت سڀ پيراميٽر استعمال ڪرڻ جي ڪڏهن به ضرورت نه پوندي.

سڀئي پيراميٽر

{{Ambox | name = {{subst:PAGENAME}}{{subst:void|هن لائين ۾ ڪجهه به نه بدلايو. محفوظ ڪرڻ بعد اهو پاڻ تبديل ٿي ويندو.}} | subst = <includeonly>{{subst:substcheck}}</includeonly> <!-- ضروري --> | small = {{{small|}}} | type = | image = | imageright = | smallimage = | smallimageright = | class = | style = | textstyle = | sect = {{{1|}}} | issue = <!-- ضروري --> | talk = {{{talk|}}} | fix = <!-- ضروري --> | date = {{{date|}}} | text = | smalltext = | plainlinks = no | removalnotice = | cat = | all = | cat2 = | all2 = | cat3 = | all3 = }}

عام پيراميٽر

name

name پيراميٽر سانچي جو نالو ٻڌائي ٿو، بغير Template نيم اسپيس جي prefix جي. مثال طور {{Underlinked}} ۾ |name=Underlinked استعمال ٿيندو آهي.

جيڪڏهن سانچو ڪڏهن منتقل ڪيو وڃي ته هن پيراميٽر کي به اپڊيٽ ڪرڻ گهرجي. هن پيراميٽر جا ٻه مقصد آهن:

• جيڪڏهن سانچو غلط نموني substitute ڪيو وڃي، ته هي meta-template ان substituted سانچي جو نالو ڏيکاري سگهي ٿو، جيڪو ايڊيٽرن کي مسئلو درست ڪرڻ ۾ مدد ڏئي سگهي ٿو.
• اهو سانچي کي پنهنجي ئي صفحي تي وڌيڪ مفيد نموني ڏيکارڻ جي اجازت ڏئي ٿو، مثال طور تاريخ ڏيکارڻ جيتوڻيڪ اها ڏنل نه هجي، ۽ سانچي کي پاڻ به مناسب زمري ۾ شامل ڪرڻ.

subst

ضروري subst پيراميٽر meta-template کي اهو سڃاڻڻ ڏئي ٿو ته سانچو غلط substitute ٿيو آهي يا نه، ۽ اهڙي حالت ۾ مناسب خبرداري ڏيکاري ٿو. اهو اهڙن صفحن کي Category:Pages with incorrectly substituted templates ۾ به شامل ڪري ٿو. بس ڪوڊ کي ساڳي نموني نقل ڪريو جيئن #Basic usage ۾ ڏنل آهي.

small

small پيراميٽر کي سانچي مان pass through ڪرڻ گهرجي، ڇو ته ان سان ايڊيٽر مضمون تي |small=left ڏئي ننڍو فارميٽ استعمال ڪري سگهندا:

ٻي صورت ۾ معياري فارميٽ پيدا ٿيندو:

ٻيون صورتون:

• انهن سانچن لاءِ جيڪي ڪڏهن به ننڍا نه هجڻ گهرجن، |small=no ڏيو يا small پيراميٽر کي pass نه ڪريو.
• انهن سانچن لاءِ جيڪي هميشه ننڍا هجڻ گهرجن، سڌو |small=left ڏيو.
• انهن سانچن لاءِ جيڪي ڊفالٽ طور ننڍا هجن، |small={{{small|left}}} آزمايو. اهڙي صورت ۾ ايڊيٽر |small=no ڏئي ان کي override ڪري سگهي ٿو.

اهڙو ننڍو باڪس ٺاهڻ لاءِ جيڪو متن مطابق پنهنجي ويڪر ترتيب ڏئي، |style=width: auto; margin-right: 0px; ۽ |textstyle=width: auto; گڏ استعمال ڪريو:

§ sect هيٺ وڌيڪ معلومات ڏسو ته |small= کي صرف انهن حالتن تائين ڪيئن محدود ڪجي جتي سانچو سڄي مضمون بدران ڪنهن سيڪشن لاءِ استعمال ٿي رهيو هجي (هي صلاح ڏنل آهي، ته جيئن مضمون جي چوٽيءَ تي ڏيک هڪجهڙو رهي).

type

type پيراميٽر کاٻي پاسي واري بار جو رنگ طئي ڪري ٿو، ۽ اها ڊفالٽ تصوير چونڊي ٿو جيڪا استعمال ڪئي ويندي. type کي ظاهري خوبصورتي نه پر ان مسئلي جي نوعيت موجب چونڊيو وڃي جيڪو سانچو ظاهر ڪري ٿو. هيٺ ست دستياب قسمن ۽ انهن جون ڊفالٽ تصويرون ڏيکاريل آهن.

جيڪڏهن type پيراميٽر نه ڏنو وڃي ته ڊفالٽ |type=notice ٿيندو.

image

image پيراميٽر سان توهان سانچي لاءِ خاص تصوير چونڊي سگهو ٿا. تصويرون وڪيپيڊيا ۾ فائيل شامل ڪرڻ جي معياري syntax سان ڏنيون وينديون آهن (ڏسو Wikipedia:Manual of Style/Images#How to place an image.) 40-50px ويڪر عام هوندي آهي. مثال طور:

• {{POV}} ۾ |image=[[File:Unbalanced scales.svg|40px|link=|alt=]] استعمال ٿيندو آهي ۽ هيئن نظر اچي ٿو:

• {{underlinked}} ۾ |image=[[File:Ambox wikify.svg|50x40px|link=|alt=]] استعمال ٿيندو آهي ۽ هيئن نظر اچي ٿو:

مهرباني ڪري نوٽ ڪريو:

• جيڪڏهن ڪا تصوير نه ڏني وڃي ته type مطابق ڊفالٽ تصوير استعمال ٿيندي. (مٿي #type ڏسو.)
• جيڪڏهن |image=none ڏنو وڃي ته ڪا تصوير استعمال نه ٿيندي ۽ متن سڄو پيغام باڪس ڀري ڇڏيندو.
• جيڪڏهن آئڪن رڳو سجاوٽي هجي ۽ public domain ۾ هجي، ته "|link=|alt=" شامل ڪري file page ڏانهن لنڪ لڪائي رسائي پذيري بهتر بڻائي سگهجي ٿي.

sect

گهڻا مضموني پيغام سانچا This article ... سان شروع ٿيندا آهن، ۽ اڪثر اهو ضروري هوندو آهي ته جيڪڏهن سانچو ڪنهن سيڪشن تي لڳايو وڃي ته اهو This section ... ٿي وڃي. هن پيراميٽر جي قيمت لفظ "article" جي جاءِ وٺندي. مثال: |sect=list، |sect=table، |sect="In popular culture" material وغيره.

جيڪڏهن هي خاصيت استعمال ڪري رهيا آهيو ته سانچي جي متن مان شروعاتي ٻه لفظ ("This article") ضرور هٽايو، نه ته اهي ٻيهر ظاهر ٿيندا.

هن سهولت لاءِ عام طريقو |sect={{{1|}}} pass ڪرڻ آهي. ان سان ايڊيٽر سانچي جي پهرين بغير نالي واري پيراميٽر ۾ section وغيره ڏئي لفظن کي بدلائي سگهندا. مثال طور {{Promotional|section}} هن ريت نتيجو ڏئي ٿو: سانچو:Promotional ٻيو طريقو |sect={{{section|{{{sect|}}}}}} pass ڪرڻ آهي ته named value به ملي. ٽيون طريقو {{Yesno}} استعمال ڪري مثبت value کي parse ڪرڻ ۽ سچو هجڻ تي |sect=section pass ڪرڻ آهي.

اهي طريقا گڏ ڪري به استعمال ڪري سگهجن ٿا، ۽ اهو ئي صلاح ڏنل آهي. هي تيار ڪوڊ:

| sect = {{#ifeq:{{yesno|def=|1={{{sect|{{{section}}}}}} }}|yes|section|{{{sect|{{{section|{{{1|}}}}}}}}} }}

هيٺين ڳالهين کي ممڪن بڻائي ٿو:

• {{Yesno}} جنهن به مثبت value کي سڃاڻي، اها ambox تي ٻڌل سانچي ۾ "article" بدران "section" آڻيندي: |section=y، |sect=True وغيره. صلاح آهي ته |sect= ۽ |section= ٻئي قبول ڪيا وڃن. مٿيون ڪوڊ اهو ڪري ٿو.
• ٻي ڪا به ڏنل value، جنهن به طريقي سان ڏني وڃي، "article" جي جاءِ وٺندي: |section and its subsections، |1=list، |sect=section، |section=table وغيره.

هي به مناسب آهي ته |small= کي صرف تڏهن ڪم ڪرڻ ڏنو وڃي جڏهن سانچو سڄي مضمون بدران ڪنهن سيڪشن وغيره تي لڳايو ويو هجي، جيئن سڄي مضمون جي مٿي ننڍو باڪس نه اچي:

| small = {{#if:{{{sect|{{{section|{{{1|}}}}}}}}}|{{#if:{{{small|{{{left|}}}}}}|left}} }}

(هن صورت ۾، |small= يا |left= جي ڪا به value ننڍو، کاٻي پاسي وارو ڏيک فعال ڪندي، بشرطيڪه |sect= يا ان جي aliases مان ڪا به value ڏنل هجي.) هي ڪوڊ مٿي واري ڪوڊ سان گڏ نقل ڪري استعمال ڪري سگهجي ٿو. مثال لاءِ Template:Trivia ۽ ان جا Template:Trivia/testcases ڏسو.

issue ۽ fix

ضروري issue پيراميٽر مضمون جي مسئلي جي وضاحت لاءِ هوندو آهي. ڪوشش ڪريو ته اهو مختصر ۽ سڌو هجي (تقريباً 10-20 لفظ) ۽ ڪنهن لاڳاپيل policy يا guideline ڏانهن لنڪ ضرور ڏيو.

ضروري fix پيراميٽر ۾ اهو متن هوندو آهي جيڪو ٻڌائي ته مضمون کي بهتر ڪرڻ لاءِ ڇا ڪرڻ گهرجي. اهو issue کان ڊگهو ٿي سگهي ٿو، پر عام طور ٻن جملن کان وڌيڪ نه هئڻ گهرجي.

جڏهن سانچو compact فارم ۾ هجي (مثال طور {{multiple issues}} جي اندر) يا small فارم ۾ هجي (|small=left سان)، ته فقط issue ڏيکاريو ويندو. مثال طور، {{Citation style}} ۾:

• |issue=هي مضمون '''غير واضح حوالا انداز''' رکي ٿو.
• |fix=استعمال ٿيل حوالن کي [[Wikipedia:Citing sources|citation]]، [[Wikipedia:Footnotes|footnoting]]، يا [[Wikipedia:External links|external linking]] جي مختلف يا هڪجهڙي انداز سان وڌيڪ واضح بڻائي سگهجي ٿو.

اڪيلو استعمال ٿيڻ تي اهو مڪمل متن ڏيکاريندو:

پر جڏهن {{Multiple issues}} جي اندر يا |small=left سان استعمال ٿئي، ته فقط issue ڏيکاريندو:

talk

ڪجهه مضموني پيغام سانچا talk page ڏانهن لنڪ شامل ڪندا آهن، ۽ ايڊيٽر کي اهو به اجازت ڏيندا آهن ته هو ڪنهن خاص heading ڏانهن سڌو لنڪ ڏئي. ان لاءِ بس talk پيراميٽر pass through ڪريو، يعني |talk={{{talk|}}}

پوءِ ايڊيٽر هن کي هن طريقي سان استعمال ڪري سگهندو:

• |talk=SECTION HEADING – لنڪ مضمون جي talk page جي مقرر ڪيل سيڪشن ڏانهن ويندي، مثال: |talk=Foo
• |talk=FULL PAGE NAME – سانچو ڏنل صفحي ڏانهن لنڪ ڪندو (جيڪو section anchor به رکي سگهي ٿو)، مثال: |talk=Talk:Banana#Foo

نوٽ:

• جڏهن هي پيراميٽر سانچي ۾ شامل هوندو، ته talk page لنڪ سانچي تي به نظر ايندي (ڪارڪردگي ڏيکارڻ لاءِ)، پر مضمونن تي اها فقط تڏهن ظاهر ٿيندي جڏهن پيراميٽر واقعي ڏنو ويو هجي.
• هميشه talk page جي لنڪ رکڻ لاءِ |talk={{{talk|#}}} استعمال ڪري سگهجي ٿو.
• جيڪڏهن talk page موجود نه هجي ته لنڪ نه ايندي، ڀلي پيراميٽر جي value ڪهڙي به هجي.

date

date پيراميٽر کي meta-template ڏانهن pass ڪرڻ جو مطلب آهي ته مضمون تي ٽئگ لڳڻ جي تاريخ ايڊيٽر (يا عام طور bot) ڏئي سگهي ٿو. اها پيغام کان پوءِ ننڍي فونٽ ۾ ڏيکاري ويندي.

هي پيراميٽر pass ڪرڻ سان، جيڪڏهن cat پيراميٽر به ڏنل هجي، ته مهيني وار صفائي واري زمري بندي به فعال ٿيندي.

info

هي پيراميٽر اضافي معلومات ڏيڻ لاءِ آهي. هتي جيڪو به شامل ڪيو ويندو اهو تاريخ کان پوءِ ظاهر ٿيندو، ۽ جيڪڏهن سانچو {{multiple issues}} ۾ لپاٽيل هجي ته اهو نه ڏيکاريو ويندو.

removalnotice

جيڪڏهن |removalnotice=yes ڏنو وڃي، ته تاريخ ۽ info متن کان پوءِ هي نوٽيس ڏيکاريو ويندو:

• سکو ته هي سانچو پيغام ڪڏهن ۽ ڪيئن هٽائجي.

جيڪڏهن سانچو {{multiple issues}} ۾ لپاٽيل هجي ته اهو ڏيکاريو نه ويندو.

cat

هي پيراميٽر مهيني وار صفائي جي زمري کي طئي ڪري ٿو. جيڪڏهن |cat=CATEGORY ڏنو وڃي ته:

• جيڪڏهن |date=DATE ڏنل هجي ته مضمون Category:CATEGORY from DATE ۾ ويندو.
• جيڪڏهن date نه ڏنل هجي ته مضمون Category:CATEGORY ۾ ويندو.

مثال طور، {{No footnotes}} ۾ |cat=Articles lacking in-text citations ڏنو وڃي ٿو، تنهن ڪري {{No footnotes|date=June 2010}} وارو مضمون Category:Articles lacking in-text citations from June 2010 ۾ ويندو.

cat پيراميٽر ۾ لنڪ نه ڏيو، ۽ نه ئي Category: prefix استعمال ڪريو.

all

all پيراميٽر اهو زمرو طئي ڪري ٿو جنهن ۾ سڀ مضمون شامل ڪيا وڃن.

all پيراميٽر ۾ لنڪ نه ڏيو، ۽ نه ئي Category: prefix استعمال ڪريو.

اضافي پيراميٽر

imageright

هن پيراميٽر سان پيغام باڪس جي ساڄي پاسي تصوير ڏني وڃي ٿي. syntax ساڳي آهي جيڪا image پيراميٽر لاءِ آهي، فرق رڳو اهو ته هتي ڊفالٽ طور ڪا تصوير نه هوندي.

smallimage ۽ smallimageright

ننڍي فارميٽ واري باڪس لاءِ تصويرون هنن پيراميٽرن سان ڏئي سگهجن ٿيون. اهي فقط تڏهن اثر ڪندا جڏهن |small=left ڏنو ويو هجي.

class

باڪس تي لاڳو ڪرڻ لاءِ ڪسٽم CSS classes. جيڪڏهن هڪ کان وڌيڪ class شامل ڪيون وڃن ته انهن جي وچ ۾ خالي جاءِ هجي.

style ۽ textstyle

اختياري CSS values ڏنيون وڃي سگهن ٿيون، بغير quotation marks " " جي، پر آخر ۾ semicolon ; هجڻ گهرجي.

• style پوري پيغام باڪس ٽيبل تي لاڳو ٿيندو. مثال طور باڪس جي ويڪر بدلائڻ لاءِ.
• textstyle متن واري سيل تي لاڳو ٿيندو.

text ۽ smalltext

issue ۽ fix ڏيڻ بدران text پيراميٽر به استعمال ڪري سگهجي ٿو.

ننڍي فارميٽ لاءِ حسب ضرورت متن smalltext سان ڏنو وڃي ٿو.

plainlinks

عام طور وڪيپيڊيا ۾ خارجي لنڪن سان گڏ هڪ تير وارو آئڪن هوندو آهي، جهڙوڪ: Example.com. پر message boxes ۾ هي آئڪن ڊفالٽ طور لڪايو ويندو آهي، جهڙوڪ: Example.com. عام خارجي لنڪ وارو انداز واپس آڻڻ لاءِ |plainlinks=no استعمال ڪريو.

cat2, cat3, all2, ۽ all3

• cat2 ۽ cat3 اضافي مهيني وار زمرا فراهم ڪن ٿا؛ ڏسو #cat.
• all2 ۽ all3 اضافي اهڙا زمرا فراهم ڪن ٿا جن ۾ سڀ مضمون شامل ڪيا وڃن، بلڪل #all وانگر.

فني نوٽس

• جيڪڏهن text پيراميٽر ۾ خاص اکر استعمال ڪرڻا هجن ته انهن کي هن طريقي سان escape ڪرڻو پوندو:

{{Ambox
|nocat=true
| text  = <div>
Equal sign = ۽ شروعاتي ۽ پڇاڙي واري brace { } ٺيڪ ڪم ڪن ٿا.
پر هتي هڪ pipe &#124; ۽ ٻه پڇاڙي واري braces <nowiki>}}</nowiki> آهن.
۽ هاڻي هڪ pipe ۽ end braces <nowiki>|}}</nowiki>.
</div>
}}

• مٿي ڏنل مثال ۾ متن جي چوڌاري <div> ٽيگ عام طور ضروري نه هوندا آهن. پر جيڪڏهن متن ۾ line breaks هجن ته ڪڏهن ڪڏهن عجيب spacing اچي سگهي ٿي، خاص طور عمودي dotted lists ۾. اهڙي حالت ۾ div ٽيگ استعمال ڪري مسئلو حل ڪريو.
• هن meta-template جون ڊفالٽ تصويرون svg بدران png فارميٽ ۾ آهن. مکيه سبب اهو آهي ته ڪجهه پراڻا برائوزر انهن svg تصويرن جي transparent background سان مسئلو ڪن ٿا. هتي png تصويرن جو transparent background هٿ سان بهتر ڪيو ويو آهي ته جيئن سڀني برائوزرن ۾ سٺو لڳي. ياد رکو ته svg آئڪن صرف پراڻن برائوزرن ۾ ٿورو خراب نظر ايندا آهن، تنهنڪري اهڙي هٿرادو بهتري فقط تمام گهڻو استعمال ٿيندڙ آئڪن لاءِ ئي مناسب آهي.
• وڌيڪ فني تفصيل لاءِ ڳالهه ٻولهه وارو صفحو ۽ هيٺ "See also" جا لنڪ ڏسو. ڇاڪاڻ ته هي سانچو تقريباً {{Tmbox}}, {{Imbox}}, {{Cmbox}} ۽ {{Ombox}} وانگر ئي ڪم ڪري ٿو، انهن جا talk pages ۽ لاڳاپيل صفحا به وڌيڪ تفصيل رکي سگهن ٿا.

موبائل ڊوائيسز تي ڏيک

سانچو:Needs update 2018 ۽ 2019 ۾، MediaWiki ڊولپرز وڪيپيڊيا جي موبائل نسخي ۾ ambox جي استعمال بابت readability studies ڪيون. موبائل نسخي تي ڊولپرز طرفان لڳايل ڪوڊ عام طور هتي اسان جي display ۽ layout سان لاڳاپيل سيٽنگن کي override ڪندو. تاريخي معلومات لاءِ ڏسو MW:Reading/Web/Projects/Mobile Page Issues.

اهي سانچا جيڪي Ambox کي custom تصوير سان استعمال ڪن ٿا، انهن جي اها custom تصوير موبائل تي هڪ عام آئڪن سان تبديل ڪئي ويندي.

سار سنڀال وارا زمرا

• Category:Article message templates with missing parameters (25) – انهن سانچن لاءِ جن ۾ |subst=, |issue=, ۽ |fix= مان هڪ يا وڌيڪ غائب هجن

مٿيون دستاويز سانچو:Ambox/doc مان شامل ڪيو ويو آهي. (ترميم | تاريخ)
ايڊيٽر هن سانچي جي sandbox (ٺاهيو | نقل) ۽ آزمائشي ڪيس (ٺاهيو) صفحن ۾ آزمائش ڪري سگهن ٿا.
/doc ذيلي صفحي ۾ زمرا شامل ڪريو. هن سانچي جا ذيلي صفحا.