Configuració de la generació de documentació#

En ser una llibreria de Python, la construcció de la documentació es defineix i configura a través del fitxer conf.py. Aquest fitxer ens permet configurar el procés de construcció de documentació de Sphinx assignant valors a variables predefinides.

Permet, per exemple, afegir extensions a la construcció o personalitzar el tema, els dos conceptes detallats a les pàgines properes.

Com a col·laborador d’ArviZ o PyMC, el més probable és que no us hagueu de preocupar d’aquest conf.py. Ja està escrit i configura la construcció per adaptar-se a les nostres necessitats fins ara. No obstant això, si esteu treballant en la disposició del tema o voleu configurar algunes extensions, haureu d’editar aquest fitxer.

Recursos