将 Doxygen 转换为 XML 注释

Question

我们有一个 C# 项目，由于历史原因，该项目在同一代码中同时使用了 Doxygen 和 Visual Studio 样式的注释。 有没有人试图系统地将一种标准转换为另一种标准，最好是常见的 XML 子集？

我想编写一个涵盖最常见功能的脚本不会太难，但我不想重新发明轮子。

Answer 1

这个问题的原始答案也只包括一个链接，所以我也这样做：

首先上面的链接是旧的，这里是链接的更新版本： 链接 ，

除此之外，我还添加了一个全新的AWK脚本变体解决方案： Link

由于原始的python脚本对我不起作用，因为在我的情况下我们有“\\ brief”符号而不是“@brief”，所以我自己写了。 （我还不会说python）

一个重要的关键功能是您可以轻松添加标签翻译，或跳过其中一些：

translate["\\fn"]     = "skip";
translate["\\def"]    = "skip";
translate["\\class"]  = "skip";
translate["\\enum"]   = "skip";
translate["\\struct"] = "skip";
translate["\\author"] = "skip";
translate["\\brief"]  = "summary";
translate["\\param"]  = "param";
translate["\\return"] = "returns";

后来我也找到了原版python脚本的新版本，所以我希望没有人必须从头开始！

如果我之前找到了“只是链接”到新脚本，它可以保护我免受一些麻烦。

Answer 2

我知道你提问已经有一段时间，但我遇到了同样的问题。 这是我的10分钟开源项目，应该使转换变得不那么轻松。 :-)欢迎扩展！

https://code.google.com/p/doxygentoxmlconverter/

Answer 3

我有同样的问题，在 2022 年找到了这些答案，也许它可以帮助某人：

• Atomineer Pro可以在现有格式和您配置的格式之间进行转换
• Doxygen 到 XML 转换器自描述为快速和肮脏的 Python 工具