diumenge, 9 de març de 2014

Instal·lació de temes a Sphynx

Tot i que sphynx porta uns quants temes per defecte, tenim la possibilitat d'utilitzar-ne de nous bé creats per alguna institució bé per algun programador individual.

Podem trobar-los fent una cerca a l'índex de paquets de Python: PyPI - the Python Package Index. Això ens donarà una llarga llista no solament de temes sinó de connectors que es poden afegir a  sphynx.

Un de força interessant és el tema que utilitzen els documents allotjats al lloc Read the docs (basats en sphinx) ique es troba en el paquet sphinx_rtd_theme. És molt fàcil d'instal·lar si es té prèviament instal·lada l'eina d'instal·lació de paquets de Python pip, només cal escriure en un terminal l'ordre:

pip install sphinx_rtd_theme

Un cop instal·lat a l'equip per poder-lo fer servir amb els nostres documents només cal que afegim al nostre fitxer conf.py les següents línies:

    import sphinx_rtd_theme

    html_theme = "sphinx_rtd_theme"

    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
Publica un comentari a l'entrada