dokumentasi Perl POD

Perl dapat tertanam POD (Plain Old Dokumentasi) dalam dokumentasi modul atau script.

POD adalah sederhana dan mudah untuk menggunakan bahasa berbasis tag (markup language).

dokumentasi POD menggunakan aturan:

dokumentasi POD dimulai dengan= head1, = memotongujung, dan sebelum= head1= dipotong setelah menambahkan baris kosong.

Perl mengabaikan dokumentasi POD. Contohnya adalah sebagai berikut:

#!/usr/bin/perl

print "Hello, World\n";

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

print "Hello, w3big\n";

Program di atas, output adalah:

Hello, World
Hello, w3big

Kita juga bisa menggunakan "__END__" atau "__DATA__" setelah isi baris di mana semua "Komentar" out:

#!/usr/bin/perl

print "Hello, World\n";

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

__END__

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

Program di atas, output adalah:

Hello, World

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

Contoh-contoh berikut tidak membaca dokumentasi POD:

#!/usr/bin/perl

print "Hello, World\n";

__END__

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

Program di atas, output adalah:

Hello, World

Apa POD?

Pod (Plain Old Dokumentasi), adalah sederhana dan mudah untuk menggunakan bahasa berbasis tag (markup language), sering digunakan dalam program perl dan modul yang ditulis dalam dokumen.

konversi pod pod dapat diubah menjadi berbagai format, seperti teks, html, pria banyak dan sebagainya.

Pod markup terdiri dari tiga tipe dasar dasar: normal, asli, dan perintah.

• ayat yang normal: Anda dapat menggunakan kode format dalam paragraf biasa, seperti bold, italic, atau gaya coding, garis bawah.

• Asli ayat: ayat-ayat teks, untuk bagian dari blok kode atau pengolahan converter lainnya tidak diperlukan, tetapi tidak memerlukan ayat penataan ulang.

• perintah ayat: peran ayat Command di seluruh dokumen atau daftar umum digunakan untuk mengatur tag judul.

  Semua paragraf perintah (satu-satunya panjang garis) dengan menggunakan "=" dan kemudian adalah identifier. teks berikutnya akan dipengaruhi oleh Orde ini. Perintah kini banyak digunakan meliputi

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

Di perl, Anda dapat menggunakan pod2html **. Pod> **. Html untuk menghasilkan format pod dokumen html.

POD Perhatikan contoh berikut:

=begin html
=encoding utf-8

=head1 本教程

=cut

Kode ini akan menjadi salinan asli ketika pod2html.

Gunakan pod2html menjalankan perintah untuk mengkonversi ke kode HTML:

$ pod2html test.pod > test.html 

Buka test.html peramban, link bagian untuk indeks, ditunjukkan di bawah ini:

Contoh-contoh berikut ditulis langsung dalam HTML dokumentasi POD:

=begin html
=encoding utf-8

<h1>本教程</h1>
<p> www.w3big.com </p>

=end html

Kode ini akan menjadi salinan asli ketika pod2html.

Gunakan pod2html menjalankan perintah untuk mengkonversi ke kode HTML:

$ pod2html test.pod > test.html 

Buka test.html peramban, link bagian untuk indeks, ditunjukkan di bawah ini: