search

finanalyst / raku-pod-render

Renders Raku POD to HTML, or MarkDown. GUI to take POD from a Module and create a README.md from it. Other output formats possible by changing templates
Artistic License 2.0
8 stars 6 forks source link

some links on readme page do not work #26

Open MARTIMM opened 4 months ago

MARTIMM commented 4 months ago

Part at the bottom of README;

See RenderPod for the generic module and Pod2HTML for information about the HTML specific module Pod::To::HTML2. Pod::To::Markdown2, see MarkDown2, follows Pod::To::HTML2 mostly.

Links to RenderPod, Pod2HTML, and MarkDown2 return 404 errors pages.

finanalyst commented 4 months ago

@MARTIMM I'm not sure how to correct these. Is this related to raku.land tooling?

The first link you gave is [RenderPod](https://raku.land/zef:finanalyst/RenderPod.md)

Note the domain is raku.land

and the non-working link is [Pod2HTML](https://raku.land/zef:finanalyst/Pod2HTML.md)

However, if you go to code tab in this same repo, you will find RenderPod.md link for convenience. The same link to Pod2HTML that you cited above is in the file, but it opens correctly to a local file.

By the way, I am in the very last stages of completing a RakuAST Markdown renderer, with HTML following soon.

The renderers here only cope with a partial implementation of RakuDoc v1 (aka POD6), whilst my new Renderer handles all of RakuDoc v2 (with a couple of minor exceptions).

The new renderers (eg RakuDoc::To::Markdown) are simpler to use.

finanalyst commented 4 months ago

@MARTIMM Just finished the RakuDoc::To::Markdown renderer today.
https://github.com/finanalyst/rakuast-rakudoc-render.git
Sample rendering can be seen in resources/compliance-rendering

MARTIMM commented 4 months ago

Thank you for the comments and your RakuDoc application.

I can see the page on https://raku.land/zef:finanalyst but in that list, the mentioned RenderPod.md, Pod2HTML.md, and MarkDown2.md is not shown, and because of that a 404 error page is shown.

finanalyst commented 4 months ago

@MARTIMM I've written to raku.land about the issue.