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