كيف أجد الوثائق في نظام جنو / لينكس الخاص بي

كثير من هؤلاء الجدد في العالم جنو / لينكس إنهم مليئون بالشكوك ولا يمكنهم العثور على إجابة سريعة لمخاوفهم ، وأحيانًا لا يكون لديهم اتصال يمكن من خلاله الوصول إلى منتدى دعم وينتهي بهم الأمر في النهاية بفكرة أن Linux صعب للغاية بالنسبة لهم.

معظم أولئك الذين يجدون أنفسهم في هذا الموقف لا يدركون أن نظامنا يحتوي على جزء جيد من الإجابات على مخاوفنا الأولية. هناك ثلاثة مصادر أساسية للتوثيق في النظام جنو / لينكس: صفحات الدليل (صفحات الدليل) وصفحات المعلومات (صفحات المعلومات) وكتيبات التطبيقات المجمعة في / usr / share / doc.

في هذه المقالة سوف نوضح بالتفصيل كل من هذه المصادر.

---

صفحات الرجل

صفحات الدليل أو "صفحات الدليل" هي الأشكال الكلاسيكية للتوثيق المرجعي في Linux و Unix. من الناحية المثالية ، يمكنك البحث في صفحات الدليل للحصول على تعليمات لأي أمر أو ملف تكوين أو روتين مكتبة.

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

سيتم بدء الترحيل ، لذلك سوف تضغط q عندما أنهي القراءة. على سبيل المثال ، للعثور على معلومات حول الأمر ls، أود أن أكتب:

رجل $ ls

من خلال معرفة أجزاء صفحات الدليل ، قد يكون من المفيد الانتقال بسرعة إلى المعلومات التي تحتاجها ، وستجد الأقسام التالية في صفحة الدليل (المربع 1):

الجدول 1: صفحات الدليل

اسم	اسم الأمر ووصفه
موجز	كيفية استخدام الأمر
الوصف	شرح مفصل لكيفية عمل الأمر
أمثلة	اقتراحات حول كيفية استخدام الأمر
أنظر أيضا	مواضيع ذات صلة (عادة في صفحات الدليل)

أقسام صفحات الرجل

يتم تخزين الملفات التي تتكون منها صفحات الدليل في / البيرة / حصة / رجل (أو في / البيرة / رجل على بعض الأنظمة القديمة). داخل هذا الدليل ، ستجد أن صفحات الدليل منظمة في الأقسام التالية (المربع 2).

الجدول 2: أقسام صفحات الدليل

man1	برامج المستخدم
man2	مكالمات النظام
man3	وظائف المكتبة
man4	ملفات خاصة
man5	تنسيق الملف
man6	ألعاب
man7	المنوعات

صفحات رجل متعددة

بعض المواضيع موجودة في أكثر من قسم. لإثبات هذا ، سنستخدم الأمر ما هذا، والذي يعرض جميع صفحات الدليل المتوفرة لهذا الموضوع:

$ ما هو printf

printf (1) - تنسيق وطباعة البيانات

printf (3) - تحويل الإخراج المنسق

في هذه الحالة، رجل printf سيكون على الصفحة في القسم 1 (برامج المستخدم). إذا كتبنا برنامج C ، فسنكون أكثر اهتمامًا بالصفحة في القسم 3 (وظائف المكتبة). يمكنك استدعاء قسم معين من صفحات الرجل عن طريق تحديده في سطر الأوامر ، لذلك اسأل printfيمكننا كتابة:

$ رجل 3 printf

العثور على صفحة الرجل الصحيحة

في بعض الأحيان يكون من الصعب العثور على بضع صفحات رجال حول موضوع معين. في هذه الحالة ، يمكنك استخدام رجل -ك للعثور على قسم NAME في صفحات الرجل. اعلم أن هذا بحث سلسلة فرعية ، لذلك شيء مثل رجل -k ls ستعطيك الكثير من المخرجات ، إليك مثال باستخدام كلمة أكثر تحديدًا:

$ man -k whatis whatis (1) - طباعة أوصاف صفحة الدليل

كل شيء عن apropos

جلب لنا المثال السابق بضع نقاط أخرى. أولا ، الأمر سديد يعادل بالضبط رجل -ك، (في الواقع ، سأعطيك سرًا. عندما تركض رجل -ك في الواقع تشغيل سديد خلف الكواليس).

---

سطر كود MANPATH

ننتقل الآن إلى النوع الثاني من التوثيق الذي سنجده في نظامنا جنو / لينكس. افتراضيًا ، يبحث برنامج man عن صفحات man في / usr / share / man ، / البيرة / المحلية / رجل, / البيرة / X11R6 / رجل وربما / اختيار / رجل. في بعض الأحيان يمكنك العثور على ما تحتاجه عن طريق إضافة مسار إضافي إلى مسار البحث. هذا هو الحال ، فقط قم بالتحرير /etc/man.conf في محرر نصوص وأضف سطرًا كما يلي:

MANPATH / opt / man

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

---

معلومات جنو

تتمثل إحدى عيوب صفحات الدليل في أنها لا تدعم النص التشعبي لذا لا يمكنك الانتقال بسهولة من صفحة إلى أخرى. يتعرف أصدقاء جنو على هذا الخلل ، لذا اخترعوا تنسيق توثيق آخر: صفحات "المعلومات".

تأتي العديد من برامج جنو مصحوبة بوثائق شاملة في تنسيق صفحة المعلومات. يمكنك البدء في قراءة صفحات المعلومات باستخدام الأمر info:

بهذه الطريقة سنقوم بإحضار فهرس لجميع صفحات المعلومات المتاحة في النظام. يمكنك التنقل بينها باستخدام مفاتيح الأسهم ، واتباع "الروابط" (المشار إليها بنجمة) باستخدام مفتاح Enter والخروج بالضغط q. تستند المفاتيح إلى Emacs ، لذلك من السهل عليك التنقل إذا كنت معتادًا على هذا المحرر.

لمزيد من المعلومات مع استخدام info، اقرأ صفحة المعلومات الخاصة بهم. يجب أن تكون قادرًا على التنقل بينها باستخدام المفاتيح المذكورة أعلاه:

معلومات $

---

/ usr / share / doc

هناك مصدر واحد أخير يمكنه مساعدتك داخل نظام Linux. تأتي العديد من البرامج مزودة بوثائق إضافية بتنسيقات أخرى: نص ، PDF ، PostScript ، HTML ، على سبيل المثال لا الحصر.

ألق نظرة على / usr / share / doc (/ usr / doc على الأنظمة القديمة). ستجد قائمة طويلة من الدلائل ، كل منها يأتي مع التطبيقات الموجودة على نظامك. غالبًا ما يكشف البحث في هذه الوثائق عن شيء مثير للاهتمام ، مثل البرامج التعليمية أو الوثائق الفنية الإضافية. يكشف الفحص السريع عن الكثير من المواد المتاحة للقراءة:

$ cd / usr / share / doc

$ تجد. من النوع و | مرحاض -l

---

سنشير في مقالات أخرى إلى المصادر الخارجية للوثائق مثل مشروع توثيق Linux (LDP) والقوائم البريدية ومجموعات الأخبار.

المصدر: مقال مأخوذ من جوتل وكتبه ميكيل لاماريت هيريديا. الروابط: https://blog.desdelinux.net, http://www.raybenjamin.com, http://forum.codecall.net, http://www.linfo.org,  http://www.esdebian.org