如何在Sphinx Docs中显示Matrix？

Question

我有一个说3 x 3的矩阵，我想在Python文档的Generated sphinx文档中显示它。

def Matrix_func():
    """
            [1  4  7 ]
    M   =   [2  5  8 ] 
            [3  6  9 ]
    """

目前，上面的矩阵并没有像在生成的狮身人面像文档中那样打印。

Answer 1

或使用MathJax扩展

在您的狮身人面像config.py添加mathjax扩展名

extensions = [
    # ... other extensions
    'sphinx.ext.mathjax',
]

然后，一个漂亮的数组将呈现为：

def Matrix_func():
    r"""
    .. math::

        M = \begin{bmatrix}
                1 & 4 & 7 \\
                2 & 5 & 8 \\
                3 & 6 & 9
            \end{bmatrix}
    """

这个答案晚了2.25年，但我希望它对某人有帮助;）

Answer 2

您可以在函数docstring中包含矩阵：

def Matrix_func():
    """
    ::

             [1  4  7 ]
       M  =  [2  5  8 ] 
             [3  6  9 ]

    More text...

    """

注意双冒号（ :: ，表示文字块 。