doxygen 中的自动编号方程

【问题标题】：Autonumbering equations in doxygendoxygen 中的自动编号方程
【发布时间】：2021-07-25 19:26:53
【问题描述】：

是否可以在 doxygen 降价文档中为自动编号方程编号？

例子：

page1.md：

This is Equation 1:

\f[
\label{Eq:1}
\bbox[Pearl, 10px,border:1px solid black]
{
    \rho = \frac{m}{V}
}
\f]

如果我输入\tag{#numberOfTheEquation}，我会得到号码。

但是你是否建立了文档，如果在文档中间插入一个新方程，则更改每个方程编号是非常不方便的。

最好的问候！

【问题讨论】：

标签： doxygen

【解决方案1】：

当我们有这样的文件时：

/** \file

# Math references

\f{equation}{
\alpha = \beta * \gamma
  \label{eq:my_system}
\f}

The reference: \f$\eqref{eq:my_system}\f$

*/

我们可以使用Doxyfile，例如：

USE_MATHJAX = YES
EXTRA_PACKAGES = amsmath amssymb
MATHJAX_EXTENSIONS     = amssymb amsmath
MATHJAX_CODEFILE       = mycode.js

mycode.js:

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

这将导致：

【讨论】：

根据您的问题，我还查看了未使用 MathJax 的输出，此处参考为 ?? 而不是 1。为此，我刚刚将提议的补丁推送到 github（拉取请求 8691，github.com/doxygen/doxygen/pull/8691）。