使用 Doxygen 自定义 XML 标签答案

【问题标题】：Custom XML Tags with Doxygen使用 Doxygen 自定义 XML 标签
【发布时间】：2012-08-10 12:47:55
【问题描述】：

如果我使用 XML (c#) 样式进行记录，这似乎不起作用。我尝试添加一个“更改”标签：

ALIASES = "change=\xrefitem change \"Change\" \"Changes\""

但是，当我在文档中使用它时：

<change>Bojan Hrnkas, 14.08.2012: Optimized performance.</change>

HTML 输出如下所示：

<change>Bojan Hrnkas, 14.08.2012: Optimized performance.</change>

有没有办法实现xml标签的别名？

【问题讨论】：

【解决方案1】：

实现此目的的一种方法是使用 INPUT_FILTER 配置文件选项将自定义 XML 命令替换为别名。例如，定义

ALIASES = "change=\xrefitem change \"Change\" \"Changes\""

我们可以使用INPUT_FILTER 来查找和替换

<change>Text</change>

与

\change Text

从this SO question 可以使用 sed 来执行这种转换，使用类似于

sed 's/<change>\(.*\)<\/change>/\1/'

【讨论】：

我假设“sed”是 linux“流编辑器”。这听起来像是一个可能的解决方案。但是，我的开发环境是 Windows 上的 Visual Studio，所以“sed”不是一个选项。 Visual Studio 是我坚持使用 xml 样式 cmets 的原因。还是谢谢！
那么您应该将 Windows 标签添加到您的问题中。无论如何，sed is avaiable for Windows。或者，您可以use Powershell to achieve the same result。
@BojanHrnkas 从 GNUWin32、MinGW 或 Cygwin 安装 sed。

【解决方案2】：

我可以确认在使用 XML 样式文档时不支持自定义标签。我的解决方案是混合两种样式，所以现在我有了

和 @change{}。不是很好，但很有效。

【讨论】：