是否有可以将一个主 Pod 文件拆分为多个视图的 Perl 模块？答案

【问题标题】：Is there a Perl module that can split one master Pod file into several views?是否有可以将一个主 Pod 文件拆分为多个视图的 Perl 模块？
【发布时间】：2011-03-11 11:09:16
【问题描述】：

我想为perlop 和perlopref 编写一个Pod 文件。我的直觉是这样说

=head1 PRECEDENCE

blah

=head1 OPERATORS

=head2 "X"

=for short

The double quote circumflex operator surrounds an interpolating string.
See L<perlop/"X">.

=for long

-head3 Description

blah blah blah

-head3 Example

blah blah blah

-head3 See Also    

blah blah blah

=head2 qq(X)

=for short

The generalized double quote circumflex operator surrounds an interpolating
string. See L<perlop/qq(X)>

=for long

-head3 Description

blah blah blah

-head3 Example

blah blah blah

-head3 See Also    

blah blah blah

并让它产生 (perlopref)

=head1 PRECEDENCE

blah

=head1 OPERATORS

=head2 "X"

The double quote circumflex operator surrounds an interpolating string.
See L<perlop/"X">.

=head2 qq(X)

The double quote circumflex operator surrounds an interpolating string.
See L<perlop/"X">.

和（perlop）

=head1 PRECEDENCE

blah

=head1 OPERATORS

=head2 "X"

=head3 Description

blah blah blah

=head3 Example

blah blah blah

=head3 See Also    

blah blah blah

=head2 qq(X)

=head3 Description

blah blah blah

=head3 Example

blah blah blah

=head3 See Also    

blah blah blah

【问题讨论】：

我的感觉告诉我，在接下来的一段时间里，我们将在这里增加 pod 问题。 :)

标签： perl cpan perl-pod

【解决方案1】：

我不这么认为，但我确实有几个可以开始的建议。第一个是Pod::Inherit，它是 DBIx::Class 用来生成 POD 的工具，其中包括从超类继承的方法的文档。第二个是Pod::Weaver，它是 Dist::Zilla 使用的通用 POD munger，它有自己的基于规则的配置风格，并且可能无需大量工作即可完成您需要的工作 - 但它有点轻现在在文档上。

【讨论】：