xsawyerx / module-starter

Module::Starter, a tool to help create solid Perl modules from scratch

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Put titles and links to support on one line of POD

LadyAleena opened this issue · comments

You could put the titles and urls together to create links to more information on the module.

Note: I change Search CPAN to meta::cpan (line 331) since CPAN is not where the links lead.

=over

=item * L<Foo::Bar on RT, CPAN's request tracker|https://rt.cpan.org/NoAuth/Bugs.html?Dist=Foo-Bar>

=item * L<Foo::Bar on CPAN Ratings|https://cpanratings.perl.org/d/Foo-Bar>

=item * L<Foo::Bar on meta::cpan|https://metacpan.org/release/Foo-Bar>

=back

(You can copy and paste the above into the POD renderer to see how meta::cpan parses the lines.)

I think line 1429 would be...

\=item * L<$module on $title|$link>

Lines 1430 and 1431 could be removed.

This is how it would look with perldoc on my computer:

    *   Foo::Bar on RT, CPAN's request tracker
        <https://rt.cpan.org/NoAuth/Bugs.html?Dist=Foo-Bar>

    *   Foo::Bar on CPAN Ratings
        <https://cpanratings.perl.org/d/Foo-Bar>

    *   Foo::Bar on meta::cpan
        <https://metacpan.org/release/Foo-Bar>

This is the html output (though the links are created with markdown here):

Note: I change Search CPAN to meta::cpan (line 331) since CPAN is not where the links lead.

Actually it is, metacpan is just a search engine for CPAN, and the obsolete CPAN search website was just a different one.

Thanks for the suggestion.