You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
There was an attempt to implement that, but in the end it was rejected because perfect POD6 parsers need to execute the file in order to render it correctly. So it seems that we need a solution that doesn't run any code, and instead attempts to render POD6 according to some basic (existing) rules.
I wonder if we can use https://github.com/perl6/atom-language-perl6/ (or any other basic perl6 parser) to output some pages. It doesn't have to be absolutely correct, just rendering some headings and paragraphs will do.
See also Raku/Pod-To-HTML#55 (comment) (and the comment immediately preceding it which documents the original discussion of this issue in 2009). In my comment I propose a solution that I think is simple and requires no action on GH's part. It may be a non-starter for reasons I don't see -- it is a strawman proposal -- but if so, please say why.
Currently GitHub renders
.pod6
files as text. It would be great if they were parsed and rendered properly as POD6 files (with proper HTML output).Example: https://github.com/perl6/doc/blob/master/doc/Type/IO/Socket/INET.pod6
There was an attempt to implement that, but in the end it was rejected because perfect POD6 parsers need to execute the file in order to render it correctly. So it seems that we need a solution that doesn't run any code, and instead attempts to render POD6 according to some basic (existing) rules.
See previous ticket: Raku/doc#167
The text was updated successfully, but these errors were encountered: