Man page (العربية)

From ArchWiki
Revision as of 23:44, 30 May 2013 by Abuelseeb (talk | contribs) (Created page with "Category:System administration (العربية) Category:العربية ko:Man Page ru:Man Page zh-CN:Man Page {{Article summary start|Summary}} {{Article ...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

zh-CN:Man Page Template:Article summary start Template:Article summary text Template:Article summary end


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

على الرغم من إمكانياتها إلا أن صفحات الكتيب صممت لتكون وثائق مستقلة قائمة بذاتها، وبناءً على ذلك تم منع الإشارة ﻷي صفحات كتيبات أخرى عند مناقشة مواضيع متصلة، وهذا اختلاف كبير مع "ملفات معلومات الوعي بالارتباطات التشعبية"((hyperlink-aware))، وهي محاولة "غنو" لاستبدال البنية التقليدية لصفحات الكتيب.

الوصول إلى صفحات الكتيب

لقراءة إحدى الصفحات، أدخل التالي:

$ man page_name

تم تصنيف الكتيبات إلى عدة أقسام:

  1. الأوامر العامة
  2. استدعاءات النظام (دوال أو توابع تم تزويدها من قبل النواة)
  3. استدعاءات المكتبة ( دوال أو توابع لمكتبة C)
  4. ملفات خاصة (عادةً توجد في المسار /dev) وملفات التعريف Drivers
  5. صيغ واتفاقيات الملفات
  6. ألعاب
  7. متفرقات (بما فيها الاتفاقيات)
  8. أوامر إدارة النظام (عادة تتطلب صلاحيات الجذر root) والمخفيات daemons

عادة يشار إلى صفحات الكتيب بأسمائها يليها رقم القسم المصنفة داخله ويوضع داخل أقواس، غالباً هناك صفحات كتيب متعددة لنفس الاسم مثل man(1) و man(2)، في هذه الحالة قم بإدخال رقم القسم ثم اسم الصفحة المطلوبة، مثال:

$ man 5 passwd

لقراءة صفحة الكتيب الموجودة في المسار /etc/passwd بدلاً من عرض صفحة الكتيب الخاصة بأداة passwd.

يمكن عرض وصف مختصر جداً للبرامج من صفحات الكتيب من دون عرض الصفحة كاملة وذلك باستخدام الأمر whatis، على سبيل المثال لعرض وصف موجز لـ ls أكتب:

$ whatis ls

وسيقوم whatis بإظهار "list directory contents".


التصميم

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

  • NAME - اسم الأمر والغرض منه
  • SYNOPSIS - قائمة بالخيارات والمُعامِلات التي يتطلبها الأمر أو المتغيرات التي تتطلبها الدالة وملفها الأولي
  • DESCRIPTION - المزيد من الوصف الدقيق لوظيفة الأمر أو التعليمة
  • EXAMPLES - أمثلة عامة، عادة تتراوح بين البسيطة والمعقدة نسبياً
  • OPTIONS - وصف لكل خيار من الخيارات التي يستخدمها الأمر وما يمكنها القيام به
  • EXIT STATUS - معاني رموز المخرجات المختلفة
  • FILES - ملفات متصلة بالأمر أو الدالة
  • BUGS - مشكلات أو علل عند استخدام الأمر أو الدالة وهي قيد الإصلاح، تعرف أيضاً بـ KNOWN BUGS
  • SEE ALSO - قائمة بأوامر أو دوال مشابهة أو مرتبطة
  • AUTHOR, HISTORY, COPYRIGHT, LICENCE, WARRANTY - معلومات عن البرنامج وتاريخه وشروط استخدامه ومؤلفه

البحث في الكتيبات

في حين أن أداة man تمكن المستخدمين من عرض صفحات الكتيب إلا أن المشكلة تظهر عندما لا يعرف المستخدم الاسم الدقيق للصفحة المراد عرضها، من حسن الحظ فإن خيارا -k أو --apropos يمكنا المستخدم من البحث باستخدام كلمة مفتاحية لوصف صفحة الكتيب المطلوبة.

ميزة البحث هذه تقدمها ملفات مخبأة cache مخصصة، بشكل افتراضي فأنت لا تملك أي ملفات مخبأة cache وكل عمليات البحث التي ستقوم بها سترجع لك nothing appropriate، لكنك تستطيع إنشاء ملفات مخبأة cache أو تحديثها عن طريق إدخال:

# mandb

يجب عليك إدخال الأمر السابق في كل مرة تقوم بتثبيت صفحة كتيب جديدة.

الآن تستطيع البدء بالبحث، على سبيل المثال للبحث عن صفحات كتيب تتعلق بـ "password":

$ man -k password

أو

$ man --apropos password

وهذا يماثل استدعاء الأمر apropos:

$ apropos password

الكلمة المفتاحية تم تفسيرها بشكل افتراضي على أنها تعبير عادي.

إذا أردت القيام ببحث أعمق عن طريق مطابقة الكلمات المفتاحية التي وجدت في المقال تستطيع استخدام خيار -K:

$ man -K password

صفحات الكتيب الملونة

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

استخدام less (ينصح به)

المصدر: nion's blog - less colors for man pages

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

أضف التالي لملف تكوين shell (( shell configuration file)) ،باستخدام Bash ستصبح بهذا الشكل:

~/.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 "$@"
}

