Jupyter 笔记本中的公式编号

Question

事实是，在官方文档Jupyter - 激励示例中

等式编号和引用将在 Jupyter Notebook 的未来版本中提供。

我知道有很多关于这个话题的讨论。 有些人声称可以通过一些变通方法解决此问题。

但是对于普通用户来说，很难理解变通方法，或者黑客到底有多么肮脏/有用。

所以我的问题是：

1. “在未来版本中可用”是什么意思？ 它的意思是“新的一个月/一年”还是“可能永远不会，因为太不可能了”？

2. 互联网上提供的任何变通方法是否可供人类安全使用？ 我的意思是值得吗？ 因为可以使用Sphinx或其他东西来创建教程，所以工作量会更多，但是实现一些hacks，安装插件等工作会更多吗？

注意：对于某些人来说，这似乎是一个需要基于意见的答案的问题，但我很确定它不是。 任何建议都可以帮助我（或其他用户）做出好的/坏的决定。

Answer 1

我相信基本上所有与这个问题相关的信息都可以在这个很长的 Github 问题线程中找到。

那里的对话（此时）已经进行了3.5 6.5 年，并且仍然活跃。 重要亮点：

• 您可以通过执行具有以下内容的单元格来非常简单地打开编号：

   %%javascript MathJax.Hub.Config({ TeX: { equationNumbers: { autoNumber: "AMS" } } });

• 方程编号有一个扩展。

• 开发人员 minrk 建议此扩展是正确的方法，可以合并到 master（但默认情况下该功能将关闭）。

要通过pip安装扩展：

pip install jupyter_contrib_nbextensions

通过Anaconda安装 扩展：

conda install -c conda-forge jupyter_contrib_nbextensions 

使用上面提供的安装方法之一后，启用扩展：

jupyter contrib nbextension install --user
jupyter nbextension enable equation-numbering/main

Answer 2

这是一个工作示例，要在降价单元格中输入：

\begin{equation*}
\mathbf{r} \equiv \begin{bmatrix}
y \\
\theta
\end{bmatrix}
\label{eq:vector_ray} \tag{1}
\end{equation*}

Vector **r** is defined by equation $\eqref{eq:vector_ray}$

这是不言自明的，但这里有一些细节：

\\label ：描述方程的名称

\\tag ：出现在方程旁边的标签可以是数字或字母

\\eqref ：参考标记方程

这将显示为：

Answer 3

转到您的 Jupyter Notebook 编辑器（我现在正在使用 Anaconda），编辑菜单，最后一项“nbextensions 配置”。 它会打开一个页面，您可以在其中查看扩展名列表，其中之一是“方程式自动编号”。 启用它并重新启动您的笔记本。 您将看到笔记本顶部出现一个用于重置方程式编号的按钮。 您需要时不时按下该按钮。