وثائق بيرل POD

بيرل يمكن أن تكون جزءا لا يتجزأ POD (عادي قديم التوثيق) في وثائق وحدة أو النصي.

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

وثائق POD باستخدام القواعد:

تبدأ وثائق POD مع= head1، = خفضالنهاية، وقبل= head1= قطعت بعد إضافة سطر فارغ.

يتجاهل بيرل وثائق POD. ومن الأمثلة على ذلك ما يلي:

#!/usr/bin/perl

print "Hello, World\n";

=head1 Hello, World 实例
这是一个 Perl 的简单实例。
=cut

print "Hello, w3big\n";

البرنامج المذكور أعلاه، والناتج هو:

Hello, World
Hello, w3big

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

#!/usr/bin/perl

print "Hello, World\n";

while(<DATA>){
  print $_;
}

__END__

=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, w3big\n";

البرنامج المذكور أعلاه، والناتج هو:

Hello, World

=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, w3big\n";

لا تتم قراءة الأمثلة التالية الوثائق POD:

#!/usr/bin/perl

print "Hello, World\n";

__END__

=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, w3big\n";

البرنامج المذكور أعلاه، والناتج هو:

Hello, World

ما هو POD؟

جراب (عادي قديم التوثيق)، هو بسيط وسهل الاستخدام مستندة إلى علامات اللغة (لغة الترميز)، وغالبا ما يتم استخدامه في البرامج وحدات بيرل مكتوب في الوثيقة.

تحويل جراب جراب يمكن تحويلها إلى مجموعة متنوعة من الأشكال، مثل النص، أتش تي أم أل، الرجل كثيرا، وهلم جرا.

تتكون جراب العلامات من ثلاثة أنواع أساسية الأساسية: عادي، الأصلي، والأوامر.

• فقرة عادي: يمكنك استخدام رموز التنسيق في الفقرات العادية، مثل جريئة، مائل، أو الترميز النمط والتسطير.

• الفقرة الأصلية: مقاطع النص، لجزء من كتلة التعليمات البرمجية أو غيرها من معالجة تحويل غير مطلوب، ولكن لا تتطلب الفقرة إعادة ترتيب.

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

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

  =pod (开始文档)
  =head1 标题文本
  =head2 标题文本
  =head3 标题文本
  =head4 标题文本
  =over 缩进空格数量
  =item 前缀
  =back (结束列表)
  =begin 文档格式
  =end 结束文档格式
  =for 格式文本
  =encoding 编码类型
  =cut (文档结束)

في بيرل، يمكنك استخدام pod2html **. قرنة> **. الاكواد لتوليد شكل جراب ثيقة أتش تي أم أل.

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.w3big.com </p>

=end html

وهذا الرمز يكون النسخة الأصلية عند pod2html.

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

$ pod2html test.pod > test.html 

فتح test.html المتصفح، قسم للمؤشر يربط، هو مبين أدناه: