develooper Front page | perl.perl6.users | Postings from September 2020

Re: pod6 and markdown

Thread Previous | Thread Next
From:
Richard Hainsworth
Date:
September 2, 2020 08:48
Subject:
Re: pod6 and markdown
Message ID:
0b134dcf-6f5e-2bf1-b735-8a2fe697e18b@gmail.com
The raku compiler allows for what you want. It is the Pod render module 
that has to do this work. SO....

I've just re-written Pod::To::HTML. It's in Raku::Pod::Render (Note the 
Raku at the beginning, I also wrote another module with almost the same 
name that doesn't do this).

The legacy Pod::To::HTML (which is Pod::To::HTML:auth<github:Raku> ) 
does all of the HTML rendering hardcoded. Essentially, I took out all 
the output-specific and put it into templates.

So, now you can put something like '=Figure' (or '=MyWonderfulBlock') 
into your pod6 file, and define a template as 'figure' (or 
'mywonderfulblock') with custom output formating, eg. '<img src="mylogo" 
width="100px">') and it will work.

Also, you can create your own Format Codes, so F<fa-business-card> could 
be made to embed font-awesome icons into pod6 files.

Also, the Raku::Pod::Render distribution has a GUI tool called 
Extractor.raku that will take any pm6 file and extract the Pod6 and 
format it into README.md or .html files.

Sorry for shameless ad

On 02/09/2020 03:02, Vadim Belman wrote:
> Unfortunately, neither rendered constraints nor image insertions are implemented yet. Or it is so up to my knowledge, at least. I miss these features too sometimes.
>
> Best regards,
> Vadim Belman
>
>> On Aug 31, 2020, at 6:56 AM, Fernando Santagata <nando.santagata@gmail.com> wrote:
>>
>> Hello *,
>>
>> I was wondering whether there's a way to tell that a section of pod6 should be rendered only by a specific renderer.
>>
>> My problem is that I want to show a figure in a README.md and I'm using App::MI6, which builds the README.md file from the pod6 documentation in the module file.
>>
>> As far as I can tell, there's no specific pod6 formatter for a figure; so far I 've beeninserting raw markdown lines in the pod6 documentation, such as "![description](file.svg)", but it's ugly and it would show when other renderers will be used on the same pod6 file.
>>
>> Is there a way to restrict some text to just one renderer, or to insert a figure or picture in a pod6 file?
>>
>> -- 
>> Fernando Santagata

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