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

时间:2010-07-03 16:12:00

标签: perl cpan pod

我想为perlopperlopref写一个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

1 个答案:

答案 0 :(得分:4)

我不这么认为,但我确实建议你可以开始几个地方。第一个是Pod::Inherit,它是DBIx :: Class用来生成POD的工具,包括来自超类的继承方法的文档。第二个是Pod::Weaver,这是一个由Dist :: Zilla使用的通用PO​​D munger,它有自己的基于规则的配置,并且很可能在没有大量工作的情况下做你需要的 - 但它是一个现在对文档的了解很少。