A new highlighting package

[javiereguiluz]

We've discussed in the past about using a PHP-based highlighting package, ideally one that uses TextMate grammar files, to replace our current solution.

Via the January 2025 edition of the excellent "PHP Annotated" newsletter published by @pronskiy I found this project that does exactly that:

https://github.com/phikiphp/phiki

A drawback of this library is that, for now, it inlines styles instead of using CSS classes.

[wouterj]

Sounds great! Someone beat me to writing a shiki port 😉

A drawback of this library is that, for now, it inlines styles instead of using CSS classes.

This appears to be the modern thing. All modern syntax highlighters do this as far as I've seen.

[javiereguiluz]

For us it would be a drawback because we usually do minor tweaks in the styles of the code samples. If we use CSS classes, all docs are instantly updated. With inlined styles, we'd need to rebuild all the docs, including the legacy and unsupported docs, and that's very cumbersome to us.

[pronskiy]

/cc @ryangjchandler

[stof]

Opening an issue on their repo to request (or at least discuss) an option to generate classes is probably better than pinging them in our issue tracker though.

[ryangjchandler]

Hi @javiereguiluz and friends. Feel free to open up an issue on the Phiki repo with any suggestions, I'm open to adding opt-in support for classes on code blocks, would just need to know what your expectations are for such as feature.

@wouterj I wouldn't wish the pain of digging into TextMate stuff on anyone, so you're welcome 😉