skylighting icon indicating copy to clipboard operation
skylighting copied to clipboard

Please provide syntax for POD6 (a.k.a. RakuDoc), the markup language for Raku (formerly Perl6)

Open jubilatious1 opened this issue 1 year ago • 3 comments

https://github.com/jgm/pandoc/issues/6488#issue-647199358 https://github.com/jgm/pandoc/issues/6488#issuecomment-1648217051

The Perl6 project was initiated in year 2000, the Rakudo compiler was released in 2015, and the language was renamed Raku in 2019.

Raku features built-in: 1. Unicode support, 2. Object Orientation, 3. "Rational" maths, and 4. a more-powerful-yet-simplified Regex Grammar. We've made it into the latest StackOverflow Developer's Survey (2023)!!

Probably the greatest need at the moment is getting POD6 (a.k.a. RakuDoc), the Raku markup language, to work with skylighting/Pandoc. Note, Raku's POD6 is not the same as Perl's POD, see below:

Original specification: https://design.raku.org/S26.html

Current specification: https://docs.raku.org/language/pod

Working group: https://github.com/Raku/problem-solving/issues/375

Thank you!

jubilatious1 avatar Jul 25 '23 18:07 jubilatious1

The only way anything can make it into this library is if there's a KDE xml syntax specification for it. (See the README.) I don't see one for pod or pod6. However, there is one for raku, and it's already included in skylighting and pandoc. If you look at the raku syntax definition, you'll see that it includes support for inline POD.

jgm avatar Jul 26 '23 05:07 jgm

Great! Thank you!

I'm still learning the Raku ecosystem so I'll check with the Documentation Team to see if the Raku syntax definition you already have works for POD6/RakuDoc. [I'll perform a few tests myself, as well].

jubilatious1 avatar Jul 26 '23 14:07 jubilatious1

@jgm @jubilatious1 was a little early (or late) in requesting this. RakuDoc is a revision of POD6, and the revision is currently at the BETA stage, a process I am involved in. The next stage will be a GAMMA revision when the Raku community can contribute. That stage will last until November this year. POD6 has been around for over a decade.

Most syntax highlighters for Raku treat RakuDoc as comments, but it would be better for to have a different highlighting for both.

finanalyst avatar Jul 26 '23 19:07 finanalyst