เอกสาร Perl POD

Perl สามารถฝังตัว POD (เอกสาร Plain Old) ในเอกสารประกอบโมดูลหรือสคริปต์

POD คือการที่ง่ายและง่ายต่อการใช้ภาษาตามแท็ก (ภาษามาร์กอัป)

เอกสาร POD ใช้กฎ:

เอกสาร POD เริ่มต้นด้วย= head1 =ปลายตัดและก่อน==head1ตัดหลังจากเพิ่มบรรทัดว่าง

Perl ละเว้นเอกสาร 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 (Plain Old เอกสาร) เป็นที่เรียบง่ายและการใช้ภาษาตามแท็ก (ภาษามาร์กอัป) ง่ายก็มักจะใช้ในโปรแกรม Perl และโมดูลที่เขียนในเอกสาร

Pod Pod แปลงสามารถแปลงเป็นรูปแบบที่หลากหลายเช่นข้อความ, HTML คนจำนวนมากและอื่น ๆ

Pod มาร์กอัปประกอบด้วยสามประเภทพื้นฐานพื้นฐานปกติเดิมและคำสั่ง

• ย่อหน้าปกติ: คุณสามารถใช้รหัสการจัดรูปแบบในวรรคสามัญเช่นตัวหนาตัวเอียงหรือรูปแบบการเข้ารหัสขีดเส้นใต้

• วรรคเดิม: ทางเดินข้อความเป็นส่วนหนึ่งของการป้องกันรหัสแปลงหรือการประมวลผลอื่น ๆ ไม่จำเป็นต้อง แต่ไม่จำเป็นต้องปรับปรุงใหม่วรรค

• คำสั่งย่อหน้า: บทบาทวรรคคำสั่งในเอกสารทั้งหมดหรือรายการทั่วไปที่ใช้ในการตั้งค่าแท็กชื่อ

  ทุกคำสั่งย่อหน้า (ความยาวเส้นเดียวของเขา) โดยใช้ "=" แล้วเป็นตัวระบุ ข้อความที่ตามมาจะได้รับผลกระทบตามคำสั่งนี้ คำสั่งคือตอนนี้ใช้กันอย่างแพร่หลาย ได้แก่

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

ใน Perl คุณสามารถใช้ pod2html **. Pod> **. Html ในการสร้างรูปแบบ 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.w3big.com </p>

=end html

รหัสนี้จะเป็นสำเนาต้นฉบับเมื่อ pod2html

ใช้ pod2html รันคำสั่งเพื่อแปลงเป็นโค้ด HTML:

$ pod2html test.pod > test.html 

เปิดเบราว์เซอร์ test.html การเชื่อมโยงส่วนสำหรับดัชนีที่แสดงด้านล่าง: