【问题标题】:Sphinx hangs when attempting to use amxmath capabilities尝试使用 amxmath 功能时,Sphinx 挂起
【发布时间】:2018-04-11 07:28:53
【问题描述】:

我想在这样的 ReST 文件的数学块中定义一个矩阵;

.. math::

    \[\begin{bmatrix}a_1 & b_1\\ a_2 & b_2\end{bmatrix}\]

在我的 conf.py 中,我定义了一个序言以包含 LaTeX 包 amsmath

latex_elements = {
# Additional stuff for the LaTeX preamble.
'preamble': r'''
\usepackage{amsmath}
'''
}

但是,当我尝试使用 Sphinx 编译文档时,它会进入文档并永久挂在那里

writing output... [ 97%] theory_and_methodology

我错过了什么?

【问题讨论】:

  • 默认情况下,对于 LaTeX 输出,Sphinx 已经完成了 \usepackage{amsmath,amssymb,amstext} 的不必要的额外序言。对于使用 MathJax 的 HTML 输出,Sphinx LaTeX 配置中的内容完全无关紧要。问题在于\[...\]。它们是默认的,或者使用nowrap 选项。

标签: latex python-sphinx equation restructuredtext


【解决方案1】:

我找到了答案。 LaTeX 编译器不喜欢源代码中的\[。这是不必要的,所以当我删除它时,输出有效。

【讨论】:

    猜你喜欢
    • 2021-10-31
    • 2020-05-05
    • 2015-06-06
    • 1970-01-01
    • 2020-03-13
    • 2020-02-22
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多