visual studio -.Net XML注释到API文档中

Translate

是否有一种简单的方法可以从Visual Studio XML输出生成MSDN样式的文档?
我没有足够的耐心为其设置一个好的xslt,因为我知道我不是第一个过桥的人。

另外,我最近尝试设置沙堡,但确实让我眼前一亮。我可能在此过程中遗漏了一些重要的东西,或者只是过于复杂。

我知道那里有人有一个非常不错的简单解决方案。

我在这里重申是因为我的格式使该段不宜阅读:

我尝试了一下沙堡,但很难进行设置。我真正想到的是简单得多的东西。

也就是说,除非我只是不了解沙堡过程。在我看来,这似乎给我带来了很多额外的负担,只是为测试人员提供了一些不错的选择。

This question and all comments follow the "Attribution Required."

所有的回答

Translate

您在寻找沙堡

项目页面:沙堡发布

博客:沙堡博客

.NET的NDoc代码文档生成器曾经是选择的工具,但是支持几乎停止了。

来源
Translate

看一下沙堡,它正是这样做的。它也是目前使用的更简单的解决方案之一,或多或少是您选择的工具,因此,从长远来看,如果您指定设置过程中遇到的问题,也许我们可以帮助您设置Sandcastle?

来源
Translate

您还应该使用Sandcastle帮助文件生成器。它为您提供了一个类似于GUI的ndoc,用于生成帮助文件,因此您无需从命令提示符下执行任何操作。

欢迎使用Sandcastle帮助文件生成器项目

来源
Translate

跟随这篇简单的5步文章这样您就完成了。作为奖励,您可以使用H2查看器查看HTML帮助2.x文件。

来源
Translate

我刚刚再次设置了沙堡。尝试安装它(2008年5月发行版)并搜索SandcastleGui.exe或类似的文件(在examples文件夹中)。

单击添加程序集并添加一个或多个程序集,添加任何.xml文档文件(如果启用了该选项,则由编译器生成的文件),然后生成。

需要一些时间,但是结果值得付出努力。它实际上会从MSDN中查找内容,因此您生成的文档还将具有从类继承到System.Object的类继承,以及指向MSDN和内容的链接。

一开始,Sandcastle似乎有点复杂,尤其是当您想在自动构建中使用它时,但我绝对相信这是值得的。

也看看沙堡帮助文件生成器,这是一个稍微高级的GUI。

来源
Translate

我用NDoc3

来源