ipython-notebook - iPython Notebook 和 Mathjax 标记方程

Question

当我在 iPython 笔记本中以 Markdown 模式编写以下内容时:

\begin{equation}
\begin{split}
\dot u &= \pm u^2 +\delta u^3\\
\dot v &= v\\
\dot w &= -w,
\end{split}\label{eq:nf1}
\end{equation}

Equation \eqref{eq:nf1} bla bla bla ...

它不渲染。问题似乎是

\label{eq:nf1}

因为如果我把它拿出来，它会呈现。

我正在做引用，因为在一天结束时我想将我所做的一切转换为 latex +PDF。在 PDF 输出中，我确实收到了编号和引用良好的方程，这正是我想要的。但是在 iPython Notebook 中也有渲染的方程会很好。

有解决方法吗？也就是说，我可以在 iPython Notebook 中渲染带标签的方程吗？

Answer 1

我找到了一种解决方法，但它并不漂亮。

为了拥有 MathJax 数字方程，您必须添加一个配置标志(来自 MathJax docs)。 IPython 中的配置标志在 IPython/html/static/notebook/js/mathjaxutils.js 中设置(至少从 IPython 1.1 开始)。似乎应该有一个配置选项可以与此 Hook ，但我找不到。相反，我手动编辑了这个:

>>> locate mathjaxutils.js
/home/me/.virtualenvs/nengo/lib/python2.7/site-packages/IPython/html/static/notebook/js/mathjaxutils.js
>>> emacs -nw `locate mathjaxutils.js`

在该文件中，修改 MathJax.Hub.Config调用包括 TeX: { equationNumbers: { autoNumber: "AMS" } }, .它应该看起来像:

// MathJax loaded                                                             
MathJax.Hub.Config({
    TeX: { equationNumbers: { autoNumber: "AMS" } }, # Add this line
    tex2jax: {
        inlineMath: [ ['$','$'], ["\\(","\\)"] ],
        displayMath: [ ['$$','$$'], ["\\[","\\]"] ],
        processEscapes: true,
        processEnvironments: true
    },
    displayAlign: 'left', // Change this to 'center' to center equations.     
    "HTML-CSS": {
        styles: {'.MathJax_Display': {"margin": 0}}
    }
});

清除缓存并重新加载笔记本，您应该拥有正确引用的编号方程。

如果您停在此处，则重新运行带有标记方程的单元格将导致该方程停止渲染，因为该标记已存在。正如评论中所指出的，也有一个解决方法。

在与上述相同的文件中， mathjaxutils.js , 编辑 process_math配置集线器队列的函数: hub.Queue( ["resetEquationNumbers",MathJax.InputJax.TeX], ["Typeset",hub] ); .它应该看起来像:

var process_math = function (i, j, pre_process, math, blocks) {
    var hub = MathJax.Hub;
    hub.Queue( ["resetEquationNumbers",MathJax.InputJax.TeX], ["Typeset",hub] );
    ...

这允许重新渲染带有标记方程的单元格；但是，方程编号将是每个单元格的局部编号，这意味着您不能跨单元格引用方程。