الصفحة الرئيسية>دروس برمجة الشبكات>البرنامج التعليمي بيرل

وثائق بيرل POD

الكاتب：Eve Cole وقت التحديث：2024-12-24 16:24:01

في لغة Perl، يمكن تضمين مستندات POD (الوثائق القديمة البسيطة) في الوحدات النمطية أو البرامج النصية.

POD هي لغة ترميزية بسيطة وسهلة الاستخدام (لغة ترميزية).

قواعد استخدام مستند POD:

يبدأ مستند POD بـ =head1 وينتهي بـ =cut . أضف سطرًا فارغًا قبل =head1 وبعد =cut .

يتجاهل Perl الوثائق الموجودة في PODs. الأمثلة هي كما يلي:

مثال

#!/usr/bin/Perl مطبعة " مرحبًا بالعالم n " ; =head1 مرحبًا بالعالم هذا مثال بسيط للغة Perl. =cut مطبعة " مرحبًا، Codercto n " ;

بتنفيذ البرنامج أعلاه تكون نتيجة الإخراج هي:

 مرحبًا، WorldHello، Codercto

يمكننا أيضًا استخدام "__END__" أو "__DATA__" "للتعليق" على كل المحتوى بعد السطر:

مثال

#!/usr/bin/Perl مطبعة " أهلا بالعالم n " ; بينما ( < DATA > ) { مطبعة $ _ } __نهاية__ =head1 مرحبًا، مثال عالمي هذا مثال بسيط لـ Perl. طباعة "مرحبا، Codercton";

بتنفيذ البرنامج أعلاه تكون نتيجة الإخراج هي:

 مرحبًا، World=head1 مرحبًا، مثال عالمي هذا مثال بسيط للغة Perl. طباعة "مرحبا، Codercton";

المثال التالي لا يقرأ مستند POD:

مثال

#!/usr/bin/Perl مطبعة " أهلاً بالعالم n " ; =head1 مرحبًا، مثال عالمي هذا مثال بسيط لـ Perl. طباعة "مرحبا، Codercton";

بتنفيذ البرنامج أعلاه تكون نتيجة الإخراج هي:

 مرحبا بالعالم

ما هو جراب؟

Pod (الوثائق القديمة البسيطة) هي لغة ترميزية بسيطة وسهلة الاستخدام (لغة ترميزية)، تُستخدم غالبًا لكتابة المستندات في برامج ووحدات Perl.

يمكن لمحول Pod تحويل Pod إلى العديد من التنسيقات، مثل text وhtml وman وما إلى ذلك.

تحتوي لغة ترميز Pod على ثلاثة أنواع أساسية أساسية: عادية ونصية وأوامر.

الفقرات العادية : يمكنك استخدام أكواد التنسيق في الفقرات العادية، مثل الخط الغامق أو المائل أو نمط التعليمات البرمجية أو التسطير وما إلى ذلك.

الفقرة الأصلية : الفقرة الأصلية، تستخدم لكتل ​​التعليمات البرمجية أو الأجزاء الأخرى التي لا تتطلب معالجة المحول، ولا تتطلب إعادة ترتيب الفقرة.

فقرة الأمر : تعمل فقرات الأمر على المستند بأكمله وتستخدم عادةً لإعداد العنوان أو ترميز القائمة.

تبدأ جميع فقرات الأوامر (التي تتكون من سطر واحد فقط) بـ "="، متبوعة بمعرف. سوف يتأثر النص التالي بهذا الأمر. الآن تشمل الأوامر المستخدمة على نطاق واسع

 =جراب (مستند البداية)=نص عنوان الرأس1=نص عنوان الرأس2=نص عنوان الرأس3=نص عنوان الرأس4=أكثر من عدد المسافات البادئة=بادئة العنصر=الخلف (قائمة النهاية)=تنسيق مستند البداية=تنسيق نهاية المستند=لتنسيق النص =نوع ترميز التشفير=قص (نهاية المستند)

في لغة Perl، يمكنك استخدام pod2html **.pod >**.html لإنشاء مستندات pod بتنسيق html.

خذ بعين الاعتبار مثيل POD التالي:

مثال

=begin html=encoding utf-8 =head1 البرنامج التعليمي للمبرمج =cut

عند استخدام pod2html، سيتم نسخ هذا الرمز من النص الأصلي.

استخدم الأمر pod2html لتنفيذه وتحويله إلى كود HTML:

 $ pod2html test.pod > test.html

افتح test.html في المتصفح، جزء الرابط هو الفهرس، كما هو موضح أدناه:

المثال التالي يكتب HTML مباشرة في مستند POD:

 =begin html=encoding utf-8<h1>البرنامج التعليمي للمبرمج</h1><p> www.codercto.com </p>=end html

عند استخدام pod2html، سيتم نسخ هذا الرمز من النص الأصلي.

استخدم الأمر pod2html لتنفيذه وتحويله إلى كود HTML:

 $ pod2html test.pod > test.html

افتح test.html في المتصفح، جزء الرابط هو الفهرس، كما هو موضح أدناه:

مقالات ذات صلة