سانچو:Ref

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

هي دستاويز {{ref}}، {{note}}، {{ref label}} ۽ {{note label}} سانچن لاءِ آهي۔ note سانچا مضمون ۾ نوٽ شامل ڪن ٿا، ۽ ref سانچا انهن نوٽن ڏانهن نالي وارا حوالا رکن ٿا، جتي اهي نالا عام طور هائپرلنڪ هوندا آهن ته جيئن ref کان note ڏانهن ۽ وري note کان ref ڏانهن اچ وڃ ڪري سگهجي۔ label وارا ٻئي سانچا، بغير label وارن سانچن سان ملندڙ جلندڙ آهن، پر وڌيڪ خاصيتون رکن ٿا۔

لنڪ ۽ back-link اندروني طور ڏنل پيرا ميٽرن کي گڏ ڪري سڃاتا ويندا آهن۔ هي سانچا ڪيترائي بي نالا پيرا ميٽر قبول ڪن ٿا، جيڪي پنهنجي جاءِ مطابق سڃاتا ويندا آهن۔ هي هڪ نالي وارو پيرا ميٽر پڻ قبول ڪن ٿا (noid نالي)، جيڪو پنهنجي شروعات کان ئي deprecated آهي۔

{{ref}} جو پهريون پيرا ميٽر هڪ label آهي، جيڪو لاڳاپيل {{note}} ۾ به استعمال ٿيڻ گهرجي۔ اهو label فوٽ نوٽ لنڪ ۽ back link لاءِ fragment identifier ٺاهڻ ۾ ڪم ايندو آهي۔ {{ref}} جو ٻيو پيرا ميٽر فوٽ نوٽ حوالو نشان آهي، جيڪو superscript جي صورت ۾ ڏيکاريو ويندو آهي۔ سڀ کان آسان طريقو اهو آهي ته اهي ٻئي ساڳيا هجن، پر اهو لازمي ناهي۔ جيڪڏهن ٻيو پيرا ميٽر نه ڏنو وڃي، ته نشان [n] جهڙي superscript ٿيل external link هوندي۔

نحو

هيٺ هر سانچي جي عام نحو ڏيکاريل آهي:

• {{ref|id|label|noid=noid}}
• {{note|id|label|text}}
• {{ref label|id|label|backlink|noid=noid}}
• {{note label|id|label|backlink|text}}

هر پيرا ميٽر جي وضاحت هي آهي:

id

نوٽ ۽ ان جي back link لاءِ سڃاڻپ (لازمي)۔ هي {{ref}} ۽ {{note}} جي جوڙي لاءِ واحد لازمي پيرا ميٽر آهي، جنهن سان سادا فوٽ نوٽ شامل ڪري سگهجن ٿا۔

اهم نوٽ: هر {{ref}} ۽ {{note}} جي جوڙي، ۽ هر {{ref label}} ۽ {{note label}} جي جوڙي ۾ منفرد id هجڻ گهرجي۔ اهو تڏهن به لاڳو ٿئي ٿو جڏهن ڪيترائي حوالا هڪ ئي فوٽ نوٽ ڏانهن اشارو ڪرڻا هجن۔ (هن خاصيت کي صحيح نموني لاڳو ڪرڻ جو طريقو – label پيرا ميٽر استعمال ڪندي – هيٺ ڏيکاريو ويو آهي۔) ساڳيا id غلط ڪوڊ پيدا ڪن ٿا، ۽ ويب برائوزر ان تي مختلف نموني ردعمل ڏيکارين ٿا۔ ڪجهه برائوزر غلطيون ڏيکارين ٿا، ۽ ڪجهه هڪ id رکن ٿا ۽ ٻيا خاموشي سان ختم ڪري ڇڏين ٿا۔ هر حالت ۾، ڪجهه فوٽ نوٽ نشانن ۽ انهن جي متن جي وچ ۾ navigation صحيح نه ٿيندي۔ ڏسو Help:Markup validation۔

id جو مثال

ڪوڊ	نتيجو
Text that requires a footnote.{{ref|a}} ==Notes== :1.{{note|a}}Body of the footnote.	Text that requires a footnote. Notes 1.^ Body of the footnote.

label

اهو label متن جيڪو انهن سانچن جي جڳهه تي ڏيکاريو ويندو آهي ({{ref label}} ۽ {{note label}} لاءِ لازمي)۔ هيٺ هر سانچي جو مخصوص رويو بيان ٿيل آهي:

