2010-07-03 3 views
4

Je veux écrire un fichier Pod pour perlop et perlopref. Mon instinct est de dire quelque chose commeY a-t-il un module Perl qui peut diviser un fichier Pod principal en plusieurs vues?

=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 

et l'ont produire (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">. 

et (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 
+0

Mes sens spidey me disent que nous allons avoir une augmentation des questions sur les pods ici pour un petit moment. :) – Ether

+0

C'est très probable. –

Répondre

4

Je ne pense pas, mais je J'ai une suggestion pour quelques endroits où vous pourriez commencer. Le premier est Pod::Inherit, qui est un outil que DBIx :: Class utilise pour produire POD qui inclut la documentation des méthodes héritées des superclasses. La seconde est Pod::Weaver qui est une munition POD polyvalente utilisée par Dist :: Zilla qui a sa propre configuration de configuration basée sur des règles, et pourrait probablement faire ce dont vous avez besoin sans beaucoup de travail - mais c'est un peu léger sur la documentation maintenant.

Questions connexes