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


Come for the quick hacks, stay for the epiphanies.
	PerlMonks

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

by jplindstrom (Monsignor)

on Dec 18, 2008 at 14:22 UTC ( [id://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
[download]

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

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
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	[reply]
Re^2: Is "=for html" supported in POD rendered by search.cpan.org? by jplindstrom (Monsignor) on Dec 18, 2008 at 14:48 UTC
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	[reply]
Re^3: Is "=for html" supported in POD rendered by search.cpan.org? by LanX (Saint) on Dec 18, 2008 at 14:59 UTC
Hmm ... given the other examples you can at least insert a http-link to the image. Maybe as a fall back solution ... Cheers Rolf	[reply]
Re: Is "=for html" supported in POD rendered by search.cpan.org? by Anonymous Monk on Dec 18, 2008 at 14:30 UTC
For your searching pleasure "=for html" site:http://search.cpan.org/src/ http://search.cpan.org/src/ACALPINI/Win32-Clipboard-0.51/Clipboard.pm Win32::Clipboard http://search.cpan.org/src/DROLSKY/HTML-Mason-1.40/lib/HTML/Mason/Cache/BaseCache.pm HTML::Mason::Cache::BaseCache Doesn't look like it respects `=for html`	[reply] [d/l]
Re^2: Is "=for html" supported in POD rendered by search.cpan.org? by Anonymous Monk on Dec 18, 2008 at 14:34 UTC
I think it does, see http://search.cpan.org/src/PCIMPRICH/XML-STX-0.43/doc/TrAXref.pod http://search.cpan.org/dist/XML-STX/doc/TrAXref.pod	[reply]
Re^3: Is "=for html" supported in POD rendered by search.cpan.org? by Anonymous Monk on Dec 18, 2008 at 14:38 UTC
But not images http://search.cpan.org/src/STAS/DocSet-0.19/examples/presentation/src/handouts/mod_perl-2.0.pod http://search.cpan.org/~STAS/DocSet-0.19/examples/presentation/src/handouts/mod_perl-2.0.pod	[reply]

Back to Seekers of Perl Wisdom

Log In^?

Domain Nodelet^?

www.com | www.net | www.org

Node Status^?

node history
Node Type: perlquestion [id://731256]
Approved by toolic
help

Chatterbox^?

How do I use this? • Last hour • Other CB clients

Other Users^?

Others pondering the Monastery: (5)

As of 2024-04-18 13:02 GMT

Sections^?

Information^?

Find Nodes^?

Leftovers^?

Today I Learned

Voting Booth^?

No recent polls found