• {{ref}}، {{ref label}} ۽ {{note label}} ۾ label superscript جي صورت ۾ ڏيکاريو ويندو آهي؛ {{note}} ۾ label عام سائيز واري baseline bold متن طور ڏيکاريو ويندو آهي۔
• {{ref}}، {{ref label}} ۽ {{note}} ۾ label هائپرلنڪ پڻ هوندو آهي ۽ inline footnote marker ۽ ان جي متن جي وچ ۾ اچ وڃ ۾ مدد ڪندو آهي۔ پر {{note label}} ۾ label سان هائپرلنڪ نه لڳندي، ۽ جڏهن backlink پيرا ميٽر موجود هجي ته هي پيرا ميٽر نظرانداز ڪيو ويندو۔
• {{ref label}} ۾ label هميشه bracket ۾ بند هوندو آهي۔

label جو مثال

ڪوڊ	نتيجو
Text alpha.{{ref|Alpha|α}} Text beta.{{ref label|Beta|β}} ==Notes== :{{note|Alpha|α}} Information on alpha :{{note label|Beta|β}} Information on beta	Text alpha. Text beta. Notes ^α Information on alpha β Information on beta

هي پيرا ميٽر {{ref}} ۽ {{note}} ۾ اختياري آهي، تنهنڪري:

• {{ref}} جيڪڏهن هي پيرا ميٽر نه ڏنو وڃي ته square brackets ۾ هڪ منفرد نمبر ڏيکاريندو آهي۔
• {{note}} هن label کي back-linked caret (^) سان جوڙيندو آهي، تنهنڪري جيڪڏهن هي ڇڏجي وڃي ته رڳو caret ڏيکاريو ويندو آهي۔

اهو لازمي ناهي ته هي پيرا ميٽر ref ۽ note ٻنهي ۾ گڏ شامل هجي۔ ڪڏهن ڪڏهن ان جو ابتڙ ضروري هوندو آهي۔ هي مثال ڏيکاري ٿو ته {{ref}} ۽ {{note}} کي ڪيئن هڪجهڙي ظاهر وارن ڪيترن فوٽ نوٽ نشانن کي هڪ ئي نوٽ سان ڳنڍڻ لاءِ استعمال ڪيو وڃي۔

label جو مثال: ڪيترن کان هڪ ڏانهن ڳانڍاپو

ڪوڊ	نتيجو
... The reunification project started in 1959 and concluded in 1961. The outcome of the project was instrumental in the company's success.{{ref|Lewinsky1|A}} ... ... The consolidation efforts in 1992 had a huge impact on the company's success.{{ref|Lewinsky2|A}} ... ... The final development stage set the cornerstone for company's future activities.{{ref|LewinskyFinal|A}}... ==Notes== :A.{{note|Lewinsky1}}{{note|Lewinsky2}}{{note|LewinskyFinal}}See Brown, Lewinsky and Hart, 2009.	... The reunification project started in 1959 and concluded in 1961. The outcome of the project was instrumental in the company's success. ... ... The consolidation efforts in 1992 had a huge impact on the company's success. ... ... The final development stage set the cornerstone for company's future activities.... Notes A.^ ^ ^ See Brown, Lewinsky and Hart, 2009.
... The reunification project started in 1959 and concluded in 1961. The outcome of the project was instrumental in the company's success.{{ref label|Brown1|B}} ... ... The consolidation efforts in 1992 had a huge impact on the company's success.{{ref label|Brown2|B}} ... ... The final development stage set the cornerstone for company's future activities.{{ref label|BrownLast|B}}... ==Notes== :B.{{note label|Brown1|^}}{{note label|Brown2|^}}{{note label|BrownLast|^}}See Brown, Lewinsky and Hart, 2009.	... The reunification project started in 1959 and concluded in 1961. The outcome of the project was instrumental in the company's success. ... ... The consolidation efforts in 1992 had a huge impact on the company's success. ... ... The final development stage set the cornerstone for company's future activities... Notes B.^ ^ ^ See Brown, Lewinsky and Hart, 2009.

backlink

جيئن مٿي بيان ٿيو، {{note label}} label پيرا ميٽر مان back link پيدا نه ڪندو آهي۔ {{ref label}} – {{note label}} جو خاص پيرا ميٽر backlink آهي، جيڪو جزوي طور id ۽ جزوي طور label جهڙو آهي:

• "مڪمل ڪندڙ پيرا ميٽر" جو مطلب اهو آهي ته {{ref label}} – {{note label}} جي جوڙي يا ته هن پيرا ميٽر کانسواءِ هجي يا ٻنهي ۾ موجود هجي۔
• "جزوي id" جو مطلب اهو آهي ته {{ref label}} – {{note label}} جي جوڙي ۾ ٻنهي پاسن تي ساڳيو backlink هجڻ گهرجي۔ ان کان علاوه، ڪنهن به اهڙي جوڙي ۾ id ۽ backlink جو گڏيل ميل منفرد هجڻ گهرجي۔
• "جزوي label" جو مطلب اهو آهي ته {{note label}} ۾ هي پيرا ميٽر مڪمل طور label پيرا ميٽر کي override ڪندو آهي۔

