我可以在生成的 XML 中跟踪别名（或创建自定义实体）吗？

Question

我已经使用 Doxygen 记录了 C++ 文件。本文档的某些行对我来说具有特殊意义。这些行需要由外部工具处理以执行一些检查。为此，我创建了 doxygen 别名。然后此工具解析 C++ 文件以提取这些行。

现在，我需要改进此工具以进行更多检查（不仅在标记的行上）。因此，我将不再使用 C++ 文件，而是直接处理 Doxygen 生成的 XML 文件。不幸的是，生成的 XML 文件（至少具有基本配置）没有跟踪我的别名。例如，别名 \nout = \test 被转换为：

<xrefsect id="test_1_test000001"><xreftitle>Test</xreftitle><xrefdescription>[...]

所以，我需要的是，仍然能够识别特定行是获得如下结果：

<xrefsect id="..." alias="nout">[...]

或获得类似的东西

<nout><xrefsect id="...">[...]</nout>

有人知道如何配置 Doxygen 以获得这两种解决方案之一（我使用的是 1.7.1 版）吗？

谢谢。

Answer 1

我找到了一种在 XML 中跟踪我的别名的方法。为此，我将需要跟踪的别名编写为：

aliasName=<span style="visibility:hidden">!aliasName!</span>

通过这种方式，在我生成的 XML 中，某处有文本 !aliasName!我可以很容易地检测到。而且，由于该文本对于 HTML 是不可见的，因此它不会出现在 HTML 输出中。它可能会以其他输出格式出现，但我不需要它们...

注意：我最初试图写得非常干净。但在 XML 中的所有情况下，span（或 div）标记都被完全删除。