Doxygen 自动编号公式

Question

我想在我的 Doxygen 文档中输入几个公式。有什么方法可以创建自动编号每个公式的某种类型的标签？理想情况下，自动编号将在 HTML 生成的输出和 Latex 生成的 Doxygen 输出中起作用。我正在寻找类似于 MS Word 中的 Caption 功能的东西。

例子：

You can see the results of my example in Equation 1.1 below.

{Some Formula}

                                               Equation 1.1

{Some other formula}

                                               Equation 1.2

在上面的例子中，“方程式”后面的数字是自动生成的。然后我就可以在文中引用了。

Doxygen 中的 \anchor 功能可以让我链接到这些位置。但我认为它不会正确生成自动编号。

我想到的选项是修改用于 Doxygen 的 CSS。目前我已经修改它以自动编号我的标题。 Latex 已经自动为标题编号 1-4。我可以将我的 CSS 更改为格式化标题 4，使其看起来像一个右对齐的方程标签。但我不知道如何让 Latex 使用相同的格式。

有什么有用的建议吗？

谢谢。

Answer 1

据我所知，这不能在 Doxygen 中完成。我现在正在考虑使用两个创作系统来做到这一点：

1. Doxygen 记录代码。
2. 打开 Office / Libre Office 以记录用户手册，这是大部分公式所在的位置。

两个创作应用都将写入 HTML 输出。然后我会将输出与 Qt 帮助项目系统结合起来。