Dark text on dark background in code snippets is difficult to read

[zaneselvans]

In some contexts the theme uses a dark-on-dark color combination that's difficult to read. For example, the environment variable name in this shell code snippet:

[zaneselvans]

Here's a different example of dark-on-dark being unreadable. This is in API documentation built with the sphinx-autoapi extension. Docs from our PUDL repo again.

[jpy-git]

I'm also seeing a couple of situations where text is too dark to see:

1. autodoc light: dark: class name is black on black background so can't read.

2. code-block:: jinja light: dark: template variable has dark blue text on black background.

3. code-block:: python light: dark: function name is dark blue text on black background.

These examples are from SQLFluff and you can reproduce these examples from here if needed.

The autodoc one is the main barrier preventing me using this, but the other 95% looks great 😄

[mrelbe1]

Another example.

.. code-block:: console

   $ myapp --version
   myapp 0.5.1

Light:

Dark:

The demonstrated response is too dark.

[photoniker]

Is there somebody working on that issue? I have the same one.