develooper Front page | perl.perl5.porters | Postings from November 2021

Re: reStructuredText WAS Re: Pre-RFC: markdown in pod

Thread Previous | Thread Next
From:
Oodler 577 via perl5-porters
Date:
November 15, 2021 23:20
Subject:
Re: reStructuredText WAS Re: Pre-RFC: markdown in pod
Message ID:
YZLq2oqy0f+5RB0R@odin.sdf-eu.org
Just throwing this out there,

https://stackoverflow.com/questions/7612374/how-to-convert-asciidoc-to-perl-pod

After my email the other day about hating "=head1 ALLCAPS", I
relaized that POD also has value as a pure text format.

I raise this because any "table" should also look like a table in
plain text. This gives means we can't *just* use something that's
already out there and nobody seems to be suggesting HTML. Docbook
(SGML, technically) does tables this way,

https://tdg.docbook.org/tdg/4.5/table.html

Latex does it this way,

https://en.wikibooks.org/wiki/LaTeX/Tables

Finally, it is important to note when we fully consider that
traditionally, POD has been concerned with flow in one direction.
Here we must think about it both. And this leads me to suggest that
if we're going to inline *anything* foreign, it might be wise to
consider *adapting* something we already have, see [1].

Brett

1. `perldoc perlform`

* Felipe Gasper <felipe@felipegasper.com> [2021-11-15 17:31:37 -0500]:

> 
> > On Nov 15, 2021, at 14:58, Nicholas Clark <nick@ccl4.org> wrote:
> > 
> > And I guess there's also the elephant in the room - even CommonMark is no
> > good as-is, because *all* markdown permits you to inline HTML, which makes
> > sense for it. We need to specify "Markdown, but without inline HTML", else
> > how do we target perldoc?
> 
> Another way to say this is: Markdown *targets* HTML, more or less by design. It doesn?t really intend to render to plain text?at least, a while back when I looked for a Markdown-to-text renderer I came up empty.
> 
> A bit earlier in this thread I mentioned reStructuredText. From what I can see, this format is basically ?like Markdown but renders to text?. What if Perl went this route instead?
> 
> -FG

-- 
--
oodler@cpan.org
oodler577@sdf-eu.org
SDF-EU Public Access UNIX System - http://sdfeu.org
irc.perl.org #openmp #pdl #native

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