Difference between revisions of "Man page (العربية)"

From ArchWiki
Jump to: navigation, search
m (removed invalid DISPLAYTITLE)
Line 5: Line 5:
 
[[ru:Man Page]]
 
[[ru:Man Page]]
 
[[zh-CN:Man Page]]
 
[[zh-CN:Man Page]]
{{DISPLAYTITLE:man pages}}
 
 
 
<div style="text-align: right; direction:rtl;margin-right:30px;">
 
<div style="text-align: right; direction:rtl;margin-right:30px;">
 
'''man pages''' الكُتيِّبات الإرشادية (اختصار لـ "manual pages") هي عبارة عن وثائق شاملة محملة مسبقاً مع غالبية أنظمة التشغيل المشابهة ليونِكس الأساسية ((UNIX-like))، بما فيها Arch Linux، والأمر المستخدم في إظهار الوثائق هو {{Ic|man}}.
 
'''man pages''' الكُتيِّبات الإرشادية (اختصار لـ "manual pages") هي عبارة عن وثائق شاملة محملة مسبقاً مع غالبية أنظمة التشغيل المشابهة ليونِكس الأساسية ((UNIX-like))، بما فيها Arch Linux، والأمر المستخدم في إظهار الوثائق هو {{Ic|man}}.

Revision as of 21:01, 5 July 2014

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     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.

Usage: manpdf [<section>] <manpage>
#!/usr/bin/perl
use File::stat;

$pdfdir = $ENV{"HOME"}."/.manpdf";
-d $pdfdir || mkdir $pdfdir || die "can't create $pdfdir";
$manpage = $ARGV[0];
chop($manpath = `man -w $manpage`);
die if $?;

$maninfo = stat($manpath) or die;
$manpath =~ s@.*/man./(.*)(\.(gz|bz2))?$@$1@;
$pdfpath = "$pdfdir/$manpath.pdf";
$pdftime = 0;
if (-f $pdfpath) {
    $pdfinfo = stat($pdfpath) or die;
    $pdftime = $pdfinfo->mtime;
}
if (!-f $pdfpath || $maninfo->mtime > $pdftime) {
    system "man -t $manpage | ps2pdf -dPDFSETTINGS=/screen - $pdfpath";
}
die if !-f $pdfpath;
if (!fork) {
    open(STDOUT, "/dev/null");
    open(STDERR, "/dev/null");
    exec "mupdf", "-r", "96", $pdfpath;
    #exec "acroread", $pdfpath;
}

الكُتيِّبات الإرشادية على الإنترنت

هناك العديد من قواعد البيانات لكتيِّبات إرشادية متوفرة على الإنترنت، من ضمنها:

كُتيِّبات إرشادية جديرة بالاطلاع

في ما يلي قائمة غير حصرية لكتيِّبات جديرة بالاطلاع والتي قد تساعدك في فهم العديد من الأشياء بشكل أكبر، البعض منها تستطيع اعتباره مرجعاً (مثل جدول ascii):

  • ascii(7)
  • boot(7)
  • charsets(7)
  • chmod(1)
  • credentials(7)
  • fstab(5)
  • hier(7)
  • systemd(1)
  • locale(1P)(5)(7)
  • printf(3)
  • proc(5)
  • regex(7)
  • signal(7)
  • term(5)(7)
  • termcap(5)
  • terminfo(5)
  • utf-8(7)

ألقِ نظرة على كتيِّبات الفئة السابعة:

$ man -s 7 -k ".*" 

كتيِّبات Arch Linux المميزة:

  • archlinux(7)
  • mkinitcpio(8)
  • pacman(8)
  • pacman-key(8)
  • pacman.conf(5)

انظر أيضاً