لتخصيص الألوان انظر Wikipedia:ANSI escape code لرؤية المرجع.

استخدام most (لا ينصح به)

الوظيفة الأساسية لـ 'most' مشابهة لـ less و more، لكنها تمتلك مجموعة ميزات أقل، إعداد most لاستخدام الألوان أسهل من إعداد less لكن يوجد إعدادات إضافية ضرورية لجعل most تتصرف مثل less، قم بتثبيت most باستخدام pacman:

# pacman -S most

قم بتعديل الملف الموجود في المسار /etc/man_db.conf وذلك بإلغاء تعليق السطر المتضمن على تعريف pager (#DEFINE pager) وقم بتغييرها لتصبح كالتالي:

DEFINE     pager     most -s

قم باختبار الإعداد الجديد بكتابة التالي:

$ man whatever_man_page

تعديل قيم الألوان يتطلب تعديل الملف ~/.mostrc (يتم إنشاء الملف إذا لم يكن موجود) أو تعديل الملف /etc/most.conf من أجل تغيرات النظام الواسعة. مثال على ~/.mostrc :

% Color settings
color normal lightgray black
color status yellow blue
color underline yellow black
color overstrike brightblue black

مثال آخر يُظهر أغلفة مفاتيح شبيهة بـ less (القفز إلى السطر تم تعيينه على'J').

% less-like keybindings
unsetkey "^K"
unsetkey "g"
unsetkey "G"
unsetkey ":"
setkey next_file ":n"
setkey find_file ":e"
setkey next_file ":p"
setkey toggle_options ":o"
setkey toggle_case ":c"
setkey delete_file ":d"
setkey exit ":q"
setkey bob "g"
setkey eob "G"
setkey down "e"
setkey down "E"
setkey down "j"
setkey down "^N"
setkey up "y"
setkey up "^Y"
setkey up "k"
setkey up "^P"
setkey up "^K"
setkey page_down "f"
setkey page_down "^F"
setkey page_up "b"
setkey page_up "^B"
setkey other_window "z"
setkey other_window "w"
setkey search_backward "?"
setkey bob "p"
setkey goto_mark "'"
setkey find_file "E"
setkey edit "v"

صفحات الكتيب الملونة في xterm أو rxvt-unicode

المصدر: XFree resources file for XTerm program

الطريقة السريعة لإضافة الألوان لصفحات الكتيب المعروضة على xterm/uxterm أو rxvt-unicode تكون بتعديل ~/.Xresources أو ~/.Xdefaults .

xterm

*VT100.colorBDMode:     true
*VT100.colorBD:         red
*VT100.colorULMode:     true
*VT100.colorUL:         cyan

والتي تستبدل الزخرفة بالألوان، أيضاً قم بإضافة التالي:

*VT100.veryBoldColors: 6

إذا كنت تريد الألوان والزخارف (سميك أو تحته خط) في نفس الوقت انظر man xterm لشرح مصدر veryBoldColors.

rxvt-unicode

URxvt.colorIT:      #87af5f
URxvt.colorBD:      #d7d7d7
URxvt.colorUL:      #87afd7

قم بالتالي:

$ xrdb -load ~/.Xresources

قم بتشغيل xterm/uxterm أو rxvt-unicode من جديد، يجب أن ترى صفحات كتيب ملونة،هذه المجموعة من الأوامر تجعل اللون سميك وتضع خطاً تحت الكلمات في xterm/uxterm أو بالإضافة إلى السُمك والخط فهي تجعل الخط مائلاً في rxvt-unicode، تستطيع أن تعدل في المجموعات المختلفة من هذه السمات(انظر إلى مصادر لهذا الموضوع).

قراءة صفحات الكتيب المحلية

عوضاً عن استخدام الواجهة القياسية فإن استخدام المتصفحات مثل lynx و Firefox للاطلاع على صفحات الكتيب يمكن المستخدمين من الحصول على الفوائد الرئيسية من صفحات المعلومات: النصوص ذات الارتباطات التشعبية((hyperlinked text)). مستخدمي KDE يستطيعون قراءة صفحات الكتيب داخل Konqueror باستخدام التالي:

man:<name>

Official Repositories نستطيع الحصول على احتمالان آخران لقراءة الكتيب وذلك بتثبيت أحد البرامج التالية من المستودعات الرسمية:

1. xorg-xman تقدم مظهراً منظماً لصفحات الكتيب في X.

2. GNOME Help Browser المسمى yelp وهو أكثر تنظيماً لكن لديه بعض الاعتماديات.

التحويل إلى صيغة HTML مقروءة من المتصفح

في البداية قم بتثبيت man2html من المستودعات الرسمية.

ثم قم بتحويل صفحة كتيب:

$ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html

يوجد استعمال آخر لـ man2html وهو التصدير إلى نص ذو صفوف وقابل للطباعة:

$ man free | man2html -bare > ~/free.txt

تطبيق man الخاص بـ "غنو" الموجود في مستودعات Arch له القدرة أيضاً على تنفيذ العملية السابقة من تلقاء نفسه:

$ man -H free

هذا الأمر سيقوم بقراءة متغيرات بيئة BROWSER لتحديد المتصفح، يمكنك تجاوز هذا بتمرير القيمة الثنائية إلى خيار -H.

التحويل إلى PDF

صفحات الكتيب دائماً قابلة للطباعة فهي مكتوبة بـ troff التي هي في الأساس لغة تنضيد((typesitting))، إذا كان لديك ghostscript مثبت على الجهاز فإن عملية تحويل صفحة كتيب إلى PDF سهلة جداً: man -t <manpage> | ps2pdf - <pdf> . هذا البحث في google image سيعطيك فكرةً عن شكل الناتج من عملية التحويل، وقد لا يروق هذا الشكل للجميع. محاذير: الخطوط تقتصر عادة على أحجام خطوط Times المضمنة، ولا يوجد ارتباطات تشعبية،بعض صفحات الكتيب صممت خصيصاً لطريقة العرض في الطرفية ولن تظهر بشكل جيد بصيغة PS أو PDF. السكربت التالي المكتوب بلغة Perl يقوم بتحويل صفحات الكتيب إلى ملفات PDF ويخزن هذه الملفات في المسار $Home/.manpdf/ ومن ثم يشغل برنامج لعرض ملفات PDF وعلى وجه التحديد برنامج mupdf. - - - - - - -


صفحات الكتيب على الإنترنت هناك العديد من قواعد البيانات لصفحات الكتيب المتوفرة على الإنترنت، من ضمنها: - - - - - - -


صفحات كتيب جديرة بالاطلاع في ما يلي قائمة غير حصرية لصفحات جديرة بالاطلاع والتي قد تساعدك في فهم العديد من الأشياء بشكل أكبر، البعض منها تستطيع اعتباره مرجعاً (مثل جدول ascii): - - - - - - - - - ألقي نظرة على صفحات الفئة السابعة: $ man -s 7 -k ".*" صفحات Arch Linux المميزة: - - - - - - - -


انظر أيضاً XXXXXXXXXXXXXX - توصيات عامة لـ Arch


ملخص معلومات عن صفحات الكتيب بالإضافة لتوصيات حول تحسين استخدامها.