One could easily writer a POD reader/writer to
render images whose URI is embedded in the POD.
Equally it would be trivial to embed base-64-encoded
images into the flow of the POD. These might be
thought harder to edit, but it only takes a few
lines of Perl to quickly turn any image (PNG, JPEG)
into base64 suitable for POD (cf Tk::wizard::Images,
I think).
On 26/01/2013 15:59, David Mertens wrote:
Well, to begin with, there are no images in that MATLAB intro docs, to
my knowledge. Furthermroe, the ability to display images depends on
the renderer, perldoc and CPAN being only two such renderers. You can
give renderer-specific commands with pod statements such as this:
...
=for html
<img src="some-image.png" alt="Figure 2: Foo!">
=for latex
\begin{figure}
\caption{Figure 2: Foo!}
\centering
\includegraphics[width=0.5\textwidth]{some-image}
\end{figure}
=for text
... ASCII art goes here ...
...
The normal perldoc command will render the ASCII art section, pod2html
will include the html specific stuff, and pod2latex will include the
LaTeX stuff (I think; I'm not sure about the format name that
pod2latex looks for).
David
On Sat, Jan 26, 2013 at 4:40 AM, Kaj Wiik <[email protected]
<mailto:[email protected]>> wrote:
Hi!
On Fri, Jan 25, 2013 at 6:08 PM, David Mertens
<[email protected] <mailto:[email protected]>> wrote:
> Agh, can we deprecate those wiki docs? I hate having multiple
copies of the
I am bit confused (quite normal thogh...). I have understood that POD
format does not allow images?
Wikipedia: 'Pod is designed to be a simple, clean language with just
enough syntax to be useful. It purposefully does not include
mechanisms for fonts, images, colors or tables.'
It would be very difficult to have graphics examples (like in the
P::G::G wiki page) using plain POD...ascii graphics perhaps :-)?
However, the PDL book contains images though...is it a hack or?
Cheers,
Kaj
_______________________________________________
Perldl mailing list
[email protected] <mailto:[email protected]>
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
--
"Debugging is twice as hard as writing the code in the first place.
Therefore, if you write the code as cleverly as possible, you are,
by definition, not smart enough to debug it." -- Brian Kernighan
_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
