develooper Front page | perl.pod-people | Postings from October 2020

[feature] Add =image to perl pod #18169

Thread Next
From:
Dmitry Karasik
Date:
October 1, 2020 09:45
Subject:
[feature] Add =image to perl pod #18169
Message ID:
20201001093545.GA61417@nataraj.eu.org
Hello,

I've proposed addition of images to pod, as discussed at [1], and would like to
ask for some more discussion here as well The idea is rather simple, to
introduce a P<> tag in two forms, P<foo.png> and P<title|foo.png>, that would
get converted to image in graphic formats, and ignored otherwise.

The image URI would be related either to the pod file location (without leading
/) or to the distro root (with leading /), that would allow referencing both
locally installed images as well as web views on github and metacpan.

Image title would get converted into <figcaption> in html, if present.

In case a graceful fallback is needed by an author, the following trick could be
used:

P<graph.png>

=begin text

^ y  **
|  ** 
|**
|----------> x

I'm thinking about working on a patch however I don't want to find myself in a
situation where it would be rejected or premature because the very topic is
undecided yet. 

Let's discuss this.

[1] https://github.com/Perl/perl5/issues/18169


-- 
Sincerely,
	Dmitry Karasik

Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About