مدد:Substitution

ڏسو اهڙي رهنمائي لاءِ جتي ٽرانسڪلوژن بدران سبسٽيٽيوشن استعمال ڪئي وڃي لاءِ، Wikipedia:Substitution.

سبسٽيٽيوشن يا متبادل هڪ اهڙو عمل آهي جنهن ۾ ڪنهن ماخذ صفحي جو مواد هڪ ڀيرو نقل ڪري ڪنهن ٻئي صفحي ۾ مستقل نقل جي صورت ۾ داخل ڪيو ويندو آهي. ماخذ سانچو، جادوئي لفظ، متغير، پارسر فنڪشن يا وڪيپيڊيا جو ٻيو ڪو به صفحو ٿي سگهي ٿو. سبسٽيٽيوشن ٽرانسڪلوژن کان مختلف آهي، ڇو ته ٽرانسڪلوژن ۾ هر ڀيري جڏهن صفحو لوڊ ٿئي ٿو ته ماخذ جو موجوده مواد ٻيهر شامل ڪيو ويندو آهي.

تعريف

عام طور تي سانچا ٽرانسڪلوڊ ڪيا ويندا آهن، جنهن جو مطلب آهي ته انهن جو مواد هميشه سانچي جي تازي نسخي مان سڌو حاصل ڪيو ويندو آهي. اهو فائديمند آهي، ڇو ته جيڪڏهن سانچي جي صفحي ۾ تبديلي ڪئي وڃي ته اهو سانچو استعمال ڪندڙ سڀني صفحن تي نئون مواد خودڪار طور ظاهر ٿي ويندو. اهڙي حالت ۾ جڏهن ڪو شخص اهڙو صفحو ايڊٽ ڪري ٿو جيڪو ڪنهن سانچي کي ٽرانسڪلوڊ ڪري ٿو ته کيس صرف سانچو:Template link with link off نظر ايندو آهي ۽ اصل ڪوڊ نظر نه ايندو. گهڻا سانچا اهڙي طريقي سان استعمال ڪيا ويندا آهن ته جيئن هر صفحي کي الڳ الڳ اپڊيٽ ڪرڻ جي ضرورت نه پوي.

پر ڪجهه سانچا اهڙا هوندا آهن جن کي هميشه سبسٽيٽيوٽ ڪرڻ گهرجي. ان جو مطلب آهي ته جڏهن ڪو ايڊيٽر صفحي تي اهو سانچو شامل ڪري تبديلي محفوظ ڪندو ته ان لمحي تي سانچي جو سڄو مواد صفحي ۾ مستقل طور تي لکي ويندو، ۽ ان سان گڏ ان جا سڀ پيرا ميٽر به شامل ٿي ويندا، ڄڻ ايڊيٽر پاڻ هٿ سان اهو ڪوڊ نقل ڪري پيسٽ ڪيو هجي. جڏهن مواد سبسٽيٽيوٽ ٿي وڃي ٿو ته اهو صفحي جو حصو بڻجي وڃي ٿو ۽ پوءِ ان ۾ تبديلي ڪرڻ سان نه ٻين صفحن تي اثر پوندو ۽ نه ئي اصل سانچي تي. جيڪڏهن مستقبل ۾ سانچو تبديل ٿئي ته اهي صفحا جن ۾ اهو اڳ ۾ سبسٽيٽيوٽ ڪيو ويو آهي متاثر نه ٿيندا، ڇاڪاڻ ته هاڻي انهن جو سانچي سان ڪو سڌو تعلق نه رهندو.

استعمال

ڪنهن سانچي کي ٽرانسڪلوڊ ڪرڻ لاءِ ان جو نالو صرف ڊبل ڪروشي بريڪٽن ۾ لکيو ويندو آهي، جهڙوڪ: {{Cleanup}}

جيڪڏهن ساڳي سانچي کي سبسٽيٽيوٽ ڪرڻو هجي ته کليل بريڪٽن کان پوءِ subst: شامل ڪيو ويندو، جيئن:

{{subst:Cleanup}}

ان صورت ۾ {{Cleanup}} جو مواد صفحي جي ان جڳهه تي داخل ٿي ويندو جتي سانچي کي سڏيو ويو آهي. پيرا ميٽر به ساڳي طرح شامل ڪري سگهجن ٿا، مثال طور:

