¿Cómo habilitar las matemáticas en sphinx?

Question

Estoy usando sphinx con la extensión pngmath para documentar mi código que tiene muchas expresiones matemáticas. Hacer eso en un archivo *.rst está funcionando bien.

a \times b se convierte en:

---

---

Sin embargo, si trato de la misma dentro de un archivo *.py por ejemplo en una documentación del módulo, así:

""" 
a \times b 
""" 

I terminar con

---

---

Además ninguna funcionalidad amsmath parece funcionar, ya sea.
¿Qué debo hacer para tener también fórmulas matemáticas en mi documentación *.py?

Answer 1

Trate de poner la letra minúscula 'r' antes de que su cadena de documentación - como esto:

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

nunca he visto una cadena literal prima para una cadena de documentación antes, pero esto mantendrá su \ t sea interpretado como un personaje <TAB>.