.Net XML注释到API文档中

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

此外,我最近尝试设置沙堡,但它真的让我的眼睛交叉。要么我在这个过程中失去了一些重要的东西,要么就是太牵扯其中。

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

我在这里重申,因为我认为我的格式使该段不适合阅读:

我给了沙堡一个尝试,但很难让它成立。   我真正想到的是简单得多的东西。

也就是说,除非我不了解沙堡进程。对我来说,这似乎是一个额外的负担,只是为了让测试人员能够合作而生产出一些好东西。

0
额外 编辑
意见: 1

6 答案

按照这个简单的5步骤文章,你已经完成了很多工作。作为奖励,您可以使用 H2Viewer 查看Html Help 2.x文件。

0
额外

看一看 Sandcastle ,其确实如此。它也是更简单的解决方案之一,它或多或少是选择的工具,所以从长远来看,如果您指定在安装过程中遇到的问题,也许我们可以帮助您设置Sandcastle。

0
额外

我刚刚建立了沙堡。尝试安装它(2008年5月发行)并搜索SandcastleGui.exe或类似的东西(它在示例文件夹左右)。

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

这将需要一些时间,但结果值得努力。它实际上会查找MSDN中的东西,因此您的结果文档也会将类继承一直引导到System.Object,并指向MSDN和其他东西。

沙堡似乎有点复杂在第一,尤其是当你想在一个自动构建使用它,但我绝对相信这将是值得的。

另请参阅 Sandcastle帮助文件生成器,这是一个更高级的GUI。

0
额外

你正在寻找沙堡

Project Page: Sandcastle Releases

Blog: Sandcastle Blog

NDoc Code Documentation Generator for .NET used to be the tool of choice, but support has all but stopped.

0
额外
额外 作者 Muxa,

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

欢迎使用Sandcastle Help File Builder Project

0
额外

I use NDoc3

0
额外