Use sphinx-nefertiti theme

[danirus]

Hello there, I have developed a Sphinx theme called Nefertiti for Sphinx, that I think it is slightly better than the sphinx_rtd_theme. I have updated your docs/conf.py to give it a try with your project. I would very much like if you would decide to use it. I will attach a screenshot of how chatnoir-resiliparse's docs look with it.

I hope you like it.
I have done a bit of customization to add the logo. Also, the :no-index: I add to the docs/api/parse/html.rstis to avoid one of the warnings when build the docs.
Thanks :-)

[phoerious]

Thanks. The theme looks good overall, but I'm not a fan of the grey background. It reduces the text contrast by a lot.

[danirus]

I pushed a change to style.css that changes the background-color when the user prefers the light color-scheme. It overwrites the background color to white. Having the background as white makes a bit more difficult to distinguish the background of code blocks. Maybe it can be overwritten with pygments. I will check.

[danirus]

I have tried a few different values for pygments_light_style, in the setting html_theme_options, in conf.py. Some of them give a bit more contrast between the white background and the color of code blocks. But it is a matter of personal choice. I could suggest you any of gruvbox-light, paraiso-light, solarized-light, or tango. A list of available pygments are here. I haven't tested all of them.

[phoerious]

It's certainly more than just personal preference.

The red does pass the AAA requirements, but due to the colour combination, it almost looks worse than the grey text.

[danirus]

Thanks for considering it anyway.
All the best to you 🙂

[phoerious]

Nonetheless, thanks for suggesting.