c++ - C++ XML 注释生成 MSDN 风格的 CHM

Question

我有几个项目，有些使用托管代码，有些只使用非托管代码。所有都添加了 XML 注释，并且正确生成了 XML 文档（生成的 xml 文件和中间的 xdc 文件）。

肯定有一些东西可以获取这些文件（xdcmake 的输出）并生成 MSDN 风格的 chm 帮助！? 据我了解，doxygen 和 sandcastle 都忽略了这个明显的步骤，并重新发明轮子来重新扫描您的代码。（还有一个事实是，sandcastle 对于非 .NET 项目显然没用）。

尝试过 doxygen（可怕的输出，但很快）和 sandcastle（漂亮的 MSDN 风格的输出，但很慢）都在乞求被更简单的东西超越。

如果有某种相关的编辑器，我们也可以编写任何 API 文档也需要的“入门”和“信息”类型的页面，那也很好。

有谁知道任何解决方案？

Answer 1

老实说，Sandcastle 是您最好的选择。我知道配置起来有点麻烦，但文档正是您正在寻找的风格。

Answer 2

我知道人们仍在使用NDocConsole的项目

但是我认为 NDoc 是一个死项目，因为在http://ndoc.sourceforge.net/自 2005 年以来没有更新

Answer 3

您可能想尝试DoxyComment。以下是 Doxygen 的Helper tools & scripts的描述：

一个名为 DoxyComment 的 Visual Studio 2005 插件由 Troels Gram 创建。它旨在帮助您将上下文相关的注释块插入 C/C++ 源文件。DoxyComment 还附带一个 xslt 模板，可让您生成像 MSDN 库这样的文档。