Beefy Boxes and Bandwidth Generously Provided by pair Networks
more useful options
 
PerlMonks  

Is "=for html" supported in POD rendered by search.cpan.org?

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 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

Comment on Is "=for html" supported in POD rendered by search.cpan.org?
Download Code
Re: Is "=for html" supported in POD rendered by search.cpan.org?
by Anonymous Monk on Dec 18, 2008 at 14:30 UTC
Re: Is "=for html" supported in POD rendered by search.cpan.org?
by LanX (Canon) 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.

      /J

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

        Cheers Rolf

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://731256]
Approved by toolic
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others rifling through the Monastery: (14)
As of 2015-07-02 08:45 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    The top three priorities of my open tasks are (in descending order of likelihood to be worked on) ...









    Results (31 votes), past polls