سانچو:Kbd
user input
 | This template uses TemplateStyles: |
هي سانچو هن ڳالهه کي واضح طور ڏيکارڻ لاءِ استعمال ٿيندو آهي ته ان جي اندر موجود مواد ڪيبورڊ يا ڪنهن ٻئي ذريعي (جهڙوڪ آواز سڃاڻپ سافٽويئر، standard input وغيره) مان حاصل ٿيل ان پُٽ کي ظاهر ڪري ٿو. اهو [[[XHTML|X]]]HTML عنصر <kbd>...</kbd> (keyboard input) استعمال ڪري ٿو، جيڪو خاص هن مقصد لاءِ موجود آهي، ۽ ان تي ڪجهه اسٽائل لاڳو ڪري ٿو، يعني هلڪو سرمائي پسمنظر (جيڪو لاڳاپيل سانچي {{key press}} مان ورتو ويو آهي) ۽ ٿورو CSS حرفن جي وچ ۾ فاصلو، جنهن سان اهو تاثر ملي ٿو ته اکر الڳ الڳ داخل ڪيا ويا آهن. اهو <kbd> عنصر جي اصل monospace (غير متناسب) فونٽ انداز کي برقرار رکي ٿو. ڇاڪاڻته اهو صرف بصري انداز لاڳو ڪرڻ بدران <kbd>...</kbd> استعمال ڪري ٿو، تنهنڪري اهو semantic markup آهي جيڪو معنٰي پڻ ظاهر ڪري ٿو، ۽ استعمال ڪندڙ جو ايجنٽ (مثلاً ڪسٽم لوڪل اسٽائل شيٽس) ان تي وڌيڪ ڪارروائي ڪري سگهي ٿو.
هي ٽيگ {{samp}} جو بلڪل ابتڙ آهي، جيڪو مثال طور output لاءِ استعمال ٿيندو آهي.
استعمال
[سنواريو]هي سانچو هڪ لازمي پيراميٽر وٺندو آهي، جيڪو اهو مواد آهي جنهن کي مارڪ اپ ڪيو ويندو. جيڪڏهن هن مواد ۾ "=" (برابري جو نشان) موجود هجي، ته پيراميٽر کي لازمي طور must |1= نالي سان لکڻو پوندو، نه ته سانچو ڪم نه ڪندو. (هي MediaWiki سافٽويئر جي حد آهي، سانچي جي نه.) هميشه |1= جو طريقو استعمال ڪرڻ وڌيڪ محفوظ آهي. اهو {{var}}، {{varserif}} يا <var>...</var> سان گڏ ڪنٽينر طور پڻ استعمال ٿي سگهي ٿو جڏهن ڪيبورڊ ان پُٽ ۾ يا مڪمل طور تي متغير شامل هجي. اهو {{code}} سان گڏ (پر ان جي اندر نه) يا <code>...</code> سان پڻ استعمال ٿي سگهي ٿو (عام طور تي <code>...</code> جي اندر استعمال نه ڪرڻ گهرجي، ڇاڪاڻته ان پُٽ سورس ڪوڊ جو حصو نه هوندو، پر ان سان تعامل ڪندو آهي؛ البت هي انداز گڏيل قسم جي ڪمپيوٽر ڊسپلي ڏيکارڻ لاءِ استعمال ڪري سگهجي ٿو، جيئن هيٺ مثال ۾ ڏيکاريل آهي).
هڪ اختياري پيراميٽر |spacing=no (يا |spacing=n يا ڪو ٻيو قدر) پڻ موجود آهي، جنهن سان اکرن جي وچ وارو ٿورو فاصلو ختم ڪري سگهجي ٿو، ڇاڪاڻته ڊگهي متن ۾ اهو ڪڏهن ڪڏهن عجيب لڳندو آهي.
مثال
[سنواريو]{{kbd|71077345}}: "ڪيلڪوليٽر تي 71077345 داخل ڪري ان کي الٽو ڪرڻ سان لفظ ShellOil جهڙو نظر اچي ٿو."
{{kbd|1=ssh {{var|hostname}}}} سان گڏ {{samp|%}}: " % پرامپٽ تي، استعمال ڪندڙ کي ssh hostname داخل ڪرڻو پوندو."
{{kbd|1=ssh {{var|hostname}}}} سان گڏ {{samp|%}} ۽ {{key press|Enter}}: " % پرامپٽ تي، استعمال ڪندڙ کي ssh hostname↵ Enter داخل ڪرڻو پوندو."
Inside <code>...</code>: "ڪمانڊ لائن هن طرح هئڻ گهرجي: % ssh hostname (جتي hostname سسٽم جو IP ايڊريس يا ڊومين نالو آهي جنهن سان ڳنڍڻو آهي)؛ جيڪڏهن اهو صحيح هجي، ته ↵ Enter دبائو."
{{kbd|1={{lorem ipsum span}}|spacing=0}} فاصلو ختم ڪرڻ لاءِ: لورم اِپسم درد پاڻ سان گڏ هوندو آهي، ۽ اهو سکيا ۽ تربيت سان پڻ لاڳاپيل هوندو آهي، پر اهو عارضي محنت ۽ وڏي تڪليف سان حاصل ڪيو ويندو آهي. ڇاڪاڻتہ ٿورو فائدو حاصل ڪرڻ لاءِ به انسان کي ڪا نه ڪا ڪوشش ڪرڻي پوندي آهي. ڪير اهڙو آهي جيڪو محنت ڪري ۽ ان مان ڪو فائدو حاصل نه ڪري؟ پر اهڙو درد جيڪو خوشي ۾ بدلجي وڃي، ان کان ڇو پاسو ڪجي؟ ۽ اهڙي خوشي جيڪا ڪنهن به تڪليف جو سبب نه بڻجي، ان کي ڇو قبول نه ڪجي؟
ڪجهه مثال هن دستاويز کان ٻاهر ٿورا مختلف نظر اچي سگهن ٿا، ڇاڪاڻته مختلف صفحن جو پسمنظر رنگ مختلف هوندو آهي (مضمونن جا صفحا بلڪل اڇا، سانچي دستاويز هلڪا سائي، ۽ ٻين صفحن جو رنگ هلڪو سرمائي هوندو آهي). مضمون اندر مثال:
{{kbd|71077345}}: "ڪيلڪوليٽر تي 71077345 داخل ڪري ان کي الٽو ڪرڻ سان لفظ ShellOil جهڙو نظر اچي ٿو."{{kbd|1=ssh {{var|hostname}}}}سان گڏ{{samp|%}}: " % پرامپٽ تي، استعمال ڪندڙ کي ssh hostname داخل ڪرڻو پوندو."{{kbd|1=ssh {{var|hostname}}}}سان گڏ{{samp|%}}۽{{key press|Enter}}: " % پرامپٽ تي، استعمال ڪندڙ کي ssh hostname↵ Enter داخل ڪرڻو پوندو."- Inside
<code>...</code>: "ڪمانڊ لائن هن طرح هئڻ گهرجي:% ssh hostname(جتي hostname سسٽم جو IP ايڊريس يا ڊومين نالو آهي جنهن سان ڳنڍڻو آهي)؛ جيڪڏهن اهو صحيح هجي، ته ↵ Enter دبائو." {{kbd|1={{lorem ipsum span}}|spacing=0}}فاصلو ختم ڪرڻ لاءِ: لورم اِپسم درد پاڻ سان گڏ هوندو آهي، ۽ اهو سکيا ۽ تربيت سان پڻ لاڳاپيل هوندو آهي، پر اهو عارضي محنت ۽ وڏي تڪليف سان حاصل ڪيو ويندو آهي. ڇاڪاڻتہ ٿورو فائدو حاصل ڪرڻ لاءِ به انسان کي ڪا نه ڪا ڪوشش ڪرڻي پوندي آهي. ڪير اهڙو آهي جيڪو محنت ڪري ۽ ان مان ڪو فائدو حاصل نه ڪري؟ پر اهڙو درد جيڪو خوشي ۾ بدلجي وڃي، ان کان ڇو پاسو ڪجي؟ ۽ اهڙي خوشي جيڪا ڪنهن به تڪليف جو سبب نه بڻجي، ان کي ڇو قبول نه ڪجي؟