Jupyter 笔记本中的方程式编号

Question

事实上，在官方文档中， Jupyter - motivating examples stands

未来版本的 Jupyter notebook 将提供方程式编号和引用。

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

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

所以我的问题是：

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

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

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

原文由 matousc 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 1

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

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

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

   %%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

原文由 David Ketcheson 发布，翻译遵循 CC BY-SA 4.0 许可协议

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 ：参考标记的等式

这将显示为：

原文由 calocedrus 发布，翻译遵循 CC BY-SA 4.0 许可协议