search

jgm / skylighting

A Haskell syntax highlighting library with tokenizers derived from KDE syntax highlighting descriptions
192 stars 62 forks source link

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

Open jubilatious1 opened 1 year ago

jubilatious1 commented 1 year ago

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!

jgm commented 1 year ago

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.

jubilatious1 commented 1 year ago

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].

finanalyst commented 1 year ago

@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.