sphinx python中的Mathjax表达式无法渲染correclty

Question

我一直试图弄清楚我的docstring中这个表达式有什么问题.我sphinx.ext.mathjax在python sphinx v1.2b中使用扩展名.文档字符串:

.. math::

    w_k^* = \min_{w_k} \ell_k(w_k) + \lambda\left(\alpha||w_k||_1 
    + \frac{1}{2}(1-\alpha) ||w_k||^2\right)

出现的是:

但它继续产生这个奇怪的警告,并没有渲染表达式:

WARNING: Block quote ends without a blank line; unexpected unindent.

奇怪的是,如果我删除\alpha,\left,\right,\frac符号,表达呈现精细无警告.不确定为什么\lambda会得到支持而不是\alpha.

Answer 1

从Sphinx文档:

请记住,当您在autodoc读取的Python文档字符串中放置数学标记时,您必须将所有反斜杠加倍,或使用Python原始字符串(r"raw").

这是必需的,以便\alpha正确解释LaTeX命令(\a以及一些其他序列在字符串文字中具有特殊含义).