backlink وارو {{ref label}}، {{note}} سان نه ڳنڍجي سگهندو۔ اهڙي ئي طرح backlink وارو {{note label}}، {{ref}} سان نه ڳنڍجي سگهندو۔

مثال:

backlink جو مثال

ڪوڊ	نتيجو
Some text.{{ref label|id5|5|1}} Some other text.{{ref label|id5|5|2}} ----- ... :5.{{note label|id5||1}}{{note label|id5||2}} Some important comment!	Some text. Some other text. ... 5.1 2 Some important comment!

هي پيرا ميٽر (backlink) خاص قدر "none" به قبول ڪري ٿو، جنهن سان {{note label}} جي جاءِ تي هڪ caret ظاهر ٿيندو।

backlink کي "none" رکڻ جو مثال

ڪوڊ	نتيجو
Body text.{{ref label|id4|Label 4|none}} :{{note label|id4||none}}Footnote text	Body text. ^ Footnote text

text

مٿين سڀني مثالن ۾ فوٽ نوٽ جو متن {{note}} يا {{note label}} کان ٻاهر لکيو ويو هو۔ پر اهو ممڪن آهي ته اهو متن text پيرا ميٽر ۾ سانچي جي اندر ئي لکيو وڃي۔ text پيرا ميٽر اندر جيڪو ڪجهه رکيو ويندو، اهو تڏهن نمايان ٿيندو جڏهن صارف فوٽ نوٽ جي نشان تي ڪلڪ ڪندو۔ هيٺين مثال ۾ ^S ۽ ^T تي ڪلڪ ڪري فرق ڏسو۔

text جو مثال

ڪوڊ	نتيجو
Some text.{{ref|noteS|S}} Some other text.{{ref|noteT|T}} ==Notes== :S.{{note|noteS}}Some footnote text :T.{{note|noteT||Some other footnote text}}	Some text. Some other text. notes S.^ Some footnote text T.^ Some other footnote text

ڇاڪاڻ ته فوٽ نوٽ جو متن هن لڙي کان پوءِ بغير جدا ڪندڙ جي شروع ٿيندو آهي، تنهنڪري هڪ caveat آهي: جيڪڏهن فوٽ نوٽ جو متن ننڍي اکر سان شروع ٿئي، ته پهريون لفظ back link سان جڙي سگهي ٿو۔ (وڌيڪ معلومات لاءِ Help:Wikilinks ڏسو.)

backlink bug جو مثال

ڪوڊ	نتيجو
:{{ref label|id ref2a|Label 2a|Back}} :{{ref label|id ref2b|Label 2b|Back}} :{{note label|id ref2a|Label 2a|Back|Capitalized footnote}} :{{note label|id ref2b|Label 2b|Back|lower case footnote}}	BackCapitalized footnote Backlower case footnote

noid=noid

Deprecated پيرا ميٽر – note حصي کان ref ڏانهن back linking کي روڪي ٿو۔ {{note}} ۾ هڪ فعال hyperlink اڃا به ظاهر ٿيندو، پر اهو ٽٽل هوندو۔

هي پيرا ميٽر اصل ۾ ان مسئلي کي گهٽ ڪرڻ لاءِ ٺاهيو ويو هو جتي ڪيترائي ref tag ساڳئي ID سان هڪ note tag ڏانهن اشارو ڪن۔ پر هي رڳو هڪ قسم جي ٽٽل ڪوڊ کي ٻئي سان بدلائي ٿو۔ ان جي بدران {{note label}} استعمال ڪرڻ تي غور ڪريو، جيڪو تڏهن تائين ڪو به back link پيدا نٿو ڪري جيستائين ان کي خاص نموني سيٽ نه ڪيو وڃي۔ ساڳئي id سان هر ref template لاءِ هميشه هڪ ۽ صرف هڪ note template هجڻ گهرجي۔

اضافي مثال

اضافي مثال

ڪوڊ

نتيجو

Article text{{ref label|reference_name_A|a|1}} more text{{ref label|reference_name_G|g|}} more text{{ref label|reference_name_B|b|2}} more text{{ref label|reference_name_C|c|3}} more text{{ref label|reference name_D|d|4}} more text{{ref label|reference name_E|e|none}} more text{{ref label|reference name_F|f|}} more text.{{ref label|reference_name_H|h|8}} * * intervening text * * {{note label|reference_name_A|a|1}}Text of note for ref a. * {{note label|reference_name_B|b|2}}Text of note for ref b. * {{note label|reference_name_C|c|3|ABCDE}}Text of note for ref c. * {{note label|reference_name_D|d|4|FGHIJ}}Text of note for ref d. * {{note label|reference_name_E|e|none}}Text of note for ref e. * {{note label|reference_name_F|f}}Text of note for ref f. * {{note label|reference_name_G|g||{{note label|reference_name_H|h|8|Text of note for refs g and h (with extended highlighting).}}}}

