1. ডকুমেন্টে ব্যবহৃত নিয়ম নীতি
কোনো বিশেষ তথ্যের প্রতি আপনার দৃষ্টি আকর্ষণ করতে সহায়িকার মধ্যে শব্দ ও পংক্তিকে তথ্যের গুরুত্ব অনুযায়ী বিভিন্ন রূপে চিহ্নিত করা হয়েছে।
1.1. মুদ্রণ সংক্রান্ত নিয়মাবলী
কিছু শব্দ ও পংক্তির প্রতি পাঠকের দৃষ্টি আকর্ষণ করার জন্য সেগুলি লেখার সময় মুদ্রণ সংক্রান্ত চার ধরনের নিয়াম পালন করা হয়েছে। এই নিয়াবলী ও সেগুলি ব্যবহারের পরিস্থিতি সম্বন্ধে পরবর্তী অংশে আলোচনা করা হয়েছে।
মোনো-স্পেসড বোল্ড
সিস্টেমের জন্য ইনপুট যেমন শেল কমান্ড, ফাইলের নাম ও পাথ লিখতে ব্যবহার করা হয়েছে। কি-র নাম অথবা কি সংকলন চিহ্নিত করার জন্যও ব্যবহৃত। উদাহরণস্বরূপ:
কাজের জন্য ব্যবহৃত বর্তমান ডিরেক্টরির মধ্যে my_next_bestselling_novel
ফাইলের বিষয়বস্তু প্রদর্শনের উদ্দেশ্যে, শেল প্রম্পটের মধ্যে cat my_next_bestselling_novel
কমান্ড লিখুন ও Enter টিপে কমান্ডটি সঞ্চালন করুন।
উপরোক্ত পংক্তির মধ্যে একটি ফাইলের নাম, শেল কমান্ড ও কি-র নাম মোনো-স্পেস্ড বোল্ডে লেখা হয়েছে এবং সেগুলি পৃথকরূপে চিহ্নিত করা সম্ভব।
কি-সংকলনগুলির ক্ষেত্রে ব্যবহৃত হাইফেন চিহ্নের কারণে একক কি থেকে পৃথক রূপে সনাক্ত করা সম্ভব হবে। উদাহরণস্বরূপ:
Enter টিপে কমান্ড সঞ্চালন করুন।
প্রথম ভার্চুয়াল টার্মিনালে পরিবর্তন করার জন্য Ctrl+Alt+F1 টিপুন। X-Windows সেশানে প্রত্যাবর্তনের জন্য Ctrl+Alt+F7 টিপুন।
প্রথম পংক্তিতে প্রযোজ্য কি-র অংশ উজ্জ্বল করা হয়। দ্বিতীয় পংক্তিটিতে তিনটি কি-র একত্রিত প্রয়োগের দুটি সংকলন উজ্জ্বল করা হয়।
সোর্স কোড সম্পর্কে আলোচনার সময় অনুচ্ছেদের মধ্যে উল্লিখিত ক্লাসের নাম, মেথড, ফাংশান, ভেরিয়েবলের নাম ও প্রাপ্ত ফলাফলের মান মোনো-স্পেস্ড বোল্ড
-এ লেখা হবে। উদাহরণস্বরূপ:
ফাইল সম্পর্কিত ক্লাসের মধ্যে রয়েছে filesystem
ফাইল-সিস্টেমের জন্য, file
ফাইলের জন্য, এবং dir
ডিরেক্টরির জন্য। প্রতিটি ক্লাসের ক্ষেত্রে প্রযোজ্য অনুমতি নির্ধারিত রয়েছে।
আপেক্ষিক বোল্ড
এই বিন্যাস দ্বারা সিস্টেমের মধ্যে প্রাপ্ত শব্দ অথবা পংক্তি যেমন অ্যাপ্লিকেশনের নাম; ডায়লগ বক্সের লেখা; লেবেল করা বাটন; চেক-বক্স ও রেডিও-বাটনের লেবেল; মেনু ও সাব-মেনুর শিরোনাম প্রভৃতি উল্লেখ করা হয়। উদাহরণস্বরূপ:
মাউস সম্পর্কিত পছন্দ আরম্ভ করার জন্য প্রধান মেনু বার থেকে নির্বাচন করুন। বাটন ট্যাবের মধ্যে বাঁহাতি মাউস শীর্ষক চেকবক্স নির্বাচন করুন ও বন্ধ করুন টিপে, মাউসের বাঁদিকের বাটনের পরিবর্তে ডানদিকের বাটনটিকে প্রধান বাটন রূপে নির্ধারণ করুন (এর ফলে মাউসটি বাঁ হাতে ব্যবহারের জন্য সুবিধাজনক হবে)।
gedit ফাইলের মধ্যে কোনো বিশেষ অক্ষর অন্তর্ভুক্ত করা জন্য প্রধান মেনু বার থেকে নির্বাচন করুন। এর পরে অক্ষরের ম্যাপ-র প্রধান মেনু থেকে নির্বাচন করুন ও অনুসন্ধান শীর্ষক ক্ষেত্রের মধ্যে প্রয়েজনীয় অক্ষরটি লিখে পরবর্তী শীর্ষক বাটন ক্লিক করুন। অনুসন্ধান করা অক্ষরটি অক্ষরের টেবিল-এ উজ্জ্বলিত করা হবে। উজ্জ্বলিত অক্ষরটি দুইবার ক্লিক করে কপি করার জন্য চিহ্নিত বিষয়বস্তু ক্ষেত্রে স্থাপন করে কপি করুন শীর্ষক বাটনটি ক্লিক করুন। এর পরে, এডিটরে প্রত্যাবর্তন করে gedit-র মেনু বার থেকে নির্বাচন করুন।
উপরোক্ত অংশে রয়েছে অ্যাপ্লিকেশনের নাম; সিস্টেমের মেনু ও মেনুর বস্তুর নাম; অ্যাপ্লিকেশনের মেনুর নাম; ও GUI প্রেক্ষাপটে প্রদর্শিত বাটন ও টেক্সট। এই সমস্ত বস্তু আপেক্ষিক বোল্ড বিন্যাসে প্রদর্শিত হয়েছে ও সহজেই পৃথকরূপে সনাক্ত করা যাবে।
মেনু ও সাব-মেনুর মধ্যে চলাচলের জন্য চিহ্ন প্রয়োগ করা হয়েছে। তূলনামূলকভাবে কঠিন নির্দেশাবলী পরিবর্তে এই প্রণালী ব্যবহার করা হয়েছে, যেমন 'প্রধান মেনু বারের মধ্যে মেনুর মধ্যে উপস্থিত সাব-মেনু থেকে নির্বাচন করুন'।
মোনো-স্পেস্ড বোল্ড আইটালিক
অথবা আপেক্ষিক বোল্ড আইটালিক
স্পেস্ড অথবা আপেক্ষিক বোল্ড নির্বিশেষে,আইটালিক দ্বারা চিহ্নিত লেখাগুলি পরিবর্তনযোগ্য মান নির্দেশ করে অর্থাৎ চিহ্নিত লেখাগুলি লেখা অথবা প্রদর্শন করা হবে না ও পরিস্থিতি অনুযায়ী পরিবর্তন করা হবে। উদাহরণস্বরূপ:
ssh সহযোগে কোনো দূরবর্তী মেশিনের সাথে সংযোগ স্থাপনের জন্য, শেল প্রম্পটে ssh username
@domain.name
লিখুন। দূরবর্তী মেশিনের নাম example.com
ও সেই মেশিনে আপনার অ্যাকাউন্টের নাম john হলে, ssh john@example.com
লিখুন।
mount -o remount file-system
কমান্ডের সাহায্যে সংশ্লিষ্ট ফাইল-সিস্টেম পুনরায় মাউন্ট করা হয়। উদাহরণস্বরূপ, /home
ফাইল-সিস্টেম পুনরায় মাউন্ট করার জন্য, mount -o remount /home
কমান্ড ব্যবহার করুন।
ইনস্টল করা কোনো প্যাকেজের সংস্করণ সংখ্যা জানার জন্য rpm -q package
কমান্ড প্রয়োগ করুন। এর ফলে নিম্নলিখিত বিন্যাসে ফলাফল প্রদর্শিত হবে: package-version-release
।
গাঢ় ও আইটালিক বিন্যাসে চিহ্নিত শব্দগুলি লক্ষ্য করুন— username, domain.name, file-system, package, version ও release। প্রতিটি শব্দ একটি স্থানকে চিহ্নিত করছে এবং কমান্ড লেখার সময় অথবা সিস্টেমে দ্বারা প্রদর্শিত লেখা এই শব্দগুলির পরিবর্তে প্রদর্শিত হবে।
কোনো কাজের শিরোনামে আইটালিকের ব্যবহার ব্যতীত, কোনো নতুন ও গুরুত্বপূর্ণ অভিব্যক্তির প্রথম উল্লেখের সময় এই বিন্যাস প্রয়োগ করা হয়। উদাহরণস্বরূপ:
Apache HTTP সার্ভার দ্বারা অনুরোধ গ্রহণ করা হলে, সেগুলির ব্যবস্থাপনার জন্য চাইল্ড প্রসেস অথবা থ্রেড আরম্ভ করা হয়। চাইল্ড প্রসেস অথবা থ্রেডের এই সংকলনটি server-pool নামে পরিচিত। Apache HTTP Server 2.0-র অধীন, নির্মাণ ও পরিচালনার দায়িত্বভার Multi-Processing Modules (MPMs) নামক মডিউল সংকলেনর উপর ধার্য করা হয়েছে। অন্যান্য মডিউলের তুলনায় MPM সংকলনের শুধুমাত্র একটি মডিউল Apache HTTP সার্ভার মডিউলে লোড করা যাবে।
1.2. বিশেষ দ্রষ্টব্য সংক্রান্ত নিয়মাবলী
একাধিক পংক্তি বিশিষ্ট দুটি ডাটা-টাইপ, পার্শবর্তী লেখার থেকে ভিন্ন রূপে প্রদর্শন করা হয়।
টার্মিনালে প্রদর্শিত আউটপুট মোনো-স্পেস্ড রোমান
মুদ্রাক্ষরে নিম্নলিখিত রূপে প্রদর্শিত হবে:
books Desktop documentation drafts mss photos stuff svn
books_tests Desktop1 downloads images notes scripts svgs
সোর্স কোডের অংশগুলিও মোনো-স্পেস্ড রোমান
মুদ্রাক্ষরে লেখা হয় কিন্তু নিম্নলিখিত প্রণালীতে উজ্জ্বল করে চিহ্নিত করা হয়:
package org.jboss.book.jca.ex1;
import javax.naming.InitialContext;
public class ExClient
{
public static void main(String args[])
throws Exception
{
InitialContext iniCtx = new InitialContext();
Object ref = iniCtx.lookup("EchoBean");
EchoHome home = (EchoHome) ref;
Echo echo = home.create();
System.out.println("Created Echo");
System.out.println("Echo.echo('Hello') = " + echo.echo("Hello"));
}
}
1.3. উল্লেখ্যবস্তু ও সতর্কবাণী
অবশেষে, সহজে উপেক্ষিত কিছু তথ্যের প্রতি পাঠকের দৃষ্টি আকর্ষণের উদ্দেশ্যে তিনটি ভিন্ন ধরনের বিন্যাস প্রয়োগ করা হয়।
উল্লেখ্য
উল্লেখ্য শীর্ষক লেখাগুলি মূলত কোনো ধরনের সহজ উপায় প্রভৃতি সম্পর্কে পাঠককে ওয়াকিবহাল করতে প্রয়োগ করা হয়। এই ধরনের তথ্য উপেক্ষা করার ফলে কোনো ক্ষয়ক্ষতি না হলেও, পাঠকের কাজে সহায়ক তথ্যাদি তাদের অজানা থেকে যাবে।
গুরুত্বপূর্ণ
ভুলবসত সহজেই উপেক্ষিত তথ্যগুলি গুরুত্বপূর্ণ শীর্ষক বাক্সগুলির মধ্যে লেখা হয়: configuration changes that only apply to the current session, or services that need restarting before an update will apply. গুরুত্বপূর্ণ শীর্ষক বাক্সের মধ্যে লেখা তথ্যগুলি উপেক্ষিত হলে তথ্য হারানোর সম্ভাবনা না থাকলেও অযথা বাধা বিঘ্ন সৃষ্টি হতে পারে।
সতর্কবাণী
সতর্কবাণী উপেক্ষা করা উচিত নয় এবং এটি উপেক্ষা করা হলে তথ্য হারানোর সম্ভাবনা রয়েছে।