Come abilitare la matematica nella sfinge?

Question

Sto usando sphinx con l'estensione pngmath per documentare il mio codice che ha molte espressioni matematiche. Farlo in un file *.rst funziona perfettamente.

a \times b diventa:

---

---

Tuttavia, se provo la stessa all'interno di un file *.py per esempio in una documentazione del modulo in questo modo:

""" 
a \times b 
""" 

I finire con

---

---

Inoltre alcuna funzionalità amsmath sembra funzionare, neanche.
Cosa devo fare per avere anche le formule matematiche nelle mie documentazioni *.py?

Answer 1

Prova a mettere un minuscolo 'r' prima della docstring - in questo modo:

def multiply(a,b): 
    r""" 
    returns a \times b 
    """ 
    return a*b 

Non ho mai visto una stringa letterale prima per un docstring prima, ma questo non mancherà di tenere il vostro \ t da essere interpretato come carattere <TAB>.