Jupyter笔记本中的公式编号

Question

事实上，在官方文件中

Equation numbering and referencing will be available in a future version of the Jupyter notebook.

我知道关于这个话题有很多讨论。有些人声称要用一些解决办法来解决这个问题。

但对于普通用户来说，很难理解解决方法，也很难理解黑客到底有多脏/有多有用。

所以我的问题是：

1. 什么意思是“未来版本可用”？这是不是意味着“新的一年/月”或者“可能永远不会因为太不可能”之类的东西？

2. 互联网上提供的任何解决方案是否对人类的消费是安全的？我是说它值得吗？因为可以使用Sphinx或其他东西来创建教程，这将是更多的工作，但是实现一些hack、安装插件等等将是更多的工作？

注：对于某些人来说，这可能是一个需要基于观点的答案的问题，但我很确定不是。任何建议都可以帮助我（或其他用户）做出正确/错误的决定。

Answer 1

下面是一个在标记单元格中输入的工作示例：

\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 2

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

这场对话已经进行了3.5年（目前），而且仍然很活跃。重要亮点：

• 通过执行包含以下内容的单元格，可以非常简单地打开编号：

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

• 方程编号有一个extension。

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

要通过pip安装扩展：

pip install jupyter_contrib_nbextensions

要通过Anaconda安装the extensions：

conda install -c conda-forge jupyter_contrib_nbextensions 

使用上述安装方法中的一种后，启用扩展：

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

Answer 3

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