Sphinx LaTeX标记限制

Sphinx LaTeX标记限制

您必须编辑

sphinx-quickstart

创建的标准配置文件，否则，狮身人面像将对数学块产生干扰。在文件中

conf.py

，我更改了

extensions = []

至

extensions = ['sphinx.ext.pngmath']

之后，以下第一个文件或多或少起作用了；

.. foo documentation master file, created by   sphinx-quickstart on Thu Oct 25 11:04:31 2012.   You can adapt this file completely to your liking, but it should at least   contain the root `toctree` directive.Welcome to foo's documentation!===============================Contents:.. toctree::   :maxdepth: 2This is the first chapter=========================Instead, I am doing multi-line stuff, often like eqnarray in LaTeX:.. math::    DividendYield &=& frac{DVT(t)}{CurrentMarketCap} \    Avg_Assets &=& biggl( A/B biggr) textrm { when B is not zero...}

它为数学片段生成了以下LaTeX代码：

chapter{This is the first chapter}label{index:welcome-to-foo-s-documentation}label{index:this-is-the-first-chapter}Instead, I am doing multi-line stuff, often like eqnarray in LaTeX:begin{gather}begin{split}DividendYield &=& frac{DVT(t)}{CurrentMarketCap} \Avg_Assets &=& biggl( A/B biggr) textrm { when B is not zero...}end{split}notag\begin{split}end{split}notagend{gather}

对我来说，使用拆分和聚集的组合选择似乎有点奇怪，并且显然不能与您为eqnarray编写的代码一起很好地工作，但这在Sphinx中是硬编码的。

运行pdflatex确实在处停止了

end{gather}

，并出现了错误，

Extra alignment tab has been changedto cr.

但是我可以通过输入nonstopmode来继续进行 *** 作。这给我以下结果：

尽管对齐仍然存在问题（由于

split

和

eqnarray

环境之间的差异），但textrm和biggl似乎可以正常工作。（请注意，您仍然必须转义下划线

Average_Assets

，但这对于AFAICT当然是正确的）。

您 可能
无需对生成的LaTeX代码进行后处理，例如通过替换

begin{gather}begin{split}

和

end{split}notag\begin{split}end{split}notagend{gather}

选择自己的数学环境。

更新 ：

更新的屏幕截图似乎来自网页，而不是LaTeX文档！因此在我看来，产生错误的是处理程序，该处理程序将LaTeX数学符号转换为浏览器可以显示的内容。那可能是

MathJax

或

jsMath

。通过查看代码，

pngmath

会产生其他错误消息。根据此页面，您的代码段
应
在mathjax中运行。从jsMath符号页面看，它看起来不像jsmath支持

Biggl

。因此，我最好的猜测是SPhinx配置为使用jsMath。窥视所生成网页的源应该告诉您用于渲染数学的内容。如果我的猜测是正确的，则将配置切换为使用mathjax并稍微调整您的方程式可能会解决此问题。

Update2 ：我可以肯定地确认它可以与MathJax一起正常工作（请参见下文）。我没有安装jsMath。