in reply to POD: embedding/linking/displaying html and images on metacpan and github

I found this older discussion POD L<> and relative links? saying that L<> has no support for internal relative path. :/

Question: can I preview the rendering on metacpan prior to publishing?

update

Another nice resource is Perl::Examples::POD::Link

Cheers Rolf
(addicted to the Perl Programming Language :)
Wikisyntax for the Monastery FootballPerl is like chess, only without the dice

  • Comment on Re: POD: embedding/linking/displaying html and images on metacpan and github

Replies are listed 'Best First'.
Re^2: POD: embedding/linking/displaying html and images on metacpan and github
by hippo (Archbishop) on Mar 18, 2019 at 13:53 UTC

    You can paste or upload the POD into the POD Renderer to see how MetaCPAN will handle it.

      That's pretty damned cool, I honestly had no idea that existed!

      How many times did my POD look perfectly fine locally, just to find that after a release to the CPAN (after a rigorous pre-release cycle) that I had to touch up POD issues.

      Regarding the *testing* of links in POD (a bit off topic), in at least one of my distributions that uses links between several docs within the distribution (with some external to eg github pages), I took to using Test::Pod::LinkCheck (as an author/release-only test file). Works well, and advises loudly when I've messed up a POD link (which happens often). It will also find links that used to work, but no longer do.

      great thanks! :)

      Cheers Rolf
      (addicted to the Perl Programming Language :)
      Wikisyntax for the Monastery FootballPerl is like chess, only without the dice