Estoy tratando de hacer tres cosas realmente básicas dentro de un modo matemático multilínea en Sphinx (versión 1.1.2-1).

Escriba guiones bajos como parte de mis nombres de variables incluso en modo matemático;Utilizar el\big, \biggl, etc., delimitadores para hacer paréntesis y paréntesis grandes;e incluir texto regular como parte de las ecuaciones.

Tenga en cuenta las siguientes dos cosas. (1) Estoy usando una cadena en bruto en mi código de Python para la documentación de marcado de Sphinx, por lo que no se necesitan barras invertidas adicionales para los caracteres de escape, y (2) no estoy haciendo el modo matemático en línea, que se delimita así en Sphinx:

:math:`Some math stuff goes here` regular text could go here...

En su lugar, estoy haciendo cosas de varias líneas, a menudo comoeqnarray en LaTeX:

.. math::
    DividendYield &=& \frac{DVT(t)}{CurrentMarketCap} \\
    Avg_Assets &=& \biggl( A/B \biggr) \textrm { when B is not zero...}

En la actualidad, recibo errores de Sphinx (y las páginas de documentos generados parecen incoherentes) que dicen cosas como:

Unknown LaTeX command: textrm

Lo mismo sucede para\biggl. Para el guión bajo, siempre se interpreta como si estuviera denotando un subíndice, pero si uso\textunderscore u otros trucos luego arroja el mismo tipo de errores que el anterior.

Subraya dentro del modo matemático, eltextrm comando, y los grandes delimitadores son partes extremadamente básicas de cada paquete TeX nativo que he usado. Entonces, ¿por qué son inaccesibles a través de Sphinx?

Actualizar

Un archivo de Python en particular en el que estoy trabajando calcula los datos de Book Equity para mí. Tan abajo, cuando ves las cosas sobre BookEquity, esa es la referencia. No puedo ejecutar nuestro proceso de compilación de documentos excepto a través de un sistema de control de versiones, por lo que cometer un error reproducible fue más fácil si solo modifiqué un archivo existente.

Sin embargo, todo lo que hice fue agregar la siguiente función de clase en mi código, con una simple cadena de documentación.

def foo(self):
    r"""
    Sample docstring

    .. math::
        Ax &=& b \\
        Cx &=& \biggl(\frac{x/y}\biggr) \textrm{ if y is not zero.}
    """
    pass

Y luego la imagen de abajo es el resultado de la compilación de documentos con Sphinx 1.1.2-1.

Si haces clic derecho y seleccionas 'ver imagen' puedes ver una versión mejor.