Skip to content

Switch to PyData Sphinx theme and add a landing page

Jérémy Bobbio (Lunar) requested to merge look-and-feel-improvements into master

After merging various parts of Software Heritage documentation in a single Sphinx instance, the navigation using the Read The Docs theme became seriously cumbersome.

After reviewing several Sphinx theme, we switch to PyData Sphinx theme: a clean, Bootstrap-based Sphinx theme by and for the PyData community. For details, please refer to: https://pydata-sphinx-theme.readthedocs.io/

We also implement the landing page that was designed during the documentation sprint in November 2022.

There is probably further work to be done on the copy, maybe tweak colors and margins on the cards. Proper support for dark mode would be nice as well. It’s a bit ugly for now.

Merge request reports