কিভাবে একটি লিনাক্স ম্যান পেজ তৈরি করবেন

আদেশ মানুষ লিনাক্সে প্রতিটি লিনাক্স বিকাশকারী এবং ব্যবহারকারীর পেশী মেমরিতে এমবেড করা হয়। এটি আক্ষরিক অর্থে সবাই ব্যবহার করে; অপেশাদার এবং নবীন বিকাশকারী থেকে শুরু করে লিনাক্স পেশাদার এবং বিশেষজ্ঞরা।

এটি লিনাক্স কমান্ড, কনফিগারেশন ফাইল বা অন্য কোনো বৈশিষ্ট্যের জন্য কমান্ড লাইন ম্যানুয়াল পৃষ্ঠা পড়ার জন্য ব্যবহৃত হয়। লিনাক্সে একটি সফ্টওয়্যার ইনস্টলেশনের সাথে ম্যানুয়াল পৃষ্ঠাগুলি সাধারণত ইনস্টল করা হয়। ম্যানুয়াল পৃষ্ঠাগুলির জন্য একটি সংজ্ঞায়িত সিনট্যাক্স রয়েছে, যা কমান্ড দ্বারা পার্স করা হয়।

আমার লেখা নিচের ব্যাশ স্ক্রিপ্টের জন্য একটি ম্যান পেজ তৈরি করা যাক:

#!/bin/bash যদি [ "$1" == "h" ]; তারপর ইকো "হ্যালো" ফাই যদি [ "$1" = "b" ]; তারপর ইকো "বাই" ফাই

এই স্ক্রিপ্টটি শুধুমাত্র দুটি জিনিস করে: এটি "হ্যালো" প্রিন্ট করে যদি বিকল্প 'h' আর্গুমেন্ট হিসাবে নির্দিষ্ট করা হয়, এবং যদি বিকল্প 'b' আর্গুমেন্ট হিসাবে নির্দিষ্ট করা হয় তবে এটি "বাই" প্রিন্ট করে।

আসুন এই প্রোগ্রামের জন্য একটি ম্যান পেজ তৈরি করি। ব্যবহার করুন vim অথবা একটি টেক্সট ফাইল তৈরি করতে আপনার পছন্দের কোনো সম্পাদক।

vim পরীক্ষা.1

এক্সটেনশন '.1' নির্দেশ করছে যে এই ম্যান পেজটি একটি এক্সিকিউটেবল কমান্ডের জন্য। এটি একটি বাধ্যতামূলক নয় বরং ম্যান পেজ লেখার সময় একটি ব্যাপকভাবে অনুসরণ করা নিয়ম। মানুষের জন্য ম্যানুয়াল পৃষ্ঠা (মানুষ মানুষ !) বিভাগগুলি তালিকাভুক্ত করে:

 1 এক্সিকিউটেবল প্রোগ্রাম বা শেল কমান্ড 2 সিস্টেম কল (কার্নেল দ্বারা প্রদত্ত ফাংশন) 3 লাইব্রেরি কল (প্রোগ্রাম লাইব্রেরির মধ্যে ফাংশন) 4 বিশেষ ফাইল (সাধারণত /dev এ পাওয়া যায়) 5 ফাইল ফর্ম্যাট এবং কনভেনশন যেমন /etc/passwd 6 গেম 7 বিবিধ ( ম্যাক্রো প্যাকেজ এবং কনভেনশন সহ), যেমন man(7), groff(7) 8 সিস্টেম অ্যাডমিনিস্ট্রেশন কমান্ড (সাধারণত শুধুমাত্র রুটের জন্য) 9 কার্নেল রুটিন [নন স্ট্যান্ডার্ড]

একটি ম্যান পেজ খুব পুরানো roff মার্কআপ ভাষা ব্যবহার করে তৈরি করা হয়। এটিতে বিভিন্ন শিরোনাম এবং বিভাগের জন্য কমান্ড (মার্কার পড়ুন) রয়েছে।

  • .TH - এটি ম্যান ফাইলের প্রথম কমান্ড হওয়া উচিত। এটি ম্যান পৃষ্ঠার শিরোনাম নির্দিষ্ট করতে ব্যবহৃত হয়।
  • .এসএইচ - বিভাগের শিরোনাম।
  • .বি - এটির পাশের টেক্সটটি বোল্ডে প্রদর্শন করতে ব্যবহৃত হয়।
  • .TP - এটি কমান্ডে একটি আর্গুমেন্ট (পতাকা) সম্পর্কে তথ্য প্রদর্শন করতে ব্যবহৃত হয়।
  • .বি.আর - এটি বোল্ড এবং সাধারণ রোমান ফন্টে পাঠ্য প্রদর্শন করতে ব্যবহৃত হয়।

শুধুমাত্র উপরের (সরল) roff কমান্ড ব্যবহার করে তৈরি করা আমার প্রোগ্রামের জন্য ম্যান পেজটি নিচে দেওয়া হল।

.TH test.sh 1 .SH NAME test.sh \- হ্যালো বা বাই প্রিন্ট করুন .SH SYNOPSIS .B test.sh [ h ] [ b ] .SH বর্ণনা .B test.sh এটি একটি নমুনা স্ক্রিপ্ট যা শুধুমাত্র 2টি জিনিস করে . আর্গুমেন্ট 'h' হলে এটি হয় "হ্যালো" প্রিন্ট করে অথবা আর্গুমেন্ট 'b' হলে এটি "বাই" প্রিন্ট করে। SH বিকল্প .TP .BR h প্রিন্ট হ্যালো .TP .BR b প্রিন্ট বাই

ফাইলটি সংরক্ষণ করুন প্রথম টিপে প্রস্থান কী, এবং তারপর টাইপ করুন :wq ফাইলটি সংরক্ষণ করতে এবং vim কনসোল থেকে প্রস্থান করতে।

নীচের কমান্ডটি ব্যবহার করে আমরা যে ম্যান পৃষ্ঠাটি তৈরি করেছি তা পরীক্ষা করুন:

মানুষ ./পরীক্ষা.1

আরো তথ্যের জন্য মানুষ ব্যবহার, চালান man man-pages আপনার টার্মিনালে কমান্ড।

? টিপ

এটি ম্যান পেজ লেখার জন্য মৌলিক সিনট্যাক্স। জিনিসগুলিকে সহজ করার জন্য, আপনি txt2man এর মতো টুল ব্যবহার করতে পারেন কিছু মার্কআপ ল্যাঙ্গুয়েজ ফরম্যাটে একটি ফাইলকে roff ফরম্যাটে রূপান্তর করতে।