Perl - 嵌入文档

您可以将Pod(纯文本)文档嵌入到Perl模块和脚本中。以下是在Perl代码中使用嵌入式文档的规则-

以空行开始您的文档，在开始处使用=head1 命令，并以=cut 结尾

Perl将忽略您在代码中输入的Pod文本。以下是在Perl代码中使用嵌入式文档的简单示例-

#!/usr/bin/perl

print "Hello, World\n";

=head1 Hello, World 
This example demonstrate very basic syntax of Perl.
=cut

print "Hello, Universe\n";

执行上述代码后，将产生以下输出-

Hello, World
Hello, Universe

如果要将Pod放在文件的末尾，并且使用的是__END__或__DATA__剪切标签，请确保按以下方式在第一个Pod命令之前放置一个空行，否则请在前面没有空行=head1 ，许多人员不会将=head1 识别为开始Pod块。

#!/usr/bin/perl

print "Hello, World\n";

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

__END__

=head1 Hello, World 
This example demonstrate very basic syntax of Perl.
print "Hello, Universe\n";

执行上述代码后，将产生以下输出-

Hello, World

=head1 Hello, World 
This example demonstrate very basic syntax of Perl.
print "Hello, Universe\n";

让我们再看一个相同代码的示例，而无需阅读DATA部分-

#!/usr/bin/perl

print "Hello, World\n";

__END__

=head1 Hello, World 
This example demonstrate very basic syntax of Perl.
print "Hello, Universe\n";

执行上述代码后，将产生以下输出-

Hello, World

什么是POD?

Pod是一种易于使用的标签语言，用于编写Perl，Perl程序和Perl模块的文档。有多种翻译器可用于将Pod转换为各种格式，如纯文本，HTML，手册页等。 Pod标签包含三种基本类型的段落-

• 普通段落         - 您可以在普通段落中使用格式代码，包括粗体，斜体，代码样式，超链接等。

• 逐字记录段落  - 逐字记录段落通常用于表示不需要任何特殊解析或格式且不应包装的代码块或其他文本。

• 命令段落         - 命令段落用于特殊处理整个文本块，通常作为标题或列表的一部分。所有命令段落均以=开头，后跟一个标识符，然后是该命令可以随意使用的任意文本。当前公认的命令是-

=pod
=head1 Heading Text
=head2 Heading Text
=head3 Heading Text
=head4 Heading Text
=over indentlevel
=item stuff
=back
=begin format
=end format
=for format text...
=encoding type
=cut

POD示例

考虑以下POD-

=head1 SYNOPSIS
Copyright 2005 [TUTORIALSOPOINT].
=cut

您可以使用Linux上可用的 pod2html 实用程序将上述POD转换为HTML，因此它将产生以下输出-

链接：https://www.learnfk.comhttps://www.learnfk.com/perl/perl-embedded-documentation.html

来源：LearnFk无涯教程网

接下来，考虑以下示例-

=head2 An 示例 List

=over 4
=item * This is a bulleted list.
=item * Here's another item.
=back
=begin html
<p>
Here's some embedded HTML.  In this block I can
include images, apply <span style="color: green">
styles</span>, or do anything else I can do with
HTML.  pod parsers that aren't outputting HTML will
completely ignore it.
</p>

=end html

当您使用pod2html将上述POD转换为HTML时，它将产生以下输出-

无涯教程网

An 示例 List
   This is a bulleted list.
   Here's another item.
Here's some embedded HTML. In this block I can include images, apply 
styles, or do anything else I can do with HTML. pod parsers that aren't 
outputting HTML will completely ignore it.