code-block:: diff is not highlighted with this theme

[K20shores]

There appears to be an incompatibility between this theme and the code highlighting for code-block:: diffs.

conda create --name example
conda activate example
conda install pip 
conda install sphinx --channel conda-forge
mkdir test
cd test
sphinx-quickstart

In index.rst add this:

.. code-block:: diff

    #include <a.h>
  + #include <b.h>
  - #include <asdf.h>
    #include <c.h>

Make the docs: make html and view them.

The default alabaster theme renders this with color:

Now, install this theme

conda install pydata-sphinx-theme --channel conda-forge

and setup the conf.py to use this theme and remake the docs.

make html

Looking at the output, the diff is not appropriately color coded.

[12rambau]

To render code highighting, sphinx uses Pygment. I wasn't aware of this one but you are very right the diff lexer do exist and should be supported.

There are 2 options here:
1/ the color style used in the theme is not supporting the diff lexer
2/ some css override of the them are preventing the lexer to work

I am swamped with other issues so could you simply try on your example to change the pygment style in the option ?

html_theme_options = {
   #...
   "pygment_light_style": "tango",
   "pygment_dark_style": "monokai"
}

and let me know if it works ?

[K20shores]

@12rambau that works for me!

[K20shores]

For what it's worth I know that this used to work with an older version of this theme. Unfortunately I don't know which. Sometime last year I started using this theme and had that installed in a conda environment. Last week when I upgraded I noticed this issue. So, something in the past year in either sphinx or this caused the highlighting to disappear. I know that's vague but it's the best I can offer.

[12rambau]

we recently added lots of things in the theme related to accessibility including specific a11y compatible pygment styles. I'll open an issue on there end and tag you there.

[drammock]

I opened Quansight-Labs/accessible-pygments#31 about this.

[drammock]

closing since it's ultimately an upstream feature request, nothing we can do in this repo to fix it.