لینکس مین پیج کیسے بنایا جائے۔

حکم آدمی لینکس پر ہر لینکس ڈویلپر اور صارف کی پٹھوں کی یادداشت میں سرایت کرتا ہے۔ یہ لفظی طور پر ہر کوئی استعمال کرتا ہے۔ شوقیہ اور نئے ڈویلپرز سے لے کر لینکس کے پیشہ ور افراد اور ماہرین تک۔

یہ لینکس کمانڈ، کنفیگریشن فائل، یا کسی دوسری خصوصیت کے لیے کمانڈ لائن مینوئل پیج کو پڑھنے کے لیے استعمال ہوتا ہے۔ دستی صفحات عام طور پر لینکس میں سافٹ ویئر کی تنصیب کے ساتھ انسٹال ہوتے ہیں۔ دستی صفحات کے لیے ایک متعین نحو ہے، جسے کمانڈ کے ذریعے پارس کیا جاتا ہے۔

آئیے درج ذیل bash اسکرپٹ کے لیے مین پیج بنائیں جو میں نے لکھا ہے۔

#!/bin/bash if [ "$1" == "h" ]; پھر echo "Hello" fi if [ "$1" = "b" ]؛ پھر "بائے" فائی کو ایکو کریں۔

یہ اسکرپٹ صرف دو کام کرتا ہے: یہ "Hello" پرنٹ کرتا ہے اگر آپشن 'h' کو دلیل کے طور پر بیان کیا گیا ہے، اور اگر آپشن 'b' کو دلیل کے طور پر بیان کیا گیا ہے تو یہ "Bye" پرنٹ کرتا ہے۔

آئیے اس پروگرام کے لیے ایک مین پیج بنائیں۔ استعمال کریں۔ vim یا ٹیکسٹ فائل بنانے کے لیے اپنی پسند کا کوئی ایڈیٹر۔

vim test.1

ایکسٹینشن '.1' اس بات کی نشاندہی کر رہی ہے کہ یہ مین پیج ایک قابل عمل کمانڈ کے لیے ہے۔ یہ کوئی مجبوری نہیں ہے بلکہ مین پیجز لکھتے وقت ایک وسیع پیمانے پر پیروی کی جانے والی کنونشن ہے۔ آدمی کے لیے دستی صفحہ (آدمی آدمی !) زمروں کی فہرست دیتا ہے:

 1 قابل عمل پروگرام یا شیل کمانڈز 2 سسٹم کالز (کرنل کے ذریعے فراہم کردہ افعال) 3 لائبریری کالز (پروگرام لائبریریوں کے اندر افعال) 4 خصوصی فائلیں (عام طور پر /dev میں پائی جاتی ہیں) 5 فائل فارمیٹس اور کنونشنز جیسے /etc/passwd 6 گیمز 7 متفرق ( بشمول میکرو پیکجز اور کنونشنز) آدمی (7)، گروف (7) 8 سسٹم ایڈمنسٹریشن کمانڈز (عام طور پر صرف جڑ کے لیے) 9 کرنل روٹینز [غیر معیاری]

ایک مین پیج بہت پرانی روف مارک اپ لینگویج کا استعمال کرتے ہوئے بنایا گیا ہے۔ اس میں مختلف عنوانات اور حصوں کے لیے کمانڈز (مارکر پڑھیں) ہیں۔

  • .ویں - یہ مین فائل میں پہلی کمانڈ ہونی چاہئے۔ یہ مین پیج کے ٹائٹل ہیڈنگ کو بتانے کے لیے استعمال ہوتا ہے۔
  • .ایسیچ - سیکشن کی سرخی
  • .بی - اس کا استعمال اس کے ساتھ والے متن کو بولڈ میں ظاہر کرنے کے لیے کیا جاتا ہے۔
  • .TP - یہ کمانڈ پر دلیل (پرچم) کے بارے میں معلومات ظاہر کرنے کے لیے استعمال ہوتا ہے۔
  • بی آر - یہ بولڈ اور عام رومن فونٹ میں متن کو ظاہر کرنے کے لیے استعمال ہوتا ہے۔

مندرجہ ذیل میرے پروگرام کا مین پیج ہے جو صرف اوپر والے (سادہ) roff کمانڈز کا استعمال کرتے ہوئے بنایا گیا ہے۔

.TH test.sh 1 .SH NAME test.sh \- پرنٹ ہیلو یا بائے .SH SYNOPSIS .B test.sh [ h ] [ b ] .SH تفصیل .B test.sh یہ ایک نمونہ اسکرپٹ ہے جو صرف 2 چیزیں کرتا ہے . یہ یا تو "Hello" پرنٹ کرتا ہے اگر دلیل 'h' ہے یا اگر دلیل 'b' ہے تو یہ "Bye" پرنٹ کرتا ہے .SH آپشنز .TP .BR h پرنٹ کریں ہیلو .TP .BR b پرنٹ کریں الوداع

فائل کو محفوظ کریں۔ پہلے دبانے سے ای ایس سی کلید، اور پھر ٹائپ کریں۔ :wq فائل کو محفوظ کرنے اور vim کنسول سے باہر نکلنے کے لیے۔

اس مین پیج کی جانچ کریں جو ہم نے ابھی نیچے دی گئی کمانڈ کا استعمال کرتے ہوئے بنایا ہے۔

آدمی ./ٹیسٹ۔1

پر مزید معلومات کے لیے آدمی استعمال، چلائیں مین مین پیجز اپنے ٹرمینل میں کمانڈ کریں۔

? ٹپ

یہ مین پیجز لکھنے کے لیے بنیادی نحو ہے۔ چیزوں کو آسان بنانے کے لیے، آپ txt2man جیسے ٹولز کا استعمال کر سکتے ہیں کسی فائل کو مارک اپ لینگویج فارمیٹ میں roff فارمیٹ میں تبدیل کریں۔