将数学嵌入 Doxygen 文档

【问题标题】：Embedding math into Doxygen docs将数学嵌入 Doxygen 文档
【发布时间】：2020-12-05 19:04:33
【问题描述】：

我正在发送一个测试用例，其中第二个 "\f$" 项目被前面的 "\f["

替换

（使用 1.8.13）

（可能是一些临时文件名问题：替换也可以是一些已经消失的片段）

/*!
 * \f[
 * \frac{dV_m}{dt} = \sum_{i=0}^{n} g{sin,i}(t)\frac{E_{sin,i}-V_{m}}{C} + \frac{V_{rest}-V_{m}}{RC}
 * \f]
 * The routine replaces \f$ dt \f$  with \f$ \Delta t \f$
 */

【问题讨论】：

该问题缺少非常重要的信息：问题是什么，使用了哪种输出格式，使用了哪些其他 doxygen 设置。

标签： formula doxygen

【解决方案1】：

Doxygen 1.8.13 是从 2016 年 12 月开始的，当前版本是 1.8.20。

该问题缺少非常重要的信息：问题是什么，使用了哪种输出格式，使用了哪些其他 doxygen 设置。

看到这个很难说是哪里出了问题，但有一些想法。 1.8.13 版可能与较新版本的 LaTeX 有问题（例如给：Error: /undefinedfilename in (_form0.ps)）。

解决方案：

使用 MathJax 来呈现公式（在 HTML 中），通过设置 USE_MATHJAX=YES
升级到更新版本的 doxygen
降级 LaTeX 版本

【讨论】：

正如我所说，我提交了一个简短的测试，它显示了产生错误 HTML 输出的症状。如果你看到一个公式两次，那就错了。你可以在更新的系统上运行它，对我来说没问题。