以一個空行開始您的文件,在開頭使用一個 = head1命令,並以一個 = cut結束它。 Perl 將忽略您在程式碼中輸入的 Pod 文本。
以下是在 Perl 程式碼中使用嵌入式文件的簡單示例:
1 2 3 4 5 6 7 8 9
#!/usr/bin/perl
print"Hello, World\n";
=head1 Hello, World 範例 這是一個 Perl 的簡單範例。 =cut
print"Hello, MoroseDog\n";
執行以上程序,輸出結果如下:
1 2
Hello, World Hello, MoroseDog
如果您要將 Pod 放在文件末尾,並且使用 __END__ 或 __DATA__ 剪切標記,請確保在第一個 Pod 命令之前放置一個空行,如下所示,不會將 = head1識別為開始一個 Pod 塊。
1 2 3 4 5 6 7 8 9 10 11 12 13
#!/usr/bin/perl
print"Hello, World\n";
while(<DATA>){ print $_; }
__END__
=head1 Hello, World 範例 這是一個 Perl 的簡單範例。 print "Hello, MoroseDog\n";
執行以上程序,輸出結果如下:
1 2 3 4 5
Hello, World
=head1 Hello, World 範例 這是一個 Perl 的簡單範例。 print "Hello, MoroseDog\n";%
再舉一個例子:
1 2 3 4 5 6 7 8 9
#!/usr/bin/perl
print"Hello, World\n";
__END__
=head1 Hello, World 範例 這是一個 Perl 的簡單範例。 print "Hello, MoroseDog\n";
執行以上程序,輸出結果如下:
1
Hello, World
什麼是 POD?
Pod(Plain Old Documentation),是一種簡單而易用的標記型語言(置標語言),它經常用於在perl程序和模塊中的文件書寫。 Pod 的 轉化器可以將 Pod 轉換成很多種格式,例如 text、html、man 等很多。 Pod 標記語言包含三種基本基本類型: 普通、原文 和 命令。