إجعل صفحات man أكثر سهولة للقراءة و الفهم عن طريق هاته الخاصية .

السلام عليكم و رحمة الله و بركاته

قبل أن ابدأ الموضوع أحب أن أقدم اعتذاري نيابة عني و على إخوة طاقم الموقع على الانقطاع الذي طال وذالك لأسباب متعددة لكن و الحمد لله و فقنا لنستأنف تقديم هاته الرسالة و هي إثراء المحتوى العربي خصوصا و العلمي عموما في مجال البرمجيات الحرة و البرمجيات مفتوحة المصدر و كذا تناول نظام جنو/لينكس بصفة أكثر و نطلب من الله التوفيق و السداد لنا و لكل مسلمين .

و الموضوع هو كيفية التعديل على كتيبات إرشادية أو man و جعلها تعرض بطريقة ملونة ذالك سيعطي للمستخدم فهم أكثر و سهولة أكثر أثناء استخدام , لكن قبل ذالك دعونا نتعرف على man وهذا لنسهل الأمر على المستخدمين الجدد أكثر :
man pages :

الكُتيِّبات الإرشادية (اختصار لـ "manual pages") هي عبارة عن وثائق شاملة محملة مسبقاً مع غالبية أنظمة التشغيل المشابهة ليونِكس الأساسية (UNIX-like) ، بما فيها توزيعات لينكس ، والأمر المستخدم في إظهار الوثائق هو man.

الوصول إلى الكُتيِّبات الإرشادية

لقراءة إحدى الكتيبات الخاص بأمر ما بكل بساطة ما عليك تطبيقه هو أمر :

man command

على سبيل المثال سنعرض دليل أمر mv و للعلم هو أمر يستخدم في نقل و إعادة تسمية الملفات و المجلدات :

man mv

و الناتج سيكون كالتالي :

التصميم

جميع الكتيِّبات تتبع تصميماً قياسياً إلى حد ما مما يساعد في التنقل بينها، تتضمن بعض الأقسام الموجودة في الكتيِّب الأشياء التالية غالباً:

NAME - اسم الأمر والغرض منه

SYNOPSIS - قائمة بالخيارات والمُعامِلات التي يتطلبها الأمر أو المتغيرات التي تتطلبها الدالة وملفها الأولي

DESCRIPTION - المزيد من الوصف الدقيق لوظيفة الأمر أو التعليمة

EXAMPLES - أمثلة عامة، عادة تتراوح بين البسيطة والمعقدة نسبياً

OPTIONS - وصف لكل خيار من الخيارات التي يستخدمها الأمر وما يمكنها القيام به

EXIT STATUS - معاني رموز المخرجات المختلفة

FILES - ملفات متصلة بالأمر أو الدالة

BUGS - مشكلات أو علل عند استخدام الأمر أو الدالة وهي قيد الإصلاح، تعرف أيضاً بـ KNOWN BUGS

SEE ALSO - قائمة بأوامر أو دوال مشابهة أو مرتبطة

AUTHOR, HISTORY, COPYRIGHT, LICENCE, WARRANTY - معلومات عن البرنامج وتاريخه وشروط استخدامه ومؤلفه

كما ترون أسفل NAME نجد تعريف الأمر و هكذا تواليك لكن العنوان و الوصف و غيرها بلون واحد مما يعطي بعض الصعوبة في القراءة و هذا ما سنعالجه .

تلوين الكتيبات الإرشادية

الكُتيِّبات الإرشادية "مفعلة الألوان" تعرض المعلومات بشكل أوضح مما يؤدي إلى فهم أسهل للمحتوى، هناك طريقتان شائعتان للحصول على كتيِّبات ملونة :
استخدام less أو most .

اليوم سأشرح الطريقة على less حيث أن less تمتلك مجموعة ميزات أكثر من most، كما أنها تستخدم افتراضياً لعرض الكتيِّبات الإرشادية .

وطريقة فعل ذالك سهلة و بسيطة كل ما علينا هو تعديل ملف bashrc الخاص بنا و لفعل ذالك نقوم بالدخول بمحرر نصوص و سأستعمل في شرح nano يمكنك استخدام محرر اخر و الأمر هو :

nano ~/.bashrc

بعد الدخول نقوم بالنزول للأسفل و إضافة الكود التالي :

man() {
    env LESS_TERMCAP_mb=$(printf "\e[1;31m") \
        LESS_TERMCAP_md=$(printf "\e[1;31m") \
        LESS_TERMCAP_me=$(printf "\e[0m") \
        LESS_TERMCAP_se=$(printf "\e[0m") \
        LESS_TERMCAP_so=$(printf "\e[1;44;33m") \
        LESS_TERMCAP_ue=$(printf "\e[0m") \
        LESS_TERMCAP_us=$(printf "\e[1;32m") \
man "$@"
}

و للصق ملف ما على nano ما عليك إلى استعمال اختصار ctrl + shift + v بعدها نقوم بحفض الملف عن طريق ctrl + x تم y تم enter .

بعد أن تقوم بإغلاق الجلسة و إعادة الدخول إلى سطر أوامر من جلسة أخرى طبق الأمر

man mv

ولاحظ طريقة العرض الجديدة و التي تعطي سهولة أكثر للقراءة و للعلم يمكن التعديل على هاته ألوان من الكود الذي أضفنا على bashrc لمزيد من المعلومات ANSI escape code :