jplindstrom has asked for the wisdom of the Perl Monks concerning the following question:
I thought I'd put a screen shot in the POD docs for one of my modules. So I added png images to the distro and some POD to display them, similar to:
=for html <img src="../../doc/images/find_with_ack.png" style="mar +gin-bottom:4px;"/> ... =begin html <img src="../../doc/images/run_tests_1.png" style="margin-bottom:4 +px;" /> =end html
Rendering the POD locally with pod2html will include the HTML in the page. But nothing turned up in the docs on search.cpan.org.
I can't actually recall having seen inline images in any other module documentation, only already rendered HTML pages being shipped separately (these are listed under "Other files" in the distro overview).
I can imagine =for html is disabled for security reasons or something, even if that may seem a bit silly since you can easily just add a whole web page...
I'm just speculating and guessing here, does anyone know what the deal is? Is there a format other than "html" that would work?
/J
|
---|
Replies are listed 'Best First'. | |
---|---|
Re: Is "=for html" supported in POD rendered by search.cpan.org?
by LanX (Saint) on Dec 18, 2008 at 14:33 UTC | |
by jplindstrom (Monsignor) on Dec 18, 2008 at 14:48 UTC | |
by LanX (Saint) on Dec 18, 2008 at 14:59 UTC | |
Re: Is "=for html" supported in POD rendered by search.cpan.org?
by Anonymous Monk on Dec 18, 2008 at 14:30 UTC | |
by Anonymous Monk on Dec 18, 2008 at 14:34 UTC | |
by Anonymous Monk on Dec 18, 2008 at 14:38 UTC |