Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
jubilatious1 opened this issue Jul 25, 2023 · 3 comments

Comments

@jubilatious1
Copy link

jgm/pandoc#6488 (comment)
jgm/pandoc#6488 (comment)

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:
Raku/problem-solving#375

Thank you!

@jgm
Copy link
Owner

jgm commented Jul 26, 2023

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
Copy link
Author

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
Copy link

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants