28-Perl POD 文档
1.Perl POD 文档
Perl 中可以在模块或脚本中嵌入 POD(Plain Old Documentation) 文档。
POD 是一种简单而易用的标记型语言(置标语言)。
POD 文档使用规则:
POD 文档以 =head1 开始, =cut 结束, =head1 前与 =cut 后添加一空行。
Perl 会忽略 POD 中的文档。实例如下:
#!/usr/bin/perl
print "Hello, World\n";
=head1 Hello, World 实例
这是一个 Perl 的简单实例。
=cut
print "Hello, abc\n";
我们还可以使用 "__END__" 或 "__DATA__" 将所在行之后的内容全部"注释"掉:
#!/usr/bin/perl
print "Hello, World\n";
while(<DATA>){
print $_;
}
__END__
=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, abc\n";
以下实例不读取 POD 文档:
#!/usr/bin/perl
print "Hello, World\n";
__END__
=head1 Hello, World 实例
这是一个 Perl 的简单实例。
print "Hello, abc\n";
2.什么是 POD?
Pod(Plain Old Documentation), 是一种简单而易用的标记型语言(置标语言),它经常用于在perl程序和模块中的文档书写。
Pod 的 转化器可以将 Pod 转换成很多种格式,例如 text, html, man 等很多。
Pod 标记语言包含三种基本基本类型: 普通, 原文, 和 命令。
普通段落: 你可以在普通段落中使用格式化代码,如黑体,斜体,或代码风格,下划线等。
原文段落: 原文段落,用于代码块或者其他不需要转换器处理的部分,而且不需要段落重排。
命令段落: 命令段落作用于整个的文档,通常用于标题设置或列表标记。
所有的命令段落(他只有一行的长度)使用 "=" 开始,然后是一个标识符。 随后的文本将被这条命令所影响。
现在被广泛使用的命令包括:
=pod (开始文档)
=head1 标题文本
=head2 标题文本
=head3 标题文本
=head4 标题文本
=over 缩进空格数量
=item 前缀
=back (结束列表)
=begin 文档格式
=end 结束文档格式
=for 格式文本
=encoding 编码类型
=cut (文档结束)
在perl中,可以使用 pod2html **.pod >**.html 来生成html格式的pod文档。
考虑以下 POD 实例:
=begin html
=encoding utf-8
=head1 123
=cut
pod2html时会原文拷贝此段代码。
使用 pod2html 命令执行,将其转换为 HTML 代码:
$ pod2html test.pod > test.html
以下实例在 POD 文档中直接写入 HTML:
=begin html
=encoding utf-8
<h1>123</h1>
<p> www.abc.com </p>
=end html
pod2html时会原文拷贝此段代码。
使用 pod2html 命令执行,将其转换为 HTML 代码:
$ pod2html test.pod > test.html
在浏览器中打开 test.html,链接部分为索引,显示如下:
最新文章
- .NET Core &; ASP.NET Core 1.0在Redhat峰会上正式发布
- Python3的decode()与encode()
- JS函数输出圆的半径和面积
- flask_日期和时间
- SolrCloud 5.x 集群部署方法
- web页面隐藏鼠标
- 最近使用ajaxFileUpload和Jcrop来实现图片上传和截图,出现一个图片无法更换的问题
- Sum Root to Leaf Numbers [LeetCode]
- devexpress 中Grid 的使用:为零不显示
- ios手势复习值之换图片-转场动画(纯代码)
- set_time_limit() 控制页面运行时间
- iOS在UITableViewController里使用UISearchDisplayController报错";[UISearchResultsTableView dequeueReusableCellWithIdentifier:forIndexPath:]";
- 帝国cms7.0调用出栏目下的东西
- 1、API
- js循环给li绑定事件实现 点击li弹出其索引值 和内容
- Vue一个案例引发「动画」的使用总结
- sql数据库光标变成黑快怎么回事?
- laravel 接口跨域
- 安装hyperledger fabric V1.0.0-beta
- 网页瀑布流布局插件Masonry