【问题标题】:Can the doxygen output generated be made to look like msdn style documentation probably sandcastle generated?生成的 doxygen 输出是否可以看起来像 msdn 样式的文档,可能是沙堡生成的?
【发布时间】:2016-02-17 08:46:46
【问题描述】:
我维护了一个网站,其中包含我们产品的文档。大多数文档都遵循 msdn 风格。其中一个团队使用 doxygen 为其 C++ 项目生成文档。现在我们的大多数产品都使用 msdn 风格,只有这个产品使用 doxygen 反正我可以制作像 msdn 这样的 doxygen 输出风格。
【问题讨论】:
标签:
c++
formatting
doxygen
msdn
【解决方案1】:
也许不是您正在寻找的答案,但据我所知,没有 C++ 工具。正如您已经说过的,对于 C# 应用程序,Sandcastle 会产生您正在寻找的确切输出,但该工具需要 Visual Studio 生成的 XML 文档文件来构建其 MAML 元数据。之后,对该 MAML 进行 XSLT 转换以创建 MSDN 样式的内容。
现在,虽然可以为 C++ 应用程序生成 XML 文档文件(仅限 Visual Studio),但仍然没有可以应用的 C++ 的 XSLT 转换。最好的办法是等到有人创建了一个工具来从任何源代码以及用于 C++ 的 XSLT 创建 XML 数据。或者,如果您有信心,您可以自己做所有这些。
我喜欢 Sandcastle 创建的文档,很遗憾目前不支持 C++。