POD 格式

October 27, 2013 @ 08:48 PM

内联文档及格式

POD 允许你在 Perl 代码中使用标记来创建文档。如果你见过 Javadoc 或 PHPdoc，它跟它们很相像。

POD 是语言的一部分，并非额外的规范。

使用 =head1 和 =head2 创建标题

=head1 MOST IMPORTANT
Blah blah
=head2 Subheading
blah blah
=head2 Subhading
blah blah

创建无序列表

要创建这样的列表：

• Wango
• Tango
• Fandango

使用：

=over
=item * Wango
=item * Tango
=item * Fandango
=back

创建有序列表

要创建下面的列表：

• Visit perl101.org
• ???
• Profit!
  使用：

=over
=item 1 Visit perl101.org
=item 2 ???
=item 3 Profit!
=back

使用内联标记样式

POD 用 B<>、I<> 及 C<> 分别表示粗体、斜体、代码。

B<This is bolded>
I<This is italics>
C<This is code>

标记格式能够嵌套。

使用 L<> 超链接

L<> 既可以链接文档中的关键字，如 L<Methods>；也可以链接 URL，如L<http://search.cpan.org。

段落模式 vs. 字面块

段落会自动换行，并由至少一个空行分隔。

A literal block is indented at least one space
and does not
get
wrapped.

这来自于：

Everything in a paragraph word-wraps automatically.  A paragraph
is separated by at least one blank line.
    A literal block is indented at least one space
    and does not
    get
    wrapped.

POD 不会使程序运行变慢

它将在编译时被去除。