{{subst:Cleanup|reason=Incorrect capitalization}}

محفوظ ڪرڻ کان اڳ توهان "Show changes" تي ڪلڪ ڪري اصل وڪي ٽيڪسٽ ڏسي سگهو ٿا جيڪو ايڊيٽر ۾ نظر ايندڙ مواد کان مختلف هوندو آهي.

سانچي جي نيم اسپيس کان ٻاهر وارا صفحا به سبسٽيٽيوٽ ڪري سگهجن ٿا، مثال طور:

{{subst:User:Cleverclogs/My box}}

جيڪڏهن مکيه نيم اسپيس واري صفحي جو مواد سبسٽيٽيوٽ ڪرڻو هجي ته ٻه ڪولن استعمال ڪيا ويندا، جيئن:

{{subst::Page}}

جيڪڏهن ڪو سبسٽيٽيوٽ ڪيل صفحو يا سانچو موجود نه هجي ته پورو اظهار (subst ۽ بريڪٽن سميت) ساڳي طرح صفحي تي ظاهر ٿيندو.

ساڳي طريقي سان متغيرن ۽ پارسر فنڪشنن کي به سبسٽيٽيوٽ ڪري سگهجي ٿو، مثال طور:

{{subst:PAGENAME}}

يا

{{subst:#switch:{{NUMBEROFADMINS}}|1=Foo|1000=Bar|#default=Baz}}

کليل بريڪٽن ۽ "subst:" جي وچ ۾ خالي جڳهه ٿي سگهي ٿي، پر سفارش اها آهي ته "subst:" کان پوءِ فوري طور ڪو به خالي اسپيس يا نئون لائين نه هجي، ڇو ته ڪجهه حالتن ۾ اهو ڪم نه ڪندو.

فائدا

• جيڪڏهن ڪنهن سانچي کي صرف هڪ خاص موقعي لاءِ تبديل ڪرڻو هجي ۽ توهان نٿا چاهيو ته اهو سڀني صفحن تي اثر انداز ٿئي، ته توهان سانچي کي سبسٽيٽيوٽ ڪري پوءِ ٻي ايڊيٽ سان تبديلي ڪري سگهو ٿا.
• گهڻو استعمال ٿيندڙ پر غير محفوظ سانچن کي سبسٽيٽيوٽ ڪرڻ سان انهن تي ٿيندڙ توڙ ڦوڙ جو نقصان محدود ٿي سگهي ٿو.
• ٽرانسڪلوڊ ٿيل سانچا نون صارفن کان وڪي ڪوڊ لڪائي ڇڏيندا آهن، جڏهن ته سبسٽيٽيوشن سان اصل ڪوڊ نظر اچي ٿو ۽ سکڻ جو موقعو ملي ٿو.
• سبسٽيٽيوشن سان ميڪرو سانچن ذريعي recursive evaluation ممڪن ٿئي ٿي.
• سبسٽيٽيوشن سان صفحو مستقبل ۾ سانچي جي تبديلي کان آزاد ٿي وڃي ٿو.
• ڪجهه خودڪار تبديليون صرف سبسٽيٽيوشن وقت ٿينديون آهن، مثال طور چار ٽلڊا (Intisar Ali (ڳالھ) 07:01, 14 مارچ 2026 ( يو.ٽي.سي)) استعمال ڪندڙ جي دستخط ۽ وقت سان تبديل ٿينديون آهن.
• سبسٽيٽيوشن سان صفحي جو وڪي ٽيڪسٽ ٻي منصوبي تي نقل ڪرڻ آسان ٿي وڃي ٿو.

غير جانبدار نقطا

• وڏي پيماني تي سبسٽيٽيوشن سان صفحن جي لوڊ ٿيڻ جي رفتار وڌي سگهي ٿي، پر اهو ترجيح ڏيڻ جو بنيادي سبب نه هجڻ گهرجي.
• جيڪڏهن ڪو سانچو عام متن لاءِ استعمال ٿيندو آهي ته سوچڻ گهرجي ته ڇا توهان چاهيو ٿا ته اهو وقت سان تبديل ٿئي يا نه. جيڪڏهن جواب "نه" هجي ته سبسٽيٽيوشن مناسب آهي.

نقصان

• سبسٽيٽيوٽ ٿيل سانچو اصل سانچي سان ڳنڍيل نه رهندو، تنهن ڪري سڀ اهڙا صفحا ڳولڻ مشڪل ٿي سگهي ٿو.
• جيڪڏهن اصل سانچي ۾ غلطي درست ڪئي وڃي ته سبسٽيٽيوٽ ٿيل صفحا پاڻمرادو درست نه ٿيندا.
• معياري ڏيک برقرار رکڻ لاءِ استعمال ٿيندڙ سانچن کي عام طور سبسٽيٽيوٽ نه ڪرڻ گهرجي.
• وڏي تعداد ۾ سبسٽيٽيوشن سرور جي وسيلن تي اضافي بار وجهي سگهي ٿي.
• سبسٽيٽيوشن سان صفحن جو سائيز وڌي وڃي ٿو.
• تمام گهڻو وڪي ڪوڊ شامل ٿيڻ سان نون صارفن لاءِ صفحو سمجھڻ ڏکيو ٿي سگهي ٿو.

سبسٽيٽيوشن جي دستاويزڪاري

subst: ذريعي سانچي جي استعمال جو رڪارڊ خودڪار طور صفحي جي تاريخ ۾ ظاهر نه ٿيندو آهي. تنهن ڪري سفارش ڪئي ويندي آهي ته ايڊيٽ سمري ۾ سانچي جو ذڪر ڪيو وڃي، جيئن ٻين ايڊيٽرن کي تبديلي سمجهڻ ۾ آساني ٿئي.

HTML تبصرا () جيڪڏهن noinclude ٽيگ کان ٻاهر هجن ته سبسٽيٽيوٽ ٿيل وڪي ٽيڪسٽ ۾ به شامل ٿيندا آهن، تنهن ڪري انهن ذريعي سانچي جو حوالو محفوظ رکيو وڃي ٿو.

جيڪڏهن توهان اهڙا سانچا ٺاهيو ٿا جيڪي گهڻو ڪري سبسٽيٽيوٽ ٿيندا آهن ته انهن ۾ لڪل تبصرو شامل ڪري سگهجي ٿو، مثال طور:

<!-- Template:Cleanup -->

سانچي سان لاڳاپيل خاص استعمال

هن صفحي تي انهن سانچن جي فهرست پڻ ڏني وئي آهي جيڪي يا ته هميشه سبسٽيٽيوٽ ٿيڻ گهرجن يا ڪڏهن به سبسٽيٽيوٽ نه ٿيڻ گهرجن، سواءِ وڪيپيڊيا نيم اسپيس جي. اهڙا تبديليون ڪندڙ بوٽ اصل سانچي تي ڪڏهن به استعمال نه ڪيا ويندا. جيڪڏهن توهان سانچن کي سبسٽيٽيوٽ ڪرڻ لاءِ بوٽ استعمال ڪرڻ وارا آهيو ته مهرباني ڪري پهريان ڳالهه ٻولهه واري صفحي کي پڙهو، ڇاڪاڻ⁠تہ ڪيترن سانچن بابت اختلاف يا وقت سان تبديلي ٿيندي رهي ٿي، ۽ سبسٽيٽيوشن مستقل هوندي آهي.

اهي سانچا جيڪي ضروري طور سبسٽيٽيوٽ ٿيڻ گهرجن

اهي سانچا اهڙي مقصد يا نحوي ساخت رکن ٿا جن لاءِ انهن کي سبسٽيٽيوٽ ڪرڻ لازمي آهي.

• {{afd}}, {{afd2}}, {{afd3}}, {{rfd}}, {{tfd}}, {{tfdnotice}}، ٻي صورت ۾ "هن مضمون/ريڊائريڪٽ/سانچي جي داخلا" ڏانهن لنڪ صحيح ڪم نه ڪندو. ان کان علاوه حذف واري عمل جي مڪمل ٿيڻ کي بيان ڪندڙ سانچا (جهڙوڪ {{afd top}} وغيره) به سبسٽيٽيوٽ ٿيڻ گهرجن.
• {{cfd}}, {{cfr}}, {{cfm}}, {{cfr-speedy}}، جيڪي تبصرا داخل ڪن ٿا جيڪي سانچو:Ul لاءِ قطار طور ڪم ڪن ٿا، جيڪو زمرا ٻيهر نالا رکڻ يا ضم ڪرڻ لاءِ استعمال ٿيندو آهي.
• {{copyvio}}، جيڪي مضمون ڪاپي رائيٽ مسئلن ۾ شامل ڪرڻ لاءِ استعمال ٿين ٿا؛ جيڪڏهن ٽرانسڪلوڊ ڪيا وڃن ته غلطي ظاهر ٿيندي.
• {{nld}}، جن تصويرن وٽ ڪاپي رائيٽ جي حيثيت بابت ڄاڻ نه هجي، اهي خودڪار طور {{no license}} سان اڄ جي تاريخ شامل ڪندا.
• {{nrd}}، جن تصويرن وٽ فيئر يوز جواز نه هجي، اهي {{no rationale}} سان اڄ جي تاريخ شامل ڪندا.
• {{nsd}}، جن تصويرن وٽ ماخذ جي ڄاڻ نه هجي، اهي {{di-no source}} سان اڄ جي تاريخ شامل ڪندا.
• {{orfud}}، عام قسم جي يتيم فيئر يوز تصويرن لاءِ {{di-orphaned fair use}} سان اڄ جي تاريخ شامل ڪندو.
• {{or-fu-re}}، اهڙين فيئر يوز تصويرن لاءِ جيڪي ٻي تصوير سان تبديل ٿيڻ سبب يتيم ٿي ويون هجن، {{di-orphaned fair use}} سان اڄ جي تاريخ شامل ڪندو.
• {{proposed deletion}}، تجويز ڪيل حذف لاءِ {{proposed deletion/dated}} سان اڄ جي تاريخ شامل ڪندو.
• {{requested move}}، صفحي کي منتقل ڪرڻ جي درخواست لاءِ ڳالهه ٻولهه واري صفحي تي نئون هيڊر ۽ اڄ جي تاريخ شامل ڪندو.
• {{rfu}}، اهڙين فيئر يوز تصويرن لاءِ جيڪي آزاد لائسنس واري تصوير سان تبديل ٿي سگهن ٿيون، {{replaceable fair use}} سان اڄ جي تاريخ شامل ڪندو.
• {{refu-c}}، تبديل ٿي سگهندڙ فيئر يوز تصويرن جي ڪيپشن لاءِ استعمال ٿيندو آهي، جيڪو {{rfu-c}} سان آخري تاريخ (اڄ + 7 ڏينهن) خودڪار طريقي سان ڀريندو.
• {{OnProd}}، جيڪو حذف لاءِ نامزد ڪيل مضمون جي زمري جو اڄ جي تاريخ تي ٻڌل نالو داخل ڪندو.

اهي سانچا جيڪي هميشه سبسٽيٽيوٽ ٿيڻ گهرجن

هي اهڙن سانچن جي فهرست آهي جيڪي هميشه سبسٽيٽيوٽ ٿيڻ گهرجن. فهرست الفابيٽ ترتيب سان ڏنل آهي. هي مڪمل فهرست ناهي؛ ٻيا گهٽ استعمال ٿيندڙ سانچا به سبسٽيٽيوٽ ٿيڻ گهرجن.

• {{Format ISBN}}، سبسٽيٽيوٽ ڪرڻ سان 9 عددن واري SBN ۽ 10 يا 13 عددن واري ISBN کي بين الاقوامي ISBN ايجنسي جي ضابطن مطابق ترتيب ڏنو ويندو.
• {{No more links}}، سبسٽيٽيوٽ ڪرڻ سان ايڊيٽ موڊ ۾ نظر ايندڙ تبصرو شامل ٿيندو جيڪو لنڪ اسپيم کي روڪڻ لاءِ وضاحت ڏئي ٿو.

• {{tmfrom}}, {{tmto}}
• صارف خبردار ڪندڙ سانچا ۽ خوش آمديد سانچا هميشه سبسٽيٽيوٽ ٿيڻ گهرجن (صارف جي ذاتي صفحي تي استعمال ٿيل سانچن تي لاڳو نه ٿيندو).
• صارف دستخط وارا سانچا جيڪڏهن ٽرانسڪلوڊ ڪيا وڃن ته سرور تي غير ضروري بار وجهن ٿا؛ تنهن ڪري جيڪڏهن استعمال ڪيا وڃن ته انهن کي سبسٽيٽيوٽ ڪرڻ گهرجي.

اهي سانچا جيڪي سبسٽيٽيوٽ نه ٿيڻ گهرجن

عام طور سانچا سبسٽيٽيوٽ نه ڪرڻ گهرجن جيڪڏهن اهي:

1. ParserFunctions جهڙوڪ #if يا #switch استعمال ڪن ٿا، جيستائين اهي به گڏ سبسٽيٽيوٽ نه ڪيا وڃن.
2. ڪجهه پيرا ميٽرن کي ڊفالٽ قيمت تي ڇڏين ٿا.
3. ٻاهرين لنڪس شامل ڪن ٿا جن جي فارميٽ مستقبل ۾ تبديل ٿي سگهي ٿي.

اهو ان ڪري آهي جو اهڙيون ساختون وڪي ڪوڊ ۾ تبديل نه ٿينديون ۽ اصل صورت ۾ رهنديون.

فهرست

هي اهڙن سانچن جي فهرست آهي جيڪي سبسٽيٽيوٽ نه ٿيڻ گهرجن:

• مختلف حوالا يا citation سانچا، جيڪي تمام پيچيده شرطي ڪوڊ رکن ٿا.
• انفوباڪس سانچا، بوٽ سڃاڻپ ۽ يڪسانيت لاءِ.
• {{Javadoc:EE}}, {{Javadoc:SE}}, {{Javadoc:SE-guide}}
• {{ISP}}, {{Openproxy}}, {{repeat vandal}}, {{SharedIP}}, {{SharedIPEDU}}, {{s/wnote}}
• {{ln}}, {{lnt}}
• {{Main}}
• {{switch}}
• {{See also}}
• {{selfref}}
• {{Signpost-subscription}}
• {{stub}} سانچا
• {{talkarchive}}, {{archive}}
• {{tl}}, {{tlp}}, {{ttl}}, {{ti}}, {{tic}}, {{tls}}, {{cl}}, {{ccl}}
• {{sockpuppet}} ۽ ساڳيا سانچا
• {{lowercase}}, {{correct title}}

حذف سان لاڳاپيل

اڪثر حذف يا نالي جي تبديلي سان لاڳاپيل سانچا عارضي طور استعمال ٿيندا آهن، تنهن ڪري انهن کي سبسٽيٽيوٽ ڪرڻ جي ضرورت ناهي.

• {{catfd}}
• {{ifd}} {{ifd2}} {{idw}} {{idw-uo}} {{idw-cp}}
• {{cfdnotice}}
• {{sfd-t}} {{sfd-r}} {{sfr-t}}
• {{prod-2}}
• ۽ تمام تيز حذف سانچا
• {{editprotected}}

بحث هيٺ

• {{col-begin}} {{col-2}} {{col-3}} {{col-4}} {{col-end}}
• {{Clear}}, {{Clearleft}} {{Clearright}}
• {{ed}} {{ed2}} {{ed right}} {{edit}}
• {{archive top}} {{archive bottom}}, {{discussion top}} {{discussion bottom}}

پڻ ڏسو

• مدد:Transclusion
• مدد:Metatemplating § Substitution
• Special:ExpandTemplates
• زمرو:Wikipedia substituted templates
• واپرائيندڙ:AnomieBOT

ڀيڻ منصوبا

• mw:Help:Substitution
• mw:Help:ExpandTemplates
• mw:Help:TemplateData
• phab:T4003
• Check Wikipedia § Template programming element

سبسٽيٽيوشن لاءِ سانچا

• {{require subst}}
• {{issubst}}
• {{ifsubst}}

سانچو:Wikipedia templatesسانچو:Wikipedia help pagesسانچو:Wikipedia community