توثيقالمرحلة الأولى: وثيقة الحد الأدنى
أول شيء نحتاج إلى معرفته هو تنسيق مستند HTML جيد التنسيق. تبدو هكذا:
عنوان الصفحة
نص الصفحة.
عنوان الصفحة
نص الصفحة.
إذا أدخلنا هذا في محرر النصوص الخاص بنا وقمنا بحفظ الملف باسم foo.html، يمكننا استخدام عنوان URL التالي في Firefox لعرض الملف:
ملف: /// home /اسم المستخدم/foo.html
ستكون المرحلة الأولى من برنامجنا قادرة على إخراج ملف HTML هذا إلى الإخراج القياسي. يمكننا كتابة برنامج للقيام بذلك بسهولة تامة. لنبدأ محرر النصوص الخاص بنا وننشئ ملفًا جديدًا باسم ~ / bin / sys_info_page:
[me @ linuxbox ~] $ vim ~ / bin / sys_info_page
[me @ linuxbox ~] $ vim ~ / bin / sys_info_page
وادخل البرنامج التالي:
#! / بن / باش
# برنامج لإخراج صفحة معلومات النظام صدى " "
صدى صوت " "
صدى صوت " عنوان الصفحة " صدى صوت " "
صدى صوت " "
صدى "نص الصفحة". صدى صوت " "
صدى صوت " "
#! / بن / باش
# برنامج لإخراج صفحة معلومات النظام صدى " "
صدى صوت " "
صدى صوت " عنوان الصفحة " صدى صوت " "
صدى صوت " "
صدى "نص الصفحة". صدى صوت " "
صدى صوت " "
تحتوي محاولتنا الأولى لحل هذه المشكلة على كلمة shebang وتعليق (فكرة جيدة دائمًا) وتسلسل صدى أوامر ، واحدة لكل سطر من الإخراج. بعد حفظ الملف ، سنجعله قابلاً للتنفيذ ونحاول تشغيله:
[me @ linuxbox ~] $ chmod 755 ~ / bin / sys_info_page
[me @ linuxbox ~] $ sys_info_page
[me @ linuxbox ~] $ chmod 755 ~ / bin / sys_info_page
[me @ linuxbox ~] $ sys_info_page
عند تشغيل البرنامج ، يجب أن نرى نص مستند HTML معروضًا على الشاشة ، نظرًا لأن ملف صدى ترسل الأوامر الموجودة في البرنامج النصي إخراجها إلى الإخراج القياسي. سنقوم بتشغيل البرنامج مرة أخرى وإعادة توجيه إخراج البرنامج إلى الملف sys_info_page.html، حتى نتمكن من عرض النتيجة باستخدام متصفح الويب:
[me @ linuxbox ~] $ sys_info_page> sys_info_page.html
[me @ linuxbox ~] $ Firefox sys_info_page.html
[me @ linuxbox ~] $ sys_info_page> sys_info_page.html
[me @ linuxbox ~] $ Firefox sys_info_page.html
حتى الان جيدة جدا.
عند كتابة البرامج ، من الجيد دائمًا السعي لتحقيق البساطة والوضوح. تكون الصيانة أسهل عندما يكون البرنامج سهل القراءة والفهم ، ناهيك عن أنه يمكن أن يجعل البرنامج أسهل في الكتابة عن طريق تقليل كمية الكتابة. النسخة الحالية من البرنامج تعمل بشكل جيد ، لكنها قد تكون أبسط. يمكننا في الواقع دمج جميع أوامر الصدى في واحد ، مما سيجعل بالتأكيد من السهل إضافة المزيد من السطور إلى مخرجات البرنامج. لذلك ، دعنا نغير برنامجنا إلى هذا:
المرحلة الأولى: وثيقة الحد الأدنى
#! / بن / باش
# برنامج لإخراج صفحة معلومات النظام
صدى صوت "
عنوان الصفحة
نص الصفحة.
"
#! / بن / باش
# برنامج لإخراج صفحة معلومات النظام
صدى صوت "
عنوان الصفحة
نص الصفحة.
"
قد تتضمن السلسلة المقتبسة أسطرًا جديدة ، وبالتالي تحتوي على عدة أسطر من النص. سيستمر الغلاف في قراءة النص حتى يصادف علامة اقتباس الإغلاق. يعمل بهذه الطريقة في سطر الأوامر أيضًا:
[me @ linuxbox ~] $ صدى صوت "
[me @ linuxbox ~] $ صدى صوت "
>
>
>
>
>
>
عنوان الصفحة
>
>
>
>
>
>
> "
> "
نص الصفحة.
نص الصفحة.
الحرف البادئة ">" هو موجه shell المضمن في PS2 متغير شل. يظهر عندما نكتب تعليمة متعددة الأسطر في الغلاف. هذه الميزة محجوبة قليلاً في الوقت الحالي ، ولكن لاحقًا ، عندما نغطي عبارات البرمجة متعددة الأسطر ، فسوف يتضح أنها مفيدة جدًا.