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

[feature] Add =image to perl pod #18169

Thread Previous | Thread Next
Dmitry Karasik
October 4, 2020 15:11
[feature] Add =image to perl pod #18169
Message ID:

Thank you all for review, it is clear that some things I wasn't focused at
don't fall in as gracefully as I wanted. So it seems that P<> neither serves
any good as an inline image anchor, nor versatile enough to specity
accompanying text, and will require further additions to pod that would break
backward compatibility. 

Having all of that in mind, I reworked the proposal, and here it's next iteration:

1) Full syntax (somewhat YAML-inspired)

=begin image

src: file.png
title: Figure.1
	This is a multi-line
	comment. Must start end end with newline.
	Prefix spaces are skipped.

resolution: 120
whatever: value

	This is fallback text
	shown where graphics is unavailable
	but the formatter is smart and knows
	the =image tag.

=end image

2) Short syntax that should cover 90% of use-cases

=for image src:file.png

I think that covers it all now. What do you think?

	Dmitry Karasik

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About