Support specifying pygments theme using module.Class syntax

[cmarqu]

Sphinx allows setting the pygments style not only via "stylename" but also via a string containing module.Class syntax
(handled in
https://github.com/sphinx-doc/sphinx/blob/35965903177c6ed9a6afb62ccd33243a746a3fc0/sphinx/highlighting.py#L112).

However, pydata-sphinx-theme doesn't support that syntax due to the following check:

pydata-sphinx-theme/src/pydata_sphinx_theme/pygment.py

Line 84 in 8bc48a9

if style_name not in pygments_styles:

(Using my own pygments style does work when I add an entry point as shown in https://github.com/pygments/pygments-plugin-scaffolding/blob/main/pyproject.toml)

Some more detail is in sphinx-doc/sphinx#9105 (comment)

[drammock]

Agreed, seems like we should support the module.Class syntax too. Are you up for opening a PR to implement that?

[cmarqu]

I didn't immediately see how to do it, but I'll try to take another look.

[12rambau]

In our codebase, the pygments is simply used to generate 2 custom stylesheets. They are both createde by this function:

pydata-sphinx-theme/src/pydata_sphinx_theme/pygment.py

Line 24 in fcde006

def get_pygments_stylesheet(light_style: str, dark_style: str) -> str:

In short you create the classic html output and then encapsulate it in the correct "theme" selector.

If you can still perform this trick with a custom molude.Class syntax then the sanity check can be reduced to only "str" entries.