Theme evaluation

Important features

  • Multiproject: The four projects tentacle, octoprobe, testbed_micropython and testbed_showcase should integrate nicely.

  • Full toctree: In the flask theme, the toctree is not visible in full glory: Just chapter forward/backward. However, the full toctree is easier to navigate.

Themes

Note

Winner of the evaluation: `sphinx_rtd_theme`.

  • It is reasonable to use the same as MicroPython.

  • Multiproject implementation is a bit complex but doable.

sphinx_rtd_theme

  • sphinx-rtd-theme

  • MicroPython

pallets_sphinx_themes

furo

pydata-sphinx-theme

sphinx-multiproject