MrDogeBro / sphinx_rtd_dark_mode

Adds a toggleable dark mode to the Read the Docs theme for Sphinx.
sphinx-rtd-dark-mode.vercel.app
MIT License
49 stars 15 forks source link

Add a Lighter Dark Theme #16

Open MrDogeBro opened 3 years ago

MrDogeBro commented 3 years ago

This would add a lighter dark theme as some people think that the current theme is to dark (understandably). This would most likely move the current theme to being a high-contrast theme and add a normal dark theme which is a bit lighter.

eerimoq commented 3 years ago

In case you need docs using this great package, have a look at https://mys-lang.org/. I think a lighter dark theme would be nice!

MrDogeBro commented 3 years ago

@eerimoq thanks! I see you have modified the theme manually to suit your color scheme. When v2 is released tho, you should be able to do this all from the config file and release community themes which should be exciting! Also, would you mind if I possibly use some parts of the color scheme you created in a new official theme?

eerimoq commented 3 years ago

Yeah, I noticed you have done lots of work of the 2.0.0 branch. Will be exciting to use that instead of the copy in my repository.

It's based on the Github color scheme. Feel free to use it.

MrDogeBro commented 3 years ago

Ok sounds good thanks!

eerimoq commented 3 years ago

My latest changes can be found here: https://github.com/mys-lang/mys/tree/main/mys/sphinx_rtd_dark_mode

eerimoq commented 3 years ago

I've made more changes, just to let you know. All found in the link in the previous comment.

zaneselvans commented 2 years ago

Just discovered this extension and installed it. Thanks for the work! I'm amazed there aren't more dark themes out there for Sphinx.

I don't personally mind how dark the dark theme is, but in some cases it seems to have a dark-on-dark color combination that's difficult to read. For example, the environment variable name in this shell code snippet:

image

MrDogeBro commented 2 years ago

Thanks! Im glad you like it! However, that seems like a bug in the dark theme so if you wouldn't mind opening a separate issue for that that would be great! Thanks!

zaneselvans commented 2 years ago

Done! See #27

That slate theme from Material on MkDocs is also great. Looking forward to trying out the new options too.

MrDogeBro commented 2 years ago

Thanks! Glad your looking forward to it!