Article text more text more text more text more text more text more text more text. intervening text 1 Text of note for ref a. 2 Text of note for ref b. 3ABCDE Text of note for ref c. 4FGHIJ Text of note for ref d. ^ Text of note for ref e. f Text of note for ref f. g8Text of note for refs g and h (with extended highlighting).

منفرد ID جو مسئلو

جيئن اڳ بيان ٿيو، هر {{ref}} – {{note}} جوڙي جو id منفرد هجڻ گهرجي۔ هيٺيون مثال ڏيکاري ٿو ته جڏهن ٻه ref ساڳيو id استعمال ڪن ٿا ته ڇا ٿيندو۔ bullet text کان footnotes ڏانهن ۽ وري واپس navigation ڪري ڏسو۔

ڪوڊ	نتيجو
Article text{{ref|reference_name_A|a}} more text{{ref|reference_name_B|b}} more text{{ref|reference_name_C|c}}. * Bulleted text{{ref|reference_name_B|b}} * Bulleted text{{ref|reference_name_C|c}}. * * intervening text * * {{note|reference_name_A|a}}Text for note a. * {{note|reference_name_B|b}}Text for note b. * {{note|reference_name_C|c|Text for note c (with extended highlighting).}}	Article text more text more text. Bulleted text Bulleted text. intervening text ^a Text for note a. ^b Text for note b. ^c Text for note c (with extended highlighting).

ٽيبل فوٽ نوٽ

ref ۽ note سانچن جو هڪ عام استعمال ٽيبلن جي هيٺان فوٽ نوٽ رکڻ آهي، جيئن هيٺين مثال ۾:

Year	Regional GVA	Agriculture		Industry		Services
County of Kent (excluding Medway)
1995	12,369	379	3.1%	3,886	31.4%	8,104	65.5%
2000	15,259	259	1.7%	4,601	30.2%	10,399	68.1%
2003	18,126	287	1.6%	5,057	27.9%	12,783	70.5%
Medway
1995	1,823	21	3.1%	560	31.4%	1,243	68.2%
2000	2,348	8	1.7%	745	30.2%	1,595	67.9%
2003	2,671	10	1.6%	802	27.9%	1,859	69.6%

1. ^↑Components may not sum to totals due to rounding
2. ^↑Includes energy and construction
3. ^↑Includes financial intermediation services indirectly measured

متبادل حوالا انداز

Reference Tooltips وارو gadget انهن سانچن سان ڪم نٿو ڪري۔ ref/note tags استعمال ڪرڻ فوٽ نوٽ ٺاهڻ جو واحد طريقو ناهي۔ Cite.php (جنهن سان Reference Tooltips ڪم ڪندو آهي) هاڻي فوٽ نوٽ ٺاهڻ جو ترجيحي طريقو آهي، خاص طور جڏهن فوٽ نوٽن جو تعداد ۽ مضمون جو سائيز وڌي وڃي۔ Ref converter ref/note tags کي نئين Cite.php انداز ۾ تبديل ڪري سگهي ٿو۔

هيٺيان مثال ٻن طريقن جو مقابلو ڪري ٿو ۽ اهو به ڏيکاري ٿو ته ٻنهي کي ڪيئن گڏ ڪري سگهجي ٿو:

اضافي مثال

ڪوڊ	نتيجو
Yammer yammer yammer.<ref name=smith2000>Smith wrote the definitive book on yammering.{{ref|Smith2000|Smith 2000}}</ref> Yammer yammer yammer.<ref name=smith2000/> ... ==References== {{reflist}} ... ==Bibliography== *{{note|Smith2000}} Smith (2000). "A book about yammering".	Yammer yammer yammer. Yammer yammer yammer. ... References ... Bibliography ^ Smith (2000). "A book about yammering".

پڻ مثال ۽ وضاحت لاءِ Wikipedia:Footnote3 ڏسو۔

پڻ ڏسو

• Wikipedia:Footnote3، فوٽ نوٽ ٺاهڻ جي هن طريقي بابت هڪ مقالو
• Help:Footnotes
• Wikipedia:Template messages/Sources of articles
• Category:Citation templates، جن ۾ اهي سانچا به شامل آهن جيڪي ref–note label نظام جو حصو ناهن
• سانچو:Template
• Template:Ref/examples

{{Sandbox other||

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