Beefy Boxes and Bandwidth Generously Provided by pair Networks
Pathologically Eclectic Rubbish Lister

Is "=for html" supported in POD rendered by

by jplindstrom (Monsignor)
on Dec 18, 2008 at 14:22 UTC ( #731256=perlquestion: print w/replies, xml ) Need Help??
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

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?


Replies are listed 'Best First'.
Re: Is "=for html" supported in POD rendered by
by LanX (Bishop) on Dec 18, 2008 at 14:33 UTC
    I can't answer your question, but maybe it's a (relative) linking problem. Did you also try base64 encoding?

    ->Inline images in POD

    Cheers Rolf

      No, the whole html chunk is missing, so given the other answers I've seen here I suspect the POD renderer filters out elements with <img> in them.

      Or it's the divs I put in there to lay it out, or the relative ../.. url, or the style attribute, or something else.


        Hmm ... given the other examples you can at least insert a http-link to the image. Maybe as a fall back solution ...

        Cheers Rolf

Re: Is "=for html" supported in POD rendered by
by Anonymous Monk on Dec 18, 2008 at 14:30 UTC

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://731256]
Approved by toolic
[Corion]: I hope you had a good weekend!
[Discipulus]: good morning again monks!
[choroba]: Good morning!
[Corion]: I have a rough plan to release an ImageNet classifier in Perl (well, using pretrained data, but still a nice toy)
Discipulus is going mad with the new win10 client.. tried mv Cortana /dev/null but no succes
[Corion]: Ouch - another pretrained set is available, using images from IMDB and Wikipedia. So I expect interesting results for non-PR images where people are pictured that are not made up
[Corion]: Discipulus: Yeah, from my investigations, you can somewhat silence+disable Cortana, but some services of it remain always running unfortunately. What a waste of resources :-/
[Corion]: I hope you had a good weekend still ;)

How do I use this? | Other CB clients
Other Users?
Others contemplating the Monastery: (6)
As of 2017-09-25 08:31 GMT
Find Nodes?
    Voting Booth?
    During the recent solar eclipse, I:

    Results (277 votes). Check out past polls.