Существует ли модуль Perl, который может разбить один главный файл Pod на несколько представлений? - PullRequest
4 голосов
/ 03 июля 2010

Я хочу написать один файл Pod для perlop и perlopref.Мой инстинктивный инстинкт - сказать что-то вроде

=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 Ответ

4 голосов
/ 04 июля 2010

Я так не думаю, но у меня есть предложение на пару мест, которые вы могли бы начать.Первый - Pod :: Inherit , который представляет собой инструмент, который DBIx :: Class использует для создания POD, который включает в себя документацию унаследованных методов от суперклассов.Вторым является Pod :: Weaver , который представляет собой универсальный POD-мунгер, используемый Dist :: Zilla, который имеет свой собственный вид конфигурации на основе правил и, вероятно, может делать то, что вам нужно, без большой работы.- но сейчас немного документации по документации.

...