Temes

Sphinx admet múltiples temes de manera que es pot canviar fàcilment l’aparença de la documentació sense canviar-ne el contingut. Un canvi d’una sola línia pot modificar completament l’aparença de la documentació sense requerir cap canvi en el procés de renderització ni en la infraestructura.

Un exemple. Canviant una sola línia, la que defineix la variable html_theme al fitxer conf.py la pàgina web construida amb sphinx-build canvia completament.

Fig. 3 Captura de pantalla d’aquesta guia utilitzant el tema pydata-sphinx-theme

Fig. 4 Captura de pantalla d’aquesta guia utilitzant el tema sphinx-book-theme

Fig. 3 és una captura de pantalla de la pàgina web que esteu veient, aquesta defineix html_theme = "pydata_sphinx_theme". Fig. 4 és una captura de pantalla de la pàgina web generada per Sphinx amb el mateix contingut quan definim html_theme = "sphinx_book_theme".

Tant ArviZ com PyMC utilitzen el tema pydata sphinx theme que es altament personalitzable fins i tot utilitzant unicament variables del fitxer conf.py.