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

Re: Pre-RFC: markdown in pod

Thread Previous | Thread Next
From:
Ricardo Signes
Date:
November 30, 2021 02:06
Subject:
Re: Pre-RFC: markdown in pod
Message ID:
942117e6-64d4-4107-8045-aeebe1abd9e3@beta.fastmail.com
On Mon, Nov 29, 2021, at 12:49 PM, Oodler 577 wrote:
> * Ricardo Signes <perl.p5p@rjbs.manxome.org> [2021-11-27 14:30:13 -0500]:
>> But I will say that I think that by far the most tedious thing in Pod is lists, for which I provided myself with a solution in Pod::Elemental::Transformer::List <https://metacpan.org/pod/Pod::Elemental::Transformer::List>, which creates a "=begin :list" region or "=for :list" paragraph, which allows very compact notation for bulleted, definition, or ordered lists that uses Pod sequences instead of Markdown, and so remains very much like all other Pod.  Adding support to that to Pod::Simple might be a fair bit simpler than Markdown... but I won't be the one to do it!  ?????
> 
> What's your workflow for rendering this to POD, is it transformed in the source after you've written once (e.g., via an external tool or vim plugin), or does it remain in the source for downstream consumption?

I use Dist::Zilla, which rewrites the quirky Pod from my git repository's source into standard Pod before building tarballs for the CPAN.

-- 
rjbs
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