معجم لينكس - تشريح صفحة رجل

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

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

الخلاصة
هناك درجات متفاوتة من قابلية القراءة من صفحة رجل إلى صفحة دليل ، ولكن هناك أمر واحد مؤكد ، يتمثل أصعب جزء في فك تشفير الملخص المشعر. هناك العديد من الاصطلاحات للإشارة إلى أجزاء المعلومات المطلوبة لأي أمر معين. تتكون هذه الاصطلاحات من أقواس وأقواس مختلفة ، بالإضافة إلى أشكال أخرى من التدوين. كل هذه الاصطلاحات المختلفة يمكن أن تكون مربكة للغاية بالنسبة للمبتدئين ، ولا تزال شاقة لشخص ذو خبرة ولكن ليس على دراية بفن الكتيبات. أدناه سنقوم بتقسيم gibberish إلى قواعد قابلة للفهم.

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

القطران {A | c | d | r | t | u | x} [GnSkUWOmpsMBiajJzZhPlRvwo] [ ARG …]

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

su [خيارات] [-] [ مستخدم [ وسيطة ...]]

مرة أخرى ، نرى su bold لأنه اسم الأمر. ثانيًا ، نرى أنه لم يتم تحديد أي إشارات فعلية ، لكنها اختيارية فقط. ثالثًا ، هناك علامة واحدة تم تحديدها ، ولكنها أيضًا اختيارية. أخيرًا ، نرى وسيطة اختيارية قابلة للتكرار داخل وسيطة اختيارية. الآن ، ما كان يبدو غامضًا للغاية هو أكثر منطقية.

whois [{-h | –host} HOST ] [{-p | –port} PORT ] [-abBcdGHKlLmMrRx] [-g SOURCE: FIRST-LAST ] [-i ATTR [، ATTR ] ...] [-s SOURCE [، SOURCE ] ...] [-T TYPE [، TYPE ] ...] [– overbose] كائن

هذا هو كثيف بشكل خاص. انسخه إلى محرر النصوص المفضل لديك وأضف بعض المساحات الإضافية هناك إذا كان يساعدك على قراءته. بعد المسح فوق هذا ، يجب أن تبدأ في رؤية بعض الأنماط. يستخدم الجزءان المضيف والمنفذ نفس التنسيق للشكل القصير والطويل للخيار متبوعًا بالوسيطة لهذا الخيار ، بينما يكون كلاهما اختياريًا. ثم نرى سلسلة الأعلام الاختيارية. الجزء التالي حول المصادر من الأول إلى الأخير هو بناء الجملة الذي يتوقعه whois والذي سيتم شرحه لاحقًا في صفحة الدليل. الآن نرى هذا الثلاثي من الأعلام الاختيارية التي تأخذ إما وسيطة واحدة أو متكررة اختيارية ، وهذا هو نوع المركب من الاصطلاحات التي قد يكون من الصعب للغاية فهمها بالكامل في البداية. أخيرًا ، هناك خيار مطول وكائن (المضيف / المجال).

وهذه هي الطريقة التي تقرأ بها ملخص صفحة الرجل. هناك بعض الاصطلاحات الأخرى ، لكنها شديدة الغموض بحيث لا يمكن تغطيتها في هذه المقالة.

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

والخيارات
تذكر كل تلك الأعلام والحجج المختلفة التي قد تكون اختيارية أو إلزامية؟ هذا هو المكان الذي يتم شرحهم فيه جميعًا. عادة ما توجد معلومات جيدة هنا وغالبًا ما ستجد اصطلاح <الوسيطة> ، مما يشير إلى أن العلم المعين يتطلب وسيطة مقابلة. ستجد في بعض الأحيان أن الخيارات ستكون في جزء الوصف لأنه لا توجد قاعدة ثابتة تحدد صفحات الدليل ، فقط الاصطلاحات ، والإرادة للامتثال للمعايير.

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

بالإضافة إلى ذلك ، ستجد بانتظام أقسامًا للمؤلف ، ومعلومات حقوق النشر ، وتقارير الأخطاء ، وانظر أيضًا (apropos).

علاوة على ذلك ، هناك الأقسام المحددة رسميًا لصفحات الدليل كما هو موضح أدناه.

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

الأوامر ليست هي الأشياء الوحيدة التي تحتوي على أدلة كما ترى من الأقسام المتاحة. من المحتمل أن يكون لمكالمات الأنظمة وملفات التكوين والأجهزة الخاصة صفحة دليل مقابلة. كمية المعلومات حول تثبيت Linux النموذجي فقط في صفحات man أمر مذهل ، وينطبق الشيء نفسه على أنظمة التشغيل الأخرى الشبيهة بـ UNIX مفتوحة المصدر.

إذا وجدت أن صفحة الدليل لا تكفي وما زلت لا تفهم أمرًا ما ، فتحقق دائمًا عبر الإنترنت لأن العديد من الأشخاص يقدمون تفسيرات أكثر شمولاً لأدوات معينة ، ولكن أيضًا العديد من التوزيعات لها صفحاتها الخاصة لحزم البرامج المختلفة. بمجرد أن تجد أنك مرتاح مع جزء من البرنامج ، ولكنك لا تزال تشعر بأن الدليل غير موجود ، يمكنك دائمًا المساهمة عن طريق كتابة البرنامج الخاص بك وتقديمه إلى المشروع المعني. غالبًا ما يكون التوثيق هو الجزء الأكثر إهمالًا في مشاريع البرامج ، لذلك حتى إذا لم تتمكن من كتابة التعليمات البرمجية ، يمكنك كتابة الكتيبات ومقالات Wiki والبرامج التعليمية لمساعدة الآخرين.

الآن بعد أن عرفت تشريح صفحة الرجل ، ليس لديك أي عذر سوى RTFM (وهذا هو قراءة الدليل المجاني لمن تقل أعمارهم عن 18 عامًا) ؛)

اقرأ أيضًا: معجم Linux: استخدم أمر المشاهدة لتشغيل أمر كل